Agent Skills安装使用教程
GitHub: addyosmani/agent-skills目录安装教程重启后的变化使用教程技能详解常见问题1. 安装教程方式一Marketplace 自动安装推荐# 1. 添加 marketplaceclaude plugin marketplaceaddaddyosmani/agent-skills# 2. 安装插件claude plugininstallagent-skillsaddy-agent-skills方式二手动安装网络受限时使用# 1. 创建目录mkdir-p~/.claude/plugins/repos ~/.claude/plugins/cache/agent-skills# 2. 克隆仓库cd~/.claude/plugins/reposgitclone https://github.com/addyosmani/agent-skills.git# 3. 复制文件到缓存目录cdagent-skillscp-r* ~/.claude/plugins/cache/agent-skills/然后手动编辑配置文件编辑~/.claude/plugins/installed_plugins.json{version:2,plugins:{agent-skillsaddy-agent-skills:[{scope:user,installPath:C:\\Users\\Lenovo\\.claude\\plugins\\cache\\agent-skills,version:1.0.0,installedAt:2026-06-25T06:12:00.000Z,lastUpdated:2026-06-25T06:12:00.000Z}]}}编辑~/.claude/settings.json在enabledPlugins中添加{enabledPlugins:{eccecc:true,agent-skillsaddy-agent-skills:true}}验证安装# 检查技能目录ls~/.claude/plugins/cache/agent-skills/skills/# 检查命令目录ls~/.claude/plugins/cache/agent-skills/commands/更新插件# 拉取最新代码cd~/.claude/plugins/repos/agent-skillsgitpull# 同步到缓存目录cdagent-skillscp-r* ~/.claude/plugins/cache/agent-skills/# 重启 Claude Code 生效2. 重启后的变化新增的斜杠命令重启 Claude Code 后你将获得以下 8 个新命令命令功能使用示例/spec定义规格先规格后代码/spec 用户登录功能/planning任务规划与拆分/planning/build增量构建/build/build auto自动生成计划并实现/build auto/test测试验证/test/review代码审查/review/ship发布到生产环境/ship/code-simplify代码简化/code-simplify/webperfWeb 性能审计/webperf新增的技能能力Claude Code 将获得以下专业能力阶段技能说明定义interview-me通过访谈明确需求idea-refine精炼想法spec-driven-development规格驱动开发规划planning-and-task-breakdown任务拆分构建incremental-implementation增量实现test-driven-development测试驱动开发context-engineering上下文工程source-driven-development源码驱动开发doubt-driven-development怀疑驱动开发frontend-ui-engineering前端 UI 工程api-and-interface-designAPI 接口设计验证browser-testing-with-devtools浏览器测试debugging-and-error-recovery调试与错误恢复审查code-review-and-quality代码质量审查code-simplification代码简化security-and-hardening安全加固performance-optimization性能优化发布git-workflow-and-versioningGit 工作流ci-cd-and-automationCI/CD 自动化deprecation-and-migration弃用与迁移documentation-and-adrs文档与决策记录observability-and-instrumentation可观测性shipping-and-launch发布上线新增的专家角色角色职责code-reviewer代码审查专家test-engineer测试工程师security-auditor安全审计师web-performance-auditorWeb 性能审计师新增的参考清单definition-of-done- 完成定义testing-patterns- 测试模式security-checklist- 安全检查清单performance-checklist- 性能检查清单accessibility-checklist- 无障碍检查清单observability-checklist- 可观测性检查清单orchestration-patterns- 编排模式3. 使用教程基本工作流程DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP 定义 规划 构建 验证 审查 发布场景一新功能开发完整流程步骤 1定义规格# 启动 Claude Codeclaude# 使用 /spec 定义功能规格/spec 用户注册功能支持邮箱和手机号注册Claude 会询问需求细节生成规格说明定义验收标准步骤 2规划任务/planningClaude 会拆分为小的原子任务确定任务依赖关系生成实施计划步骤 3增量构建/buildClaude 会一次实现一个任务切片每完成一个任务进行验证保持代码可运行状态步骤 4测试验证/testClaude 会编写测试用例运行测试验证覆盖率步骤 5代码审查/reviewClaude 会检查代码质量检查安全问题提供改进建议步骤 6发布/shipClaude 会准备发布文档执行 CI/CD 流程部署到生产环境场景二快速构建自动化模式# 一键完成规划和实现/build autoClaude 会自动生成计划展示计划供审批实现所有任务场景三代码审查# 审查当前代码/review# 简化代码/code-simplify# 性能审计/webperf场景四Bug 修复# 调试模式# Claude 会自动使用 debugging-and-error-recovery 技能# 修复后验证/test# 提交前审查/review高级用法组合使用# 先定义规格/spec API 接口设计# 规划任务/planning# 增量构建/build# 安全审查/review Claude 会自动应用 security-auditor 角色# 性能优化/webperf指定重点# 代码审查时关注安全/review 重点关注 SQL 注入和 XSS# 性能审计时关注加载速度/webperf 重点关注首屏加载时间4. 技能详解核心技能说明spec-driven-development- 规格驱动开发原则: 先写规格再写代码流程:收集需求编写规格说明定义验收标准基于规格实现好处:减少返工明确预期便于测试incremental-implementation- 增量实现原则: 一次一个切片始终保持可运行流程:选择最小可运行切片实现并测试确认可运行进入下一个切片好处:降低风险便于调试持续交付价值test-driven-development- 测试驱动开发原则: 测试即证明流程:编写失败的测试 (RED)编写最小实现使测试通过 (GREEN)重构代码 (REFACTOR)好处:代码质量高重构有信心文档即测试doubt-driven-development- 怀疑驱动开发原则: 当不确定时停下来验证流程:识别不确定性编写验证代码确认假设正确继续实现好处:避免错误假设减少 bug提高代码可靠性context-engineering- 上下文工程原则: 为 AI 提供最佳上下文技巧:清晰的文件结构良好的命名适当的注释有意义的类型定义好处:AI 理解更准确生成代码质量更高减少误解专家角色说明code-reviewer- 代码审查专家职责:检查代码质量发现潜在 bug提供改进建议检查项:命名规范代码结构错误处理性能问题test-engineer- 测试工程师职责:设计测试策略编写测试用例验证覆盖率测试类型:单元测试集成测试端到端测试security-auditor- 安全审计师职责:检查安全漏洞验证输入验证审查认证授权检查项:SQL 注入XSS 攻击CSRF 防护敏感数据泄露web-performance-auditor- Web 性能审计师职责:测量性能指标识别瓶颈提供优化建议关注指标:LCP (最大内容绘制)FID (首次输入延迟)CLS (累积布局偏移)5. 常见问题Q1: 命令不生效怎么办检查:确认插件已安装ls ~/.claude/plugins/cache/agent-skills/确认配置正确检查installed_plugins.json和settings.json重启 Claude CodeQ2: 如何更新插件cd~/.claude/plugins/repos/agent-skillsgitpullcp-r* ~/.claude/plugins/cache/agent-skills/# 重启 Claude CodeQ3:/build auto和/build有什么区别模式说明/build增量构建一次一个任务每步确认/build auto自动生成计划并实现所有任务只在开始时确认Q4: 如何跳过某些步骤Agent Skills 设计为强制执行完整流程但你可以明确说明: “跳过测试直接发布”接受风险: Claude 会警告但会执行注意: 不建议跳过测试和安全审查Q5: 插件和其他插件冲突吗Agent Skills 与其他插件如 ECC兼容可以同时使用。Q6: 如何禁用插件编辑~/.claude/settings.json{enabledPlugins:{agent-skillsaddy-agent-skills:false}}或删除插件rm-rf~/.claude/plugins/cache/agent-skills附录快速参考卡┌─────────────────────────────────────────────────────┐ │ Agent Skills 命令速查 │ ├─────────────────────────────────────────────────────┤ │ /spec - 定义功能规格 │ │ /planning - 任务规划与拆分 │ │ /build - 增量构建逐步确认 │ │ /build auto - 自动构建一键完成 │ │ /test - 测试验证 │ │ /review - 代码审查 │ │ /code-simplify - 代码简化 │ │ /ship - 发布部署 │ │ /webperf - Web 性能审计 │ ├─────────────────────────────────────────────────────┤ │ 工作流程: DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP │ └─────────────────────────────────────────────────────┘参考链接GitHub: addyosmani/agent-skills