executelisted

# Execute Skill ## 目标 按 tasks.md 中的顺序逐任务实现代码变更。 每完成一个 task 就更新状态并触发增量验证。 ## 执行模式 ### Micro Mode（无 tasks.md） 直接根据用户请求实现变更： 1. 分析���求 2. 确定要修改的文件 3. 实现变更 4. 直接进入 verify ### Standard/Full Mode（有 tasks.md） 按波次（Wave）执行： 1. 读取 tasks.md 2. 找到当前 Wave 中未完成的 task 3. 逐 task 执行 4. 每完成一个 task： - 更新 tasks.md 中的 checkbox - 运行该 task 的 verify 条件 - 如果验证通过 → 标记 ✓，继续下一个 - 如果验证失败 → 进入 debug 循环 ## 执行规则 ### 代码编写原则 1. **最小变更原则**：只修改完成当前 task 所需的代码 2. **不超前实现**：不提前实现后续 task 的内容 3. **保持可编译**：每个 task 完成后项目必须可编译 4. **遵循项目风格**：参考现有代码的命名、结构、格式 5. **引用已知问题**：检查 known-issues.md 避免已知坑 6. **文档代码同步**：代码变更必须同步更新对应文档（见下方规则） 7. **测试先行**：计划要求时，先运行并记录失败测试，再实现最小修复直至通过 8. **业务验收同步**：若 tasks.md 包含 `Business Acceptance`，每个适用维度都必须补充可复查证据；不能以“代码已完成”替代权限、流程、数据、审计或集成验证 ### 文档-代码同步规则 **核心原则：代码是实现，文档是契约。两者必须始终一致，不允许出现"代码改了但文档没跟上"的情况。** 每完成一个 task，必须检查并同步以下文档： | 变更类型 | 必须同步的文档 | |----------|---------------| | 新增/修改 API 接口 | `specs/active/{slug}/api.md`（接口签名、参数、返回值） | | 新增/修改数据模型 | `specs/active/{slug}/data-model.md`（字段、类型、约束） | | 新增/修改页面/组件 | `specs/active/{slug}/pages.md`（页面清单、路由、组件职责） | | 修改业务流程/逻辑 | `specs/active/{slug}/flow.md`（流程步骤、条件分支、状态流转） | | 修改配置/环境变量 | `specs/active/{slug}/config.md`（配置项、默认值、说明） | | 修改数据库结构 | `specs/active/{slug}/migration.md`（DDL、迁移步骤、回滚方式） | **同步时机：** 在 task 的增量验证之前完成文档更新，确保文档和代码在同一个 task 内保持一致。 **同步格式：** ```markdown ## {模块名} — {功能描述} ### 接口/组件/模型 {签名、参数、返回值等技术契约} ### 行为说明 {业务逻辑、边界条件、异常处理} ### 变更记录 | 日期 | Task | 变更内容 | |------|------|---------| | {date} | Task N