Agent Skills
返回列表
💻

代码落地实现

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/implement。

技能介绍

解决的问题

工程师拿到规格文档或工单后,往往面临一个困境:从理解需求到写出可工作的代码,中间存在巨大的实现鸿沟。需求文档描述的是"要做什么",而代码需要精确到每一行实现。更棘手的是,在实现过程中如果没有测试驱动,很容易写出无法验证的代码,最终导致回归问题和返工。

工作方式

这个技能采用严格的 TDD 工作流,在预先约定的接缝上先写测试再写实现。具体步骤包括:

  • 根据工单或规格描述实现功能
  • 在定义好的接口边界上先写失败的测试
  • 实现代码让测试通过
  • 定期运行类型检查和单个测试文件
  • 最后运行完整测试套件确保没有破坏其他功能
  • 完成双轴评审(规范符合度 + 规格实现度)
  • 提交代码到当前分支

输出是一个结构化的 ImplementationResult 工件,包含规格引用、提交哈希、测试状态和评审引用。

适用边界与注意点

这个技能专注于代码实现本身,不负责需求规划(由 to-spec 或 to-tickets 处理)和大规模重构(由 code-review 处理)。使用时需要预先明确测试接缝,即需要测试的关键接口和边界条件。如果接缝定义不清晰,TDD 的效果会大打折扣。

使用场景

  • 已有详细的PRD文档,需要将产品需求转化为可运行的功能代码并确保测试覆盖。
  • 团队使用Jira管理工单,要求按TDD方式在约定接口上实现每个Sprint的Story。
  • 接手遗留项目需要补充缺失的测试用例,同时实现新需求并保持所有测试通过。
  • 代码需要通过CI流水线的类型检查和测试套件,在提交前完成双轴代码评审。

适合人员

  • 后端工程师,需要将API设计文档转化为可测试的Go或Python代码实现
  • 技术Leader,要求团队成员按TDD规范提交代码并通过自动化评审流程
  • 全栈开发者,在敏捷团队中需要快速将Jira Story转化为可部署的功能代码
  • 技术负责人,需要在代码合并前确保实现严格符合规格且测试全部通过