AI Coding Agents 的“生产级技能包”

AI Coding Agents 的“生产级技能包” 一、项目定位与核心理念项目名称agent-skills维护者Addy Osmani目标用户Claude Code、Cursor、Gemini CLI、Windsurf 等 AI 编码代理核心思想Skills encode the workflows, quality gates, and best practices that senior engineers use when building software.❌ 不是简单的“提示词合集”✅ 是结构化、可执行、带验证的资深工程师工作流✅ 覆盖从Idea → Ship的完整生命周期 二、项目结构7 个 Slash 命令 20 个核心技能 六大阶段与对应命令DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP /spec /plan /build /test /review /ship额外命令/code-simplify️ 20 个技能分类位于skills/目录1. Define定义idea-refine模糊想法 → 具体提案spec-driven-development先输出 PRD目标、结构、风格、测试、边界2. Plan拆解planning-and-task-breakdownSpec → 可验证小任务 验收标准 依赖顺序3. Build实现incremental-implementation薄切片 Feature Flag 回滚test-driven-developmentRed-Green-Refactor 测试金字塔context-engineering精准上下文注入rules MCPsource-driven-development所有决策基于官方文档frontend-ui-engineering组件化 响应式 WCAG 2.1 AAapi-and-interface-design契约优先 Hyrum’s Law 单版本规则4. Verify验证browser-testing-with-devtoolsChrome DevTools MCP 验证debugging-and-error-recovery五步定位 停止线原则5. Review审查code-review-and-quality五轴审查 变更 ≤100 行code-simplificationChesterton’s Fence Rule of 500security-and-hardeningOWASP Top 10 三层边界performance-optimization先测量 Core Web Vitals6. Ship交付git-workflow-and-versioningTrunk-based 原子提交ci-cd-and-automation左移 质量门流水线deprecation-and-migration代码即负债 弃用策略documentation-and-adrs记录“为什么”shipping-and-launch预发布检查 分阶段 监控附加组件元技能using-agent-skills如何发现和调用技能3 个 Agent Personascode-reviewer、test-engineer、security-auditor4 个 Reference Checklists测试模式、安全检查表等⚙️ 三、工作原理Skill 的 Anatomy每个技能是一个高度结构化的 Markdown 文件SKILL.md 标准章节章节作用Frontmatternamedescription自动发现用Overview一句话定位When to Use触发条件 排除场景Core Process编号步骤、命令、ASCII 流程图Common Rationalizations为 AI 设计的“防作弊表格”如“简单任务不需要 spec” → “仍需验收标准”Red Flags违反技能时的可观测行为Verification带 checkbox 的退出条件 证据要求日志、截图等 支持文件机制supporting-file.md超过 100 行的 checklist 单独存放按需加载 元技能中的核心行为主动暴露假设ASSUMPTIONS I’M MAKING主动管理困惑、敢于质疑强制简单性、范围纪律、不假设要验证 四、使用方法✅ Claude Code推荐/plugin marketplaceaddaddyosmani/agent-skills /plugininstallagent-skillsaddy-agent-skills或本地开发模式gitclone https://github.com/addyosmani/agent-skills.git claude --plugin-dir /path/to/agent-skills✅ Cursor将skills/内容复制到.cursor/rules/✅ Gemini CLIgemini skillsinstallhttps://github.com/addyosmani/agent-skills.git--pathskills✅ 其他工具Windsurf、OpenCode、GitHub Copilot、Kiro详见docs/目录 五、推荐使用流程新项目 / 大功能spec-driven-development→planning-and-task-breakdown每次实现前让 agent 输出ASSUMPTIONS IM MAKING代码审查前切换到code-reviewerpersona 执行code-review-and-quality每次变更遵守git-workflow-and-versioningincremental-implementation✅六、核心特点1.生产级而非玩具级每一步都有验证门、证据要求、反理性化防御。2.上下文感知 自动激活无需手动指定agent 根据当前任务自动选择技能。3.跨工具原生支持Markdown 格式任何支持 system prompt 或 instruction 文件的 agent 都能用。4.持续维护GitHub Actions 验证插件结构CONTRIBUTING.md 明确了新增技能的格式要求。5.Token 友好Progressive disclosure主技能简洁支持文件按需加载。✅ 七、使用方法Claude Code推荐直接用 /spec、/plan 等 slash 命令或让 agent 引用具体技能名如 follow the spec-driven-development skill。Cursor把任意 SKILL.md 复制到 .cursor/rules/或整个 skills/ 目录作为 reference。Gemini CLIgemini skills install https://github.com/addyosmani/agent-skills.git --path skillsWindsurf / OpenCode / GitHub Copilot / Kiro IDE分别参考 docs/ 下的对应 setup 文件把技能内容或 AGENTS.md 注入 rules / personas。通用方法任何 agent 只要能读 Markdown 指令文件都可直接加载。项目还提供了 hooks/会话生命周期钩子和 agents/预置 personas进一步增强集成能力。✅ 八、核心优势总结特点说明生产级每步都有验证门、证据要求、反理性化防御自动激活Agent 根据上下文自动选择技能跨工具Markdown 格式任意 agent 可读持续维护GitHub Actions 验证 贡献规范Token 友好主技能简洁支持文件按需加载 项目地址https://github.com/addyosmani/agent-skills