Agent Skills 项目介绍

Agent Skills 项目介绍

项目定位

一套面向 AI 编码 Agent 的生产级工程技能包，将高级软件工程师的工作流程编码为结构化工作流，确保 AI Agent 在编码过程中遵循与人类高级工程师相同的质量纪律。

一句话：AI Agent 默认的”最短路径”是跳过规格、测试和安全审查；Agent Skills 让 Agent 在写代码之前就思考清楚。

核心能力

能力	说明
7 个斜杠命令	/spec → /plan → /build → /test → /review → /code-simplify → /ship，映射完整开发生命周期
23 个结构化技能	按 Define → Plan → Build → Verify → Review → Ship 六个阶段组织，每个技能包含工作流步骤、质量门控和反合理化表
3 个专业角色	code-reviewer（高级工程师）、security-auditor（安全工程师）、test-engineer（QA 专家），支持并行扇出审查
多工具链适配	原生支持 Claude Code、Cursor、Gemini CLI、Windsurf、OpenCode、GitHub Copilot、Kiro 等 7+ 编码工具
Hook 生命周期	通过 SessionStart 等钩子实现会话级自动化，如 SDD 缓存管理和 code-simplify 忽略规则
编排模式参考	定义了 5 种端到端编排模式及 4 种反模式，包含 Agent Teams 实战案例

技术栈

• 技能定义格式：Markdown + YAML frontmatter（纯文本，无运行时依赖）
• Slash Commands：Claude Code 命令格式（.claude/commands/*.md）+ Gemini CLI 命令（.gemini/commands/）
• 角色系统：Agent 人格定义文件（agents/*.md），作为子 Agent 或 Agent Teams 角色使用
• Hook 脚本：Bash 脚本（hooks/*.sh），通过 hooks.json 配置触发
• 辅助脚本：JavaScript 验证脚本（scripts/validate-skills.js）

架构概览

快速体验

推荐方式：Claude Code 插件安装

# 方式 1：从 GitHub 直接安装
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

# 方式 2：通过 Marketplace 安装
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

安装后即可使用 /spec、/plan、/build 等 7 个斜杠命令。

本地开发

git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills
# 技能文件为纯 Markdown，任何 AI Agent 均可直接读取使用

教程导读

本项目教程分为 AI 应用通用知识 和 编程核心技术 两部分：

AI 应用通用知识（6 章）

从 Agent Skills 项目中抽象出的行业通用知识，涵盖：

• Agent 技能系统设计模式（SKILL.md 解剖学、渐进式披露）
• 反合理化机制（阻止 Agent 跳过关键步骤的设计方法）
• 对抗式审查方法论（Doubt-Driven Development）
• Agent 角色与编排模式（Persona 系统、平行扇出、反模式）
• 上下文工程实践（Context Hierarchy、Context Packing、困惑管理）
• 源码驱动开发方法论（Source-Driven Development）

编程核心技术（5 章）

Agent Skills 项目本身的工程实践：

• 技能包架构与文件组织设计
• Hook 系统与会话生命周期管理
• 多工具链适配策略
• 斜杠命令设计与意图映射
• 技能验证工具与质量保证

引用的 Common 教程

• Agent 技能系统设计
• 系统提示组装策略
• 多 Agent 路由与隔离
• 记忆系统设计
• Hook 系统