掌握15个AI编码核心技能:从需求分析到生产部署的完整指南
掌握15个AI编码核心技能从需求分析到生产部署的完整指南【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsAgent Skills 是一个专为AI编码代理设计的生产级工程技能集合它提供了一套完整的开发流程框架帮助开发者和AI代理从需求定义到代码部署的每个环节都遵循最佳实践。无论你是AI编码代理还是人类开发者这套技能集都能显著提升你的开发效率、代码质量和项目成功率。为什么需要AI编码技能集现代软件开发中AI编码代理越来越普及但它们往往倾向于走最短路径——跳过规范、测试和安全审查等关键环节。Agent Skills通过结构化的工作流程强制AI代理遵循与资深工程师相同的纪律确保代码达到生产级质量。每个技能都融入了Google工程文化的精华实践包括API设计中的Hyrum法则、测试中的Beyonce规则、代码审查中的变更规模控制等。这些不是抽象原则而是直接嵌入到AI代理逐步执行的工作流程中。快速入门指南要开始使用Agent Skills只需克隆仓库git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills然后参考官方文档docs/getting-started.md开始你的技能之旅。核心命令体系Agent Skills提供了8个斜杠命令对应完整的开发生命周期开发阶段命令核心原则需求定义/spec先规范后代码任务规划/plan小原子任务增量构建/build一次一个切片测试验证/test测试即证明代码审查/review提升代码健康度性能审计/webperf优化前先测量代码简化/code-simplify清晰胜于巧妙生产部署/ship更快更安全想要更自动化的工作流/build auto命令可以一次性生成计划并自动执行所有任务——你只需批准一次计划然后它会自主运行。这减少了人工介入但保留了验证环节每个任务仍然是测试驱动且独立提交的遇到失败或风险步骤时会自动暂停。基础能力定义与规划阶段需求澄清与细化概念解析在项目启动阶段明确需求是成功的关键。Agent Skills通过结构化方法将模糊的想法转化为具体可执行的方案。应用场景需求描述不够明确时需要深入理解用户真实需求定义明确的验收标准实操要点使用interview-me技能进行单问题访谈提取用户真实需求而非表面需求应用idea-refine技能进行结构化发散/收敛思考采用spec-driven-development技能编写产品需求文档涵盖目标、命令、结构、代码风格、测试和边界任务分解与规划概念解析将复杂项目分解为可执行的小任务明确优先级和时间节点。应用场景已有规范需要具体实施计划大型功能需要分阶段实现团队协作需要明确任务分工实操要点使用planning-and-task-breakdown技能分解规范为小验证任务为每个任务定义明确的验收标准建立依赖关系和执行顺序开发实战构建与验证阶段增量实现策略概念解析将大功能分解为小增量逐步构建系统实现快速交付可用功能。应用场景任何涉及多个文件的变更需要快速交付可用功能保持代码质量同时实现快速迭代实操要点采用incremental-implementation技能进行细粒度垂直切片实施-测试-验证-提交的循环流程使用功能标志和安全默认值测试驱动开发概念解析先写测试再编码的开发方法有效提高代码质量和可维护性。应用场景实现业务逻辑修复bug或改变行为确保代码变更不会破坏现有功能实操要点遵循红-绿-重构的TDD循环应用测试金字塔原则80/15/5使用DAMP而非DRY原则编写测试前端UI工程实践概念解析现代Web应用对前端UI有越来越高的要求需要系统化的组件架构和状态管理方法。应用场景构建或修改用户界面创建可复用的设计系统实现响应式设计和无障碍访问实操要点采用组件化架构设计实施WCAG 2.1 AA无障碍标准应用设计系统统一UI风格质量保障审查与优化阶段五轴代码审查概念解析系统化的代码审查方法从五个维度全面评估代码质量。应用场景合并任何变更前的质量检查确保代码符合团队标准发现潜在问题和改进机会实操要点应用五轴审查法功能、设计、可读性、测试、安全控制变更规模约100行使用严重性标签Nit/可选/FYI性能优化工作流概念解析基于测量的性能优化方法避免无依据的猜测和过早优化。应用场景存在性能要求或SLA用户报告缓慢行为Core Web Vitals分数低于阈值实操要点测量使用真实数据建立基线识别找到实际瓶颈而非假设修复解决特定瓶颈验证再次测量确认改进防护添加监控防止回归核心Web指标目标指标良好需要改进差LCP≤ 2.5秒≤ 4.0秒 4.0秒INP≤ 200毫秒≤ 500毫秒 500毫秒CLS≤ 0.1≤ 0.25 0.25安全加固实践概念解析将安全最佳实践融入开发过程保护应用和用户数据。应用场景处理用户输入实现认证授权数据存储和外部集成实操要点预防OWASP Top 10漏洞实施三层边界系统进行依赖项审计和密钥管理部署运维发布与监控阶段CI/CD与自动化概念解析持续集成和持续部署是现代开发的核心实践实现构建、测试和部署的自动化。应用场景设置或修改构建部署流水线实现质量门禁自动化建立快速反馈循环实操要点实施左移策略使用功能标志进行安全部署建立质量门禁流水线Git工作流与版本控制概念解析高效的Git工作流是团队协作的基础需要统一的提交规范和分支策略。应用场景任何代码变更团队协作开发版本管理和发布实操要点采用主干开发模式实施原子提交原则控制变更规模约100行可观测性与监控概念解析在生产环境中监控应用运行状态快速发现和解决问题。应用场景添加遥测功能部署生产环境应用建立监控告警系统实操要点实施结构化日志记录定义RED指标请求、错误、持续时间建立基于症状的告警机制高级技巧与专业代理专家代理角色Agent Skills提供了预配置的专业代理角色针对特定领域进行深度审查代理角色视角代码审查员高级工程师五轴代码审查以高级工程师是否会批准为标准测试工程师QA专家测试策略、覆盖率分析和证明它模式安全审计员安全工程师漏洞检测、威胁建模、OWASP评估Web性能审计员Web性能工程师Core Web Vitals审计包含快速/深度模式和指标诚实规则技能工作机制每个技能都遵循一致的结构┌─────────────────────────────────────────────────┐ │ SKILL.md │ │ │ │ ┌─ 前置信息 ───────────────────────────────┐ │ │ │ 名称小写连字符名称 │ │ │ │ 描述指导代理完成[任务]。 │ │ │ │ 使用时机… │ │ │ └───────────────────────────────────────────┘ │ │ 概述 → 该技能的作用 │ │ 使用时机 → 触发条件 │ │ 流程 → 逐步工作流程 │ │ 合理化反驳 → 常见借口 反驳论点 │ │ 危险信号 → 出现问题的迹象 │ │ 验证 → 证据要求 │ └─────────────────────────────────────────────────┘关键设计选择流程而非散文技能是代理遵循的工作流程而非阅读的参考文档反合理化每个技能包含常见借口的表格及反驳论点验证不可协商每个技能以证据要求结束看起来正确永远不够渐进式披露SKILL.md是入口点仅在需要时加载支持参考项目结构与资源目录结构agent-skills/ ├── skills/ # 24个技能23个生命周期 1个元技能 │ ├── interview-me/ # 定义阶段 │ ├── idea-refine/ # 定义阶段 │ ├── spec-driven-development/ # 定义阶段 │ ├── planning-and-task-breakdown/ # 规划阶段 │ ├── incremental-implementation/ # 构建阶段 │ ├── context-engineering/ # 构建阶段 │ ├── source-driven-development/ # 构建阶段 │ ├── doubt-driven-development/ # 构建阶段 │ ├── frontend-ui-engineering/ # 构建阶段 │ ├── test-driven-development/ # 构建阶段 │ ├── api-and-interface-design/ # 构建阶段 │ ├── browser-testing-with-devtools/ # 验证阶段 │ ├── debugging-and-error-recovery/ # 验证阶段 │ ├── code-review-and-quality/ # 审查阶段 │ ├── code-simplification/ # 审查阶段 │ ├── security-and-hardening/ # 审查阶段 │ ├── performance-optimization/ # 审查阶段 │ ├── git-workflow-and-versioning/ # 发布阶段 │ ├── ci-cd-and-automation/ # 发布阶段 │ ├── deprecation-and-migration/ # 发布阶段 │ ├── documentation-and-adrs/ # 发布阶段 │ ├── observability-and-instrumentation/ # 发布阶段 │ ├── shipping-and-launch/ # 发布阶段 │ └── using-agent-skills/ # 元技能如何使用此包 ├── agents/ # 4个专业代理角色 ├── references/ # 7个补充检查清单 ├── hooks/ # 会话生命周期钩子 ├── commands/ # 8个斜杠命令 └── docs/ # 各工具设置指南参考检查清单快速参考材料技能在需要时自动调用参考文档覆盖内容完成定义项目范围的完成标准与每项任务的验收标准对比测试模式测试结构、命名、模拟、React/API/E2E示例、反模式安全检查清单提交前检查、认证、输入验证、头部、CORS、OWASP Top 10性能检查清单Core Web Vitals目标、前端/后端检查清单、测量命令无障碍检查清单键盘导航、屏幕阅读器、视觉设计、ARIA、测试工具可观测性检查清单值班问题、结构化日志、RED/USE指标、追踪、基于症状的告警、发布前门禁开始你的技能之旅Agent Skills为AI编码代理和开发者提供了一套完整的开发流程支持帮助构建高质量的软件系统。通过掌握这些核心技能你可以显著提高开发效率改善代码质量并更好地应对复杂项目的挑战。建议从定义阶段开始逐步引入更多技能到你的工作流中。每个技能都是独立的你可以根据项目需求选择性地采用。记住关键在于建立系统化的思维模式和工作习惯而不是简单地复制流程。现在就开始探索Agent Skills将生产级工程实践融入你的开发工作中吧【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
