项目名称: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 的完整生命周期
六大阶段与对应命令
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 AAapi-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 500security-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:测试模式、安全检查表等
每个技能是一个高度结构化的 Markdown 文件(SKILL.md)
标准章节
name +
description(自动发现用)
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 marketplace add addyosmani/agent-skills /plugin install agent-skills@addy-agent-skills
或本地开发模式:
git clone https://github.com/addyosmani/agent-skills.git claude --plugin-dir /path/to/agent-skills
✅ Cursor
- 将
skills/内容复制到.cursor/rules/
✅ Gemini CLI
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
✅ 其他工具
- Windsurf、OpenCode、GitHub Copilot、Kiro:详见
docs/目录
- 新项目 / 大功能
spec-driven-development→planning-and-task-breakdown
- 每次实现前
让 agent 输出ASSUMPTIONS I'M MAKING
- 代码审查前
切换到code-reviewerpersona + 执行code-review-and-quality
- 每次变更
遵守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
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/269374.html