用途:implementation-plan 是一套面向复杂工程改动的实施规划技能。它针对直接在代码上做大型架构重构容易导致构建损坏、遗漏边界情况、范围蔓延和不可逆 git 混乱的问题,主张在编码前先产出工程蓝图,把长任务拆成有序、小粒度、带可验证检查点的步骤,使工作可随时暂停、审阅和恢复。
主要能力:
- 依赖排序:按核心数据模型/数据库迁移、内部服务/业务逻辑、API 端点/控制器、前端界面/消费方集成的顺序排列组件,保证依赖先于被依赖项创建。
- 范围控制:明确列出本轮不构建的内容(显式非目标),防止范围蔓延。
- 原子阶段拆分:遵循 30 分钟任务规则,把工作拆成实现与验证均不超过约 30 分钟的离散任务。
- 验证检查点:每个任务都附带明确的验证步骤,例如运行指定测试文件并预期通过数、或用 curl 请求健康检查端点预期返回 200。
- TDD 集成:指定在写实现代码前先编写的自动化测试文件,定义预期失败(红)与通过标准(绿)。
- 回滚与风险缓解:对数据库结构和 API 变更采用扩展-收缩(并行运行)模式,分三阶段:扩展(新增字段/端点,新旧并存)、迁移(流量切到新字段/端点)、收缩(弃用并移除旧字段/端点)。
使用方式:以 IMPLEMENTATION-PLAN.md 模板组织文档,包含概述与架构目标、待决问题与设计决策、有序实施阶段(每个任务列出涉及文件与验证命令)、验证计划(自动化测试、lint 与类型检查、手动验证)。资料给出的示例包括为 users 表添加 organization_id 列、编写 OrgMembershipService 单元测试与实现、暴露成员创建接口等任务。
适用场景:复杂重构、数据库迁移、API 变更、需要零停机上线的改动,以及任何需要中途交接或暂停恢复的长周期开发任务。资料给出的完整范例是把 User.name 拆分为 User.firstName 与 User.lastName 的五阶段零停机迁移。
限制:资料未提供该技能的具体安装方式、依赖平台、收费信息或运行时工具形态,暂未提供。