codinglisted

# 编码实现 > 按变更提案编码。MUST 按 tasks.md 逐项完成 + 写单测。 ## 前置条件（MUST 全部满足） 1. **变更提案存在**：`changes/proposals/<current>/proposal.md` 存在 2. **任务清单存在**：`changes/proposals/<current>/tasks.md` 有未完成任务 3. **分支正确**：当前分支匹配 `^(feat|fix|hotfix)-*` 任一不满足 → MUST 停止并提示： - 无提案 → 调用 `requirement-analysis` 技能 - 分支错误 → 切到 `feat-*` / `fix-*` 分支 ## 执行步骤 ### 第 0 步：判断目录类型（如涉及"新建目录/子目录/特性"）⭐ 如果用户请求中涉及"新建目录/子目录/特性/模块"，MUST 先判断目录类型： | 用户表达 | 目录类型 | 行动 | |---|---|---| | "新建包 / 子包 / package" | 包目录 | 按 Java 包规范创建（影响 package 语句） | | "新建特性 / feature / 业务模块" | 特性目录 | 调用 `create-feature` 技能（跨层组织） | | "新建文档/脚本/示例目录" | 非代码目录 | 创建独立目录（docs/scripts/examples） | | "新建子目录"（未明确） | **MUST 询问** | 让用户确认类型 | **禁止**： - ❌ MUST NOT 把"子目录"默认按"子包"处理 - ❌ MUST NOT 在 `src/main/java/` 下创建非代码目录 详见 `common-project-structure` 规则的"目录类型识别"章节。 ### 第 1 步：读变更提案 ```bash cat changes/proposals/<current>/proposal.md cat changes/proposals/<current>/tasks.md # 复杂变更： cat changes/proposals/<current>/design.md ``` ### 第 2 步：读相关 Wiki（TODO 阶段 3 填充栈级引用） MUST Read： - `wiki/_common/naming.md` - `wiki/_common/architecture.md` - `wiki/<stack>/developer.md` ### 第 3 步：按 tasks.md 逐项实现 对每一项未完成任务： 1. 读任务描述 2. 写代码（遵守所有相关 rules 约束） 3. 写对应单测（MUST 与代码同步完成） 4. 本地验证：编译通过 + 相关单测通过 5. 勾选任务：在 tasks.md 中将 `- [ ]` 改为 `- [x]` **关键约束**： - MUST 完成一项再做下一项 - MUST 代码 + 单测同步完成 - 遇到 proposal 未覆盖的边界 → MUST 回到 `requirement-analysis` 补充 proposal ### 第 4 步：全部完成后的本地验证（TODO 阶段 3 填充栈级命令） ### 第 5 步：自评 - 代码是否实现 proposal 所��目标？ - 是否触碰了非目标范围？ - 是否有 proposal 未预见的问题？ ## 产出物 - 源