code-implementation

代码实现与测试技能

参数规范

参数	说明	要求
item_id	已存在的 feature 或 fix ID	必需
--plan	直接提供完整修改方案（可选）	可选，不提供则从 memory_mcp 查询

参数规则:

• 无参数时：拒绝执行
• 仅提供 item_id：从 item_id 记录的 content 和关联 item 中获取完整修改方案
• 提供 --plan：使用用户提供的方案，跳过 memory_mcp 查询

---

前置条件

必需前置条件

• item_id 必须存在（features 或 fixes 分组）
• 必须存在以下之一：
  • 方式1（推荐）: item_id 记录的 content 或关联 item 中包含完整修改方案
  • 方式2: 用户通过 --plan 参数或交互式输入提供完整修改方案

Git 分支要求

• 当前分支不能是 main 或 master
• 分支必须是干净的（无未提交的更改）
• 如果不满足，技能将拒绝执行并提示用户

完整修改方案格式要求

# <item_id> 实现方案

## 需求/问题描述
[完整的需求或 bug 描述]

## 代码修改计划
### 修改的文件列表
- `path/to/file1.ts`: 修改说明
- `path/to/file2.ts`: 修改说明

### 具体修改内容
[详细的代码修改方案，包括函数签名、逻辑变更等]

## 测试计划
### 单元测试
- [ ] 测试场景1: 描述
- [ ] 测试场景2: 描述

### 整合测试
- [ ] 测试场景1: 描述

---

⚠️ 重要指令

DO NOT ENTER PLAN MODE - 此技能要求直接执行实现方案，不进入计划模式

使用子代理处理 memory_mcp 和文件操作 - 以下操作通过 Agent 工具执行，减少主窗口上下文污染：

• 所有 mcp__memory_mcp__* 工具调用
• 所有文件操作：Read、Edit、Write、Glob、Grep

循环计数 - 所有循环重试最多3次，超限后暂停并请求用户介入

提醒用户使用 auto 模式 - 技能开始时提醒用户可使用 auto 模式提高效率

---

初始化阶段

步骤 1: 参数验证与方案获取

1. 验证 item_id 并获取记录

   • 使用子代理查询 memory_mcp，获取 item_id 的完整记录（features 或 fixes 分组）
   • 如果不存在，拒绝执行并提示

2. 获取完整修改方案（按优先级尝试）

   方式1: 从 item_id 记录的 content 中获取

   • 检查 item_id 的 content 字段是否包含完整的修改方案
   • 如果包含，验证方案格式是否完整（包含代码修改计划和测试计划）

   方式2: 从关联 item 中获取

   • 如果 content 中没有完整方案，检查 related 字段
   • 遍历关联的 item_id，查询其 content
   • 查找包含完整修改方案的关联 item
   • 如果找到，使用该方案

   方式3: 使用用户提供的方案

   • 如果以上方式均未找到，检查是否提供了 --plan 参数
   • 使用用户提供的方案，验证格式完整性

3. 方案获取失败处理

   • 如果所有方式都无法获取完整修改方案，拒绝执行并提示：

     错误: 无法获取完整修改方案
     请确保以下之一:
       1. item_id 的 content 包含完整修改方案
       2. 关联 item 的 content 包含完整修改方案
       3. 使用 --plan 参数提供方案
     

步骤 2: Git 分支检查

1. 检查当前分支

   git branch --show-current
   

   • 如果是 main 或 master，拒绝执行并提示：

     错误: 当前在 main/master 分支上
     请先创建并切换到开发分支，例如：
       git checkout -b feature/<item_id>
       git checkout -b fix/<item_id>