agent-skills 一键落地实操指南可直接执行适用工具Cursor / Claude Code / Windsurf 主流AI编码客户端环境要求Git、基础终端Windows/Mac/Linux 通用协议MIT免费商用、可二次修改一、前置准备3步必做1. 安装 GitWindows/Mac/Linux 自行安装 Githttps://git-scm.com/终端输入校验git--version输出版本号即正常。2. 选择目标AI编码工具二选一/多选均可Cursor推荐兼容性最佳Claude Code命令行优先Windsurf3. 新建本地项目文件夹创建一个空目录作为你的工作根目录示例# Mac/Linuxmkdiragent-democdagent-demo# Windows CMDmkdiragent-democdagent-demo二、拉取 agent-skills 核心仓库核心步骤在项目根目录终端执行以下命令拉取官方技能库gitclone https://github.com/addyosmani/agent-skills.git执行完成后目录结构agent-demo/ └── agent-skills/ # 谷歌标准技能库无需修改原文件建议不要修改 agent-skills 内部原文件后续自定义规则放在项目自身目录。三、分工具接入配置按你使用的工具对应操作方案ACursor 接入图形化操作最常用步骤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专项安全审计方案BClaude Code命令行模式1. 进入项目目录cdagent-demo2. 启动 Claude Code 并加载技能终端执行claude进入交互界面后输入初始化指令加载 ./agent-skills 技能库全程遵循谷歌六阶段开发流程严格执行质量门禁、测试、安全检查。现在开始开发任务。3. 执行开发流程直接在命令行对话中下达需求AI 会自动按流程走完全链路。四、标准开发全流程固定6步强制顺序不可跳过不管使用哪款工具统一遵循以下执行链路生产项目必须走完全部环节阶段1Define 需求定义指令示例使用 agent-skills 的 spec-driven-development 技能为【你的项目名称/功能】编写完整技术规格文档、需求边界、目标与约束。输出物PRD/技术Spec、功能边界说明。阶段2Plan 任务规划指令示例执行 planning-and-task-breakdown 技能对当前需求做任务拆解、优先级划分、依赖梳理与风险评估。输出物任务清单、架构简图、风险点。阶段3Build 编码构建强制TDD指令示例基于规划结果使用 incremental-implementation TDD 技能增量开发代码遵循谷歌代码规范。输出物源码 配套测试用例。阶段4Verify 验证校验质量门禁指令示例执行单元测试、集成测试、安全扫描、性能检测输出测试报告与安全结果。门禁规则测试不通过、高危漏洞存在禁止进入下一阶段。阶段5Review 代码评审 文档指令示例执行 code-review-and-quality 评审代码补全项目文档、注释、架构决策记录(ADR)。输出物评审意见、完善后的文档。阶段6Ship 发布上线指令示例执行 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编码、测试验证、代码评审、发布交付。守住测试、安全、文档三大质量底线。现在开始实现【在这里填写你的开发需求】
agent-skills 一键落地实操指南-运行指南-周红伟
agent-skills 一键落地实操指南可直接执行适用工具Cursor / Claude Code / Windsurf 主流AI编码客户端环境要求Git、基础终端Windows/Mac/Linux 通用协议MIT免费商用、可二次修改一、前置准备3步必做1. 安装 GitWindows/Mac/Linux 自行安装 Githttps://git-scm.com/终端输入校验git--version输出版本号即正常。2. 选择目标AI编码工具二选一/多选均可Cursor推荐兼容性最佳Claude Code命令行优先Windsurf3. 新建本地项目文件夹创建一个空目录作为你的工作根目录示例# Mac/Linuxmkdiragent-democdagent-demo# Windows CMDmkdiragent-democdagent-demo二、拉取 agent-skills 核心仓库核心步骤在项目根目录终端执行以下命令拉取官方技能库gitclone https://github.com/addyosmani/agent-skills.git执行完成后目录结构agent-demo/ └── agent-skills/ # 谷歌标准技能库无需修改原文件建议不要修改 agent-skills 内部原文件后续自定义规则放在项目自身目录。三、分工具接入配置按你使用的工具对应操作方案ACursor 接入图形化操作最常用步骤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专项安全审计方案BClaude Code命令行模式1. 进入项目目录cdagent-demo2. 启动 Claude Code 并加载技能终端执行claude进入交互界面后输入初始化指令加载 ./agent-skills 技能库全程遵循谷歌六阶段开发流程严格执行质量门禁、测试、安全检查。现在开始开发任务。3. 执行开发流程直接在命令行对话中下达需求AI 会自动按流程走完全链路。四、标准开发全流程固定6步强制顺序不可跳过不管使用哪款工具统一遵循以下执行链路生产项目必须走完全部环节阶段1Define 需求定义指令示例使用 agent-skills 的 spec-driven-development 技能为【你的项目名称/功能】编写完整技术规格文档、需求边界、目标与约束。输出物PRD/技术Spec、功能边界说明。阶段2Plan 任务规划指令示例执行 planning-and-task-breakdown 技能对当前需求做任务拆解、优先级划分、依赖梳理与风险评估。输出物任务清单、架构简图、风险点。阶段3Build 编码构建强制TDD指令示例基于规划结果使用 incremental-implementation TDD 技能增量开发代码遵循谷歌代码规范。输出物源码 配套测试用例。阶段4Verify 验证校验质量门禁指令示例执行单元测试、集成测试、安全扫描、性能检测输出测试报告与安全结果。门禁规则测试不通过、高危漏洞存在禁止进入下一阶段。阶段5Review 代码评审 文档指令示例执行 code-review-and-quality 评审代码补全项目文档、注释、架构决策记录(ADR)。输出物评审意见、完善后的文档。阶段6Ship 发布上线指令示例执行 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编码、测试验证、代码评审、发布交付。守住测试、安全、文档三大质量底线。现在开始实现【在这里填写你的开发需求】
