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-breakdown：Spec → 可验证小任务 + 验收标准 + 依赖顺序

3. Build（实现）

• incremental-implementation：薄切片 + Feature Flag + 回滚
• test-driven-development：Red-Green-Refactor + 测试金字塔
• context-engineering：精准上下文注入（rules + MCP）
• source-driven-development：所有决策基于官方文档
• frontend-ui-engineering：组件化 + 响应式 + WCAG 2.1 AA
• api-and-interface-design：契约优先 + Hyrum’s Law + 单版本规则

4. Verify（验证）

• browser-testing-with-devtools：Chrome DevTools MCP 验证
• debugging-and-error-recovery：五步定位 + 停止线原则

5. Review（审查）

• code-review-and-quality：五轴审查 + 变更 ≤100 行
• code-simplification：Chesterton’s Fence + Rule of 500
• security-and-hardening：OWASP Top 10 + 三层边界
• performance-optimization：先测量 + Core Web Vitals

6. Ship（交付）

• git-workflow-and-versioning：Trunk-based + 原子提交
• ci-cd-and-automation：左移 + 质量门流水线
• deprecation-and-migration：代码即负债 + 弃用策略
• documentation-and-adrs：记录“为什么”
• shipping-and-launch：预发布检查 + 分阶段 + 监控

附加组件

• 元技能：using-agent-skills（如何发现和调用技能）
• 3 个 Agent Personas：code-reviewer、test-engineer、security-auditor
• 4 个 Reference Checklists：测试模式、安全检查表等

⚙️ 三、工作原理：Skill 的 Anatomy

每个技能是一个高度结构化的 Markdown 文件（SKILL.md）

📄 标准章节

🔁 支持文件机制

• supporting-file.md：超过 100 行的 checklist 单独存放，按需加载

🧠 元技能中的核心行为

• 主动暴露假设（ASSUMPTIONS I’M MAKING）
• 主动管理困惑、敢于质疑
• 强制简单性、范围纪律、不假设要验证

🚀 四、使用方法

✅ Claude Code（推荐）

/plugin marketplaceaddaddyosmani/agent-skills /plugininstallagent-skills@addy-agent-skills

或本地开发模式：

gitclone https://github.com/addyosmani/agent-skills.git claude --plugin-dir /path/to/agent-skills

✅ Cursor

• 将skills/内容复制到.cursor/rules/

✅ Gemini CLI

gemini skillsinstallhttps://github.com/addyosmani/agent-skills.git--pathskills

✅ 其他工具

• Windsurf、OpenCode、GitHub Copilot、Kiro：详见docs/目录

💡 五、推荐使用流程

1. 新项目 / 大功能
   spec-driven-development→planning-and-task-breakdown

2. 每次实现前
   让 agent 输出ASSUMPTIONS I'M MAKING

3. 代码审查前
   切换到code-reviewerpersona + 执行code-review-and-quality

4. 每次变更
   遵守git-workflow-and-versioning+incremental-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 CLI：gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Windsurf / OpenCode / GitHub Copilot / Kiro IDE：分别参考 docs/ 下的对应 setup 文件，把技能内容或 AGENTS.md 注入 rules / personas。

通用方法：任何 agent 只要能读 Markdown 指令文件，都可直接加载。

项目还提供了 hooks/（会话生命周期钩子）和 agents/（预置 personas），进一步增强集成能力。

✅ 八、核心优势总结

🔗 项目地址：https://github.com/addyosmani/agent-skills