implement

name	implement
description	通过处理并执行 tasks.md 中定义的所有任务来执行实现计划
disable-model-invocation	true
allowed-tools	["Bash(node */check-prerequisites.mjs*)"]

用户输入

$ARGUMENTS

你必须在继续之前考虑用户输入（如果不为空）。

大纲

1. 从仓库根目录运行 node ${WAVE_PLUGIN_ROOT}/scripts/check-prerequisites.mjs --json --require-tasks --include-tasks 并解析 FEATURE_DIR 和 AVAILABLE_DOCS 列表。所有路径必须是绝对路径。对于参数中的单引号如 "I'm Groot"，使用转义语法：例如 'I'''m Groot'（或尽可能使用双引号："I'm Groot"）。

2. 检查检查清单状态（如果 FEATURE_DIR/checklists/ 存在）：

   • 扫描 checklists/ 目录中的所有检查清单文件

   • 对于每个检查清单，统计：

     • 总项目数：所有匹配 - [ ] 或 - [X] 或 - [x] 的行
     • 已完成项目：匹配 - [X] 或 - [x] 的行
     • 未完成项目：匹配 - [ ] 的行

   • 创建状态表：

     | 检查清单 | 总数 | 已完成 | 未完成 | 状态 |
     |----------|------|--------|--------|------|
     | ux.md    | 12   | 12     | 0      | ✓ 通过 |
     | test.md  | 8    | 5      | 3      | ✗ 失败 |
     | security.md | 6 | 6      | 0      | ✓ 通过 |
     

   • 计算总体状态：

     • 通过：所有检查清单有 0 个未完成项目
     • 失败：一个或多个检查清单有未完成项目

   • 如果有任何检查清单未完成：

     • 显示带未完成项目计数的表格
     • 停止并询问："某些检查清单未完成。你仍要继续实现吗？（是/否）"
     • 等待用户响应后再继续
     • 如果用户说"否"或"等待"或"停止"，暂停执行
     • 如果用户说"是"或"继续"，继续步骤 3

   • 如果所有检查清单完成：

     • 显示所有检查清单通过的表格
     • 自动继续步骤 3

3. 加载并分析实现上下文：

   • 必需：读取 tasks.md 获取完整任务列表和执行计划
   • 必需：读取 plan.md 获取技术栈、架构和文件结构
   • 如存在：读取 data-model.md 获取实体和关系
   • 如存在：读取 contracts/ 获取 API 规格和测试需求
   • 如存在：读取 research.md 获取技术决策和约束
   • 如存在：读取 quickstart.md 获取集成场景

4. 项目设置验证：

   • 必需：根据实际项目设置创建/验证忽略文件：

   检测与创建逻辑：

   • 检查以下命令是否成功以确定仓库是否为 git 仓库（如果是则创建/验证 .gitignore）：

     git rev-parse --git-dir 2>/dev/null
     

   • 检查 Dockerfile* 是否存在或 plan.md 中有 Docker → 创建/验证 .dockerignore

   • 检查 .eslintrc* 或 eslint.config.* 是否存在 → 创建/验证 .eslintignore

   • 检查 .prettierrc* 是否存在 → 创建/验证 .prettierignore

   • 检查 .npmrc 或 package.json 是否存在 → 创建/验证 .npmignore（如发布）

   • 检查 terraform 文件 (*.tf) 是否存在 → 创建/验证 .terraformignore

   • 检查是否需要 .helmignore（存在 helm charts）→ 创建/验证 .helmignore

   如果忽略文件已存在：验证它包含必要模式，仅追加缺失的关键模式 如果忽略文件缺失：使用检测到的技术的完整模式集创建

   按技术的常见模式（来自 plan.md 技术栈）：

   • Node.js/JavaScript：node_modules/、dist/、build/、*.log、.env*
   • Python：__pycache__/、*.pyc、.venv/、venv/、dist/、*.egg-info/
   • Java：target/、*.class、*.jar、.gradle/、build/
   • C#/.NET：bin/、obj/、*.user、*.suo、packages/
   • Go：*.exe、*.test、vendor/、*.out
   • Ruby：.bundle/、log/、tmp/、*.gem、vendor/bundle/
   • PHP：vendor/、*.log、*.cache、*.env
   • Rust：target/、debug/、release/、*.rs.bk、*.rlib、*.prof*、.idea/、*.log、.env*
   • Kotlin：build/、out/、.gradle/、.idea/、*.class、*.jar、*.iml、*.log、.env*
   • C++：build/、bin/、obj/、out/、*.o、*.so、*.a、*.exe、*.dll、.idea/、*.log、.env*
   • C：build/、bin/、obj/、out/、*.o、*.a、*.so、*.exe、Makefile、config.log、.idea/、*.log、.env*
   • 通用：.DS_Store、Thumbs.db、*.tmp、*.swp、.vscode/、.idea/

   工具特定模式：

   • Docker：node_modules/、.git/、Dockerfile*、.dockerignore、*.log*、.env*、coverage/
   • ESLint：node_modules/、dist/、build/、coverage/、*.min.js
   • Prettier：node_modules/、dist/、build/、coverage/、package-lock.json、yarn.lock、pnpm-lock.yaml
   • Terraform：.terraform/、*.tfstate*、*.tfvars、.terraform.lock.hcl

5. 解析 tasks.md 结构并提取：

   • 任务阶段：设置、测试、核心、集成、完善
   • 任务依赖：顺序与并行执行规则
   • 任务详情：ID、描述、文件路径、并行标记 [P]
   • 执行流程：顺序和依赖要求

6. 按任务计划执行实现：

   • 逐阶段执行：完成每个阶段后再进入下一个
   • 遵守依赖：按顺序运行顺序任务，并行任务 [P] 可一起运行
   • 遵循 TDD 方法：在对应实现任务之前执行测试任务
   • 基于文件的协调：影响相同文件的任务必须顺序运行
   • 验证检查点：在继续之前验证每个阶段完成

7. 实现执行规则：

   • 必须使用任务子代理（如 general-purpose 代理）来实现任务以减少主代理的上下文成本
   • 提示设计：保持子代理提示简洁——引用 tasks.md 文件路径和具体任务 ID/行号。不要将完整任务描述复制到提示中；让子代理直接读取 tasks.md。
   • 设置优先：初始化项目结构、依赖、配置
   • 测试先于代码：如果需要为契约、实体和集成场景编写测试
   • 核心开发：实现模型、服务、CLI 命令、端点
   • 集成工作：数据库连接、中间件、日志、外部服务
   • 完善和验证：单元测试、性能优化、文档

8. 进度跟踪和错误处理：

   • 在每个完成的任务后报告进度
   • 如果任何非并行任务失败则暂停执行
   • 对于并行任务 [P]，继续成功的任务，报告失败的任务
   • 提供带调试上下文的清晰错误消息
   • 如果实现无法继续建议下一步
   • 重要 对于完成的任务，确保在任务文件中将任务标记为 [X]。

9. 完成验证：

   • 验证所有必需任务已完成
   • 检查实现的功能与原始规格匹配
   • 验证测试通过且覆盖率满足要求
   • 确认实现遵循技术计划
   • 报告最终状态和完成工作摘要

注意：此命令假设 tasks.md 中存在完整的任务分解。如果任务不完整或缺失，建议先运行 /tasks 重新生成任务列表。