[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6H9FTQKHP035P3Q62NMX0RN":3,"skill-same:01M6H9FTQKHP035P3Q62NMX0RN":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":53,"commitSha":54,"skillDirectory":55,"forksCount":56,"repositoryHtmlUrl":57,"repositoryHomepageUrl":6,"ownerHtmlUrl":58,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":59,"install":60,"resources":73},"01M6H9FTQKHP035P3Q62NMX0RN","windsurf-known-pitfalls",null,"Identify and avoid Windsurf anti-patterns and common integration mistakes.\nUse when reviewing Windsurf code for issues, onboarding new developers,\nor auditing existing Windsurf integrations for best practices violations.\nTrigger with phrases like \"windsurf mistakes\", \"windsurf anti-patterns\",\n\"windsurf pitfalls\", \"windsurf what not to do\", \"windsurf code review\".","micsapp\u002Fmicstec-skills","micsapp","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F82411001?v=4","01M6GWCFQ6D3PV8EHNY62NN5VW","01M6GWCFVE1PA5HG0DKC7AMFJ3",4,"MIT","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fclaude-code\u002Fplugins-plus-skills\u002Fplugins\u002Fsaas-packs\u002Fwindsurf-pack\u002Fskills\u002Fwindsurf-known-pitfalls\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"windsurf known pitfalls","pitfalls","windsurf","anti-patterns","Existing","for","with","trigger","io","do","code review","use","read","common","integrations","issues","best practices","code","codex","review","2026-11-10 10:12:30",false,"---\nname: windsurf-known-pitfalls\ndescription: |\n  Identify and avoid Windsurf anti-patterns and common integration mistakes.\n  Use when reviewing Windsurf code for issues, onboarding new developers,\n  or auditing existing Windsurf integrations for best practices violations.\n  Trigger with phrases like \"windsurf mistakes\", \"windsurf anti-patterns\",\n  \"windsurf pitfalls\", \"windsurf what not to do\", \"windsurf code review\".\nallowed-tools: Read, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ncompatible-with: claude-code, codex, openclaw\n---\n# Windsurf Known Pitfalls\n\n## Overview\nReal gotchas when using Windsurf (Codeium's AI IDE). Windsurf's Cascade AI agent, Flows architecture, and workspace indexing behave differently from VS Code copilots -- understanding these differences prevents frustrating debugging sessions.\n\n## Prerequisites\n- Windsurf installed and configured\n- Understanding of Cascade's agent model vs inline autocomplete\n- Awareness of workspace indexing behavior\n\n## Instructions\n\n### Step 1: Don't Confuse Cascade with Autocomplete\n\nWindsurf has two AI systems: Cascade (agentic, multi-file) and Supercomplete (inline). Using Cascade for quick completions wastes context.\n\n```\n# BAD: opening Cascade to complete a single line\nUser: \"finish this function signature\"\n# Cascade spins up full agent context, reads multiple files = slow\n\n# GOOD: use Tab for inline Supercomplete, Cascade for multi-step tasks\n# Supercomplete: just type and press Tab\n# Cascade: Cmd+L for multi-file refactoring, debugging, architecture\n```\n\n### Step 2: Manage Cascade Context Window\n\nCascade reads your entire workspace to build context. Large monorepos with node_modules or build artifacts slow it down.\n\n```\n# BAD: no .windsurfignore in a large monorepo\n# Cascade indexes node_modules, dist\u002F, .git\u002F = slow and noisy context\n\n# GOOD: create .windsurfignore (same syntax as .gitignore)\n# .windsurfignore\nnode_modules\u002F\ndist\u002F\nbuild\u002F\n.next\u002F\n*.min.js\n*.bundle.js\ncoverage\u002F\n```\n\n### Step 3: Avoid Overly Broad Cascade Instructions\n\nVague instructions cause Cascade to make sweeping changes across many files.\n\n```\n# BAD: \"refactor the codebase to use TypeScript\"\n# Cascade may try to convert every file at once\n\n# GOOD: scope the task\n\"Convert src\u002Futils\u002Fapi.js to TypeScript. Add proper types for all\nfunction parameters and return values. Don't change other files.\"\n```\n\n### Step 4: Trust But Verify File Edits\n\nCascade can write directly to files. Not reviewing diffs before accepting leads to subtle bugs.\n\n```\n# BAD: accepting all Cascade changes without review\n# Cascade modified 12 files -> \"Accept All\" -> broken tests\n\n# GOOD: review each file change in the diff view\n# 1. Read the Cascade output explaining what it changed\n# 2. Review each file diff individually\n# 3. Accept file by file, or reject problematic changes\n# 4. Run tests before committing\n```\n\n### Step 5: Handle Extension Compatibility\n\nWindsurf is VS Code-based but not all extensions work. Some conflict with Cascade.\n\n```\n# KNOWN CONFLICTS:\n# - GitHub Copilot: conflicts with Supercomplete (disable one)\n# - Other AI assistants: may interfere with Cascade context\n# - Some language servers: duplicate suggestions\n\n# GOOD: disable competing AI extensions\n# Settings > Extensions > disable Copilot if using Windsurf AI\n```\n\n## Error Handling\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Cascade is slow | Large workspace indexed | Add `.windsurfignore` |\n| Wrong file modified | Ambiguous instruction | Be specific about file paths |\n| Conflicting completions | Multiple AI extensions | Disable competing extensions |\n| Cascade loses context | Very long conversation | Start fresh Cascade session |\n| Edits break build | Accepted without review | Always review diffs, run tests |\n\n## Examples\n\n### Effective Cascade Prompts\n```\nGOOD: \"In src\u002Fapi\u002Froutes.ts, add input validation for the POST \u002Fusers\nendpoint using zod. Validate email format and name length (2-50 chars).\nReturn 400 with specific error messages on validation failure.\"  # HTTP 400 Bad Request\n\nBAD: \"Add validation to the API\"\n```\n\n## Resources\n- [Windsurf Docs](https:\u002F\u002Fdocs.windsurf.com)\n- [Cascade Guide](https:\u002F\u002Fdocs.windsurf.com\u002Fcascade)\n\n## Output\n\n- Configuration files or code changes applied to the project\n- Validation report confirming correct implementation\n- Summary of changes made and their rationale","# Windsurf Known Pitfalls\n\n## Overview\nReal gotchas when using Windsurf (Codeium's AI IDE). Windsurf's Cascade AI agent, Flows architecture, and workspace indexing behave differently from VS Code copilots -- understanding these differences prevents frustrating debugging sessions.\n\n## Prerequisites\n- Windsurf installed and configured\n- Understanding of Cascade's agent model vs inline autocomplete\n- Awareness of workspace indexing behavior\n\n## Instructions\n\n### Step 1: Don't Confuse Cascade with Autocomplete\n\nWindsurf has two AI systems: Cascade (agentic, multi-file) and Supercomplete (inline). Using Cascade for quick completions wastes context.\n\n```\n# BAD: opening Cascade to complete a single line\nUser: \"finish this function signature\"\n# Cascade spins up full agent context, reads multiple files = slow\n\n# GOOD: use Tab for inline Supercomplete, Cascade for multi-step tasks\n# Supercomplete: just type and press Tab\n# Cascade: Cmd+L for multi-file refactoring, debugging, architecture\n```\n\n### Step 2: Manage Cascade Context Window\n\nCascade reads your entire workspace to build context. Large monorepos with node_modules or build artifacts slow it down.\n\n```\n# BAD: no .windsurfignore in a large monorepo\n# Cascade indexes node_modules, dist\u002F, .git\u002F = slow and noisy context\n\n# GOOD: create .windsurfignore (same syntax as .gitignore)\n# .windsurfignore\nnode_modules\u002F\ndist\u002F\nbuild\u002F\n.next\u002F\n*.min.js\n*.bundle.js\ncoverage\u002F\n```\n\n### Step 3: Avoid Overly Broad Cascade Instructions\n\nVague instructions cause Cascade to make sweeping changes across many files.\n\n```\n# BAD: \"refactor the codebase to use TypeScript\"\n# Cascade may try to convert every file at once\n\n# GOOD: scope the task\n\"Convert src\u002Futils\u002Fapi.js to TypeScript. Add proper types for all\nfunction parameters and return values. Don't change other files.\"\n```\n\n### Step 4: Trust But Verify File Edits\n\nCascade can write directly to files. Not reviewing diffs before accepting leads to subtle bugs.\n\n```\n# BAD: accepting all Cascade changes without review\n# Cascade modified 12 files -> \"Accept All\" -> broken tests\n\n# GOOD: review each file change in the diff view\n# 1. Read the Cascade output explaining what it changed\n# 2. Review each file diff individually\n# 3. Accept file by file, or reject problematic changes\n# 4. Run tests before committing\n```\n\n### Step 5: Handle Extension Compatibility\n\nWindsurf is VS Code-based but not all extensions work. Some conflict with Cascade.\n\n```\n# KNOWN CONFLICTS:\n# - GitHub Copilot: conflicts with Supercomplete (disable one)\n# - Other AI assistants: may interfere with Cascade context\n# - Some language servers: duplicate suggestions\n\n# GOOD: disable competing AI extensions\n# Settings > Extensions > disable Copilot if using Windsurf AI\n```\n\n## Error Handling\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Cascade is slow | Large workspace indexed | Add `.windsurfignore` |\n| Wrong file modified | Ambiguous instruction | Be specific about file paths |\n| Conflicting completions | Multiple AI extensions | Disable competing extensions |\n| Cascade loses context | Very long conversation | Start fresh Cascade session |\n| Edits break build | Accepted without review | Always review diffs, run tests |\n\n## Examples\n\n### Effective Cascade Prompts\n```\nGOOD: \"In src\u002Fapi\u002Froutes.ts, add input validation for the POST \u002Fusers\nendpoint using zod. Validate email format and name length (2-50 chars).\nReturn 400 with specific error messages on validation failure.\"  # HTTP 400 Bad Request\n\nBAD: \"Add validation to the API\"\n```\n\n## Resources\n- [Windsurf Docs](https:\u002F\u002Fdocs.windsurf.com)\n- [Cascade Guide](https:\u002F\u002Fdocs.windsurf.com\u002Fcascade)\n\n## Output\n\n- Configuration files or code changes applied to the project\n- Validation report confirming correct implementation\n- Summary of changes made and their rationale",{"name":5,"author":48,"license":14,"version":49,"description":50,"allowed-tools":51,"compatible-with":52},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Identify and avoid Windsurf anti-patterns and common integration mistakes.\nUse when reviewing Windsurf code for issues, onboarding new developers,\nor auditing existing Windsurf integrations for best practices violations.\nTrigger with phrases like \"windsurf mistakes\", \"windsurf anti-patterns\",\n\"windsurf pitfalls\", \"windsurf what not to do\", \"windsurf code review\".\n","Read, Grep","claude-code, codex, openclaw","master","3f5d983eb4ef375b749adcd6b07ec03bd82ae8a8","claude-code\u002Fplugins-plus-skills\u002Fplugins\u002Fsaas-packs\u002Fwindsurf-pack\u002Fskills\u002Fwindsurf-known-pitfalls",0,"https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills","https:\u002F\u002Fgithub.com\u002Fmicsapp","2026-03-20 11:24:18",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add micsapp\u002Fmicstec-skills --skill windsurf-known-pitfalls",{"tool":66,"command":67},"bunx","bunx skills add micsapp\u002Fmicstec-skills --skill windsurf-known-pitfalls",{"tool":69,"command":70},"pnpm","pnpm dlx skills add micsapp\u002Fmicstec-skills --skill windsurf-known-pitfalls","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fclaude-code\u002Fplugins-plus-skills\u002Fplugins\u002Fsaas-packs\u002Fwindsurf-pack\u002Fskills\u002Fwindsurf-known-pitfalls\u002FSKILL.md",true,[],[75,109,138,158,177,200],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":89,"publishedAt":43},"01M6HBTJ02FXBFG9NYEHHYAP52","azure-apim-architecture","Analyzes and explains Azure API Management architecture decisions for enterprise API marketplace implementations using VNet Internal mode, Front Door, hybrid authentication, and multi-environment strategies. Use when discussing APIM component selection, network topology, cost optimization, or comparing alternatives like workspaces vs instances, VNet Internal vs External mode, or Front Door vs Application Gateway.","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fcopilot-cli\u002Fcopilot-agent-skills\u002F.github\u002Fskills\u002Fazure-apim-architecture\u002FSKILL.md",[81,84],{"categoryNo":82,"categoryName":83,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":85,"categoryName":86,"taxonomyType":87,"taxonomyTypeDesc":88},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,28],"architecture","azure","azure apim architecture","component","authentication","gateway","topology","Optimization","network","api","team","environment","multi-environment","workspaces","instances","selection","strategies","azure api management","mode",{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":123,"publishedAt":43},"01M6HBT7J4H082JEEA670B3EQ9","apiops-deployment","Guides deployment of Azure API Management infrastructure using Infrastructure as Code (Bicep\u002FTerraform), CI\u002FCD pipelines (GitHub Actions\u002FAzure DevOps), and APIOps workflows. Use when deploying APIM, creating pipelines, or implementing dev→test→prod promotion strategies.","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fcopilot-cli\u002Fcopilot-agent-skills\u002F.github\u002Fskills\u002Fapiops-deployment\u002FSKILL.md",[115,116,119,122],{"categoryNo":82,"categoryName":83,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":117,"categoryName":118,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000011","运维与部署",{"categoryNo":120,"categoryName":121,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":85,"categoryName":86,"taxonomyType":87,"taxonomyTypeDesc":88},[124,125,126,127,91,128,40,129,130,131,132,133,99,100,106,134,135,107,136,137],"deployment","apiops deployment","workflows","azure devops","infrastructure","infrastructure as code","actions","ci","github actions","github-actions","as","guides","CI\u002FCD","implementing",{"skillNo":139,"name":140,"nameZh":6,"description":141,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":142,"categories":143,"keywords":145,"publishedAt":43},"01M6HBT2HEA23THNE9E00GYQBE","apim-policy-authoring","Creates production-ready Azure API Management policy XML for authentication (OAuth 2.0, JWT validation, subscription keys), rate limiting, CORS configuration, error handling, and API transformations. Use when implementing API security, access control, or request\u002Fresponse processing logic.","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fcopilot-cli\u002Fcopilot-agent-skills\u002F.github\u002Fskills\u002Fapim-policy-authoring\u002FSKILL.md",[144],{"categoryNo":82,"categoryName":83,"taxonomyType":20,"taxonomyTypeDesc":21},[146,147,148,149,91,94,99,100,150,34,151,152,153,154,155,107,156,157,137,28],"policy","authoring","apim policy authoring","security","access","ready","api security","Access Control","error","processing","cors configuration","production-ready",{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":162,"categories":163,"keywords":166,"publishedAt":43},"01M6HBSY65SB29J9WE9KYD0K6T","api-security-review","Reviews Azure API Management configurations for security vulnerabilities, OWASP API Security Top 10 compliance, VNet Internal mode validation, Private Link verification, and Azure Security Benchmark alignment. Use when performing security audits, pre-deployment validation, or compliance reviews.","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fcopilot-cli\u002Fcopilot-agent-skills\u002F.github\u002Fskills\u002Fapi-security-review\u002FSKILL.md",[164,165],{"categoryNo":82,"categoryName":83,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":85,"categoryName":86,"taxonomyType":87,"taxonomyTypeDesc":88},[42,149,167,99,152,168,91,124,169,170,171,172,100,173,107,174,175,176,108,28],"security review","api security review","benchmark","verification","owasp","owasp-api","alignment","azure security","reviews","top",{"skillNo":178,"name":179,"nameZh":6,"description":180,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":181,"categories":182,"keywords":183,"publishedAt":43},"01M6HBSRW4PDFE6K4F8JYPZQ05","jira-cli","Interact with Jira from the command line to create, list, view, edit, and transition issues, manage sprints and epics, and perform common Jira workflows. Use when the user asks about Jira tasks, tickets, issues, sprints, or needs to manage project work items.","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fcopilot-cli\u002Fawesome-copilot-agents\u002Fskills\u002Fjira-cli\u002FSKILL.md",[],[184,185,186,126,187,188,189,38,99,36,190,191,192,193,194,195,196,197,198,199],"cli","jira","jira cli","init","tasks","create","work","command","edit","list","view","project","project work","token","line","sprints",{"skillNo":201,"name":202,"nameZh":6,"description":203,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":204,"categories":205,"keywords":206,"publishedAt":43},"01M6HBSNS3JHMW603G47TWE31H","calculator","Performs arbitrary-precision arithmetic calculations including addition, subtraction, multiplication, division, and exponents. Use when the user asks to calculate, compute, or evaluate math expressions, or when precise decimal arithmetic is needed to avoid floating-point errors.","https:\u002F\u002Fgithub.com\u002Fmicsapp\u002Fmicstec-skills\u002Fblob\u002Fmaster\u002Fcopilot-cli\u002Fawesome-copilot-agents\u002Fskills\u002Fcalculator\u002FSKILL.md",[],[202,207,208,209,210,211,212,34,213,214],"npm","js","calculate","node","math","user","compute","errors"]