agent-skills 一键落地实操指南-运行指南-周红伟
agent-skills 一键落地实操指南（可直接执行）
适用工具：Cursor / Claude Code / Windsurf 主流AI编码客户端
环境要求：Git、基础终端，Windows/Mac/Linux 通用
协议：MIT，免费商用、可二次修改
一、前置准备（3步，必做）
1. 安装 Git
- Windows/Mac/Linux 自行安装 Git：https://git-scm.com/
- 终端输入校验：
git--version输出版本号即正常。
2. 选择目标AI编码工具
二选一/多选均可：
- Cursor（推荐，兼容性最佳）
- Claude Code（命令行优先）
- Windsurf
3. 新建本地项目文件夹
创建一个空目录，作为你的工作根目录，示例：
# Mac/Linuxmkdiragent-demo&&cdagent-demo# Windows CMDmkdiragent-democdagent-demo二、拉取 agent-skills 核心仓库（核心步骤）
在项目根目录终端执行以下命令，拉取官方技能库：
gitclone https://github.com/addyosmani/agent-skills.git执行完成后，目录结构：
agent-demo/ └── agent-skills/ # 谷歌标准技能库（无需修改原文件）建议：不要修改 agent-skills 内部原文件，后续自定义规则放在项目自身目录。
三、分工具接入配置（按你使用的工具对应操作）
方案A：Cursor 接入（图形化操作，最常用）
步骤1：打开 Cursor，进入当前项目
- 启动 Cursor →
Open Folder→ 选中上面创建的agent-demo文件夹 - 确保左侧文件树能看到
agent-skills文件夹
步骤2：全局加载技能（两种模式任选）
模式1：单次会话启用（临时，当前对话生效）
打开 Cursor 对话面板，直接粘贴启动指令：
请加载当前目录下 agent-skills 完整技能体系，严格按照 Define → Plan → Build → Verify → Review → Ship 六阶段流程执行所有开发任务，不得跳过任意质量门禁。模式2：全局永久启用（推荐，所有项目生效）
- Cursor 右上角 → 设置（⚙️）→
Rules for AI - 在Global Rules全局规则区粘贴：
项目根目录存在 agent-skills 文件夹时，强制启用该技能库。所有开发严格遵循 agent-skills 定义的六阶段工程流程：需求定义、任务规划、编码构建、测试验证、代码评审、发布上线。必须执行TDD、单元测试、安全扫描、文档编写，输出生产级代码。- 保存设置，全局生效。
步骤3：使用内置快捷命令
对话中直接输入斜杠命令，一键触发对应流程：
/spec：进入需求&规格定义阶段/plan：任务拆解与架构规划/build：增量编码 + TDD开发/test：全量测试+安全扫描/review：代码评审+文档补全/security：专项安全审计
方案B：Claude Code（命令行模式）
1. 进入项目目录
cdagent-demo2. 启动 Claude Code 并加载技能
终端执行：
claude进入交互界面后，输入初始化指令：
加载 ./agent-skills 技能库，全程遵循谷歌六阶段开发流程，严格执行质量门禁、测试、安全检查。现在开始开发任务。3. 执行开发流程
直接在命令行对话中下达需求，AI 会自动按流程走完全链路。
四、标准开发全流程（固定6步，强制顺序，不可跳过）
不管使用哪款工具，统一遵循以下执行链路，生产项目必须走完全部环节
阶段1：Define 需求定义
指令示例：
使用 agent-skills 的 spec-driven-development 技能，为【你的项目名称/功能】编写完整技术规格文档、需求边界、目标与约束。输出物：PRD/技术Spec、功能边界说明。
阶段2：Plan 任务规划
指令示例：
执行 planning-and-task-breakdown 技能，对当前需求做任务拆解、优先级划分、依赖梳理与风险评估。输出物：任务清单、架构简图、风险点。
阶段3：Build 编码构建（强制TDD）
指令示例：
基于规划结果，使用 incremental-implementation + TDD 技能增量开发代码，遵循谷歌代码规范。输出物：源码 + 配套测试用例。
阶段4：Verify 验证校验（质量门禁）
指令示例：
执行单元测试、集成测试、安全扫描、性能检测，输出测试报告与安全结果。门禁规则：测试不通过、高危漏洞存在，禁止进入下一阶段。
阶段5：Review 代码评审 & 文档
指令示例：
执行 code-review-and-quality 评审代码，补全项目文档、注释、架构决策记录(ADR)。输出物：评审意见、完善后的文档。
阶段6：Ship 发布上线
指令示例：
执行 git-workflow-and-versioning + shipping-and-launch 技能，规范提交代码、配置版本号、编写上线说明与回滚预案。输出物：规范Git提交、上线文档、回滚方案。
五、自定义适配（企业/团队二次修改）
如需叠加公司内部规范、代码风格、强制覆盖率、行业合规，无需改动原仓库：
- 在
agent-demo根目录新建custom-skills文件夹 - 新建
custom-rules.md，写入团队自定义规则，示例：
# 团队自定义补充规则 1. 单元测试覆盖率必须 ≥ 80% 2. 禁止使用指定高危API 3. 代码必须添加中文注释 4. 所有接口必须编写接口文档- 在AI启动指令中追加一句：
同时遵循当前目录 custom-skills/custom-rules.md 团队规范。六、日常维护 & 更新技能库
后续官方更新 agent-skills，终端进入agent-skills目录拉取最新：
cdagent-skillsgitpull七、常见问题快速排错
AI 不按六阶段执行、跳过步骤
重新发送强约束指令：禁止跳过任何阶段与质量门禁，严格按Define→Plan→Build→Verify→Review→Ship顺序执行找不到 agent-skills 目录
确认终端/ Cursor 打开的是上级根目录，而非 agent-skills 子目录。执行缓慢、上下文过载
单次只启用单个阶段技能，不要一次性加载全部技能。个人简单Demo觉得流程繁琐
指令追加：当前为演示项目，简化流程，保留核心编码与基础测试即可
八、极简快速启动模板（复制即用）
通用万能启动语（所有工具通用）
已加载 agent-skills 工程技能库，接下来所有开发严格遵循谷歌六阶段开发流程：需求定义、任务规划、TDD编码、测试验证、代码评审、发布交付。守住测试、安全、文档三大质量底线。现在开始实现：【在这里填写你的开发需求】