easy-coding-harness 0.5.3 → 0.6.1

package/templates/runtime/templates/dev-spec-skeleton.md

@@ -1,80 +1,75 @@
-[阶段：ANALYSIS]
-
-## 技术方案：{任务标题}
+## 技术方案：[[EC_TODO:任务标题]]
 
 ### 项目模式
-{初创项目/迭代项目}
+[[EC_TODO:初创项目/迭代项目]]
 
 ### 任务类型
-{新功能 / Bug 修复 / 重构 / 性能优化 / 前端设计实现}
+[[EC_TODO:新功能 / Bug 修复 / 重构 / 性能优化 / 前端设计实现]]
 
 ### 需求解析
-- **目标**：{待填写 — 真正要解决的问题}
-- **输入**：{待填写 — 用户输入 / 系统输入 / 触发条件}
-- **输出**：{待填写 — 先声明交付形态（改代码 / 出文档），再写最终交付结果。交付形态须忠于用户原始需求，不得擅自降级}
-- **边界**：{待填写 — 明确不做什么}
+- **目标**：[[EC_TODO:真正要解决的问题]]
+- **输入**：[[EC_TODO:用户输入 / 系统输入 / 触发条件]]
+- **输出**：[[EC_TODO:先声明交付形态（改代码 / 出文档），再写最终交付结果。交付形态须忠于用户原始需求，不得擅自降级]]
+- **边界**：[[EC_TODO:明确不做什么]]
 
 ### 现状
-- **相关代码 / 页面 / 接口 / 模块**：{待填写 — 基于实际文件与代码的现状说明}
-- **当前实现方式**：{待填写 — 现在是如何工作的}
-- **现有问题 / 缺口**：{待填写 — 为什么需要改}
-- **证据**：{待填写 — 引用的关键文件、类、页面、接口，含 file:line}
+- **相关代码 / 页面 / 接口 / 模块**：[[EC_TODO:基于实际文件与代码的现状说明]]
+- **当前实现方式**：[[EC_TODO:现在是如何工作的]]
+- **现有问题 / 缺口**：[[EC_TODO:为什么需要改]]
+- **证据**：[[EC_TODO:引用的关键文件、类、页面、接口，含 file:line]]
 
 ### 冲突摘要
-- 需求 vs RULES：{待填写 或 "无冲突"}
-- 需求 vs ABSTRACT：{待填写 或 "无冲突"}
-- 需求 vs 现有代码：{待填写 或 "无冲突"}
-- Dev-Spec vs 现有代码：{待填写 或 "无冲突"}
-
-### 待用户决策
-- {待填写 — 影响技术路线、接口、改动范围的问题逐条列出；任何"本次不做全部 / 分批落地 / 范围或交付形态收窄"必须列入此处交由用户拍板，不得自行决定并假托既定；若无则写"无"}
+- 需求 vs RULES：[[EC_TODO:填写结果或“无冲突”]]
+- 需求 vs ABSTRACT：[[EC_TODO:填写结果或“无冲突”]]
+- 需求 vs 现有代码：[[EC_TODO:填写结果或“无冲突”]]
+- Dev-Spec vs 现有代码：[[EC_TODO:填写结果或“无冲突”]]
 
 ### 影响面分析
-- **涉及模块**：{待填写}
-- **核心类 / 页面 / 接口**：{待填写}
-- **数据库变更**：{有/无}
-- **接口变更**：{有/无}
-- **关联历史任务**：{待填写 — 相关短期记忆序号；无则"无"}
+- **涉及模块**：[[EC_TODO:涉及模块]]
+- **核心类 / 页面 / 接口**：[[EC_TODO:核心类 / 页面 / 接口]]
+- **数据库变更**：[[EC_TODO:有/无]]
+- **接口变更**：[[EC_TODO:有/无]]
+- **关联历史任务**：[[EC_TODO:相关短期记忆序号；无则“无”]]
 
 ### 改动范围
 > 只列真实项目源码/配置文件的改动。禁止把 `.easy-coding/` 下的 harness 产物（dev-spec / execution.jsonl / test-strategy / 记忆 / 报告等）当作改动对象。本表为空仅允许用于"用户明确要求的无代码交付形态"；代码类任务（重构/修复/功能）若此表为空，即为自我降级。
 
 | 改动文件 | 改动类型 | 文件编码 | 改动核心内容 |
 |----------|---------|---------|-------------|
-| `{文件路径}` | 新增 | 项目编码 {X}，依据：{xxx} | {核心改动} |
-| `{文件路径}` | 修改 | 保持原编码 {X} | {核心改动} |
-| `{文件路径}` | 删除 | — | {删除原因} |
+| `[[EC_TODO:文件路径]]` | 新增 | 项目编码 [[EC_TODO:编码]]，依据：[[EC_TODO:编码依据]] | [[EC_TODO:核心改动]] |
+| `[[EC_TODO:文件路径]]` | 修改 | 保持原编码 [[EC_TODO:编码]] | [[EC_TODO:核心改动]] |
+| `[[EC_TODO:文件路径]]` | 删除 | — | [[EC_TODO:删除原因]] |
 
 ### 修改方案
-- **总体改法**：{待填写 — 一句话说清改哪里、怎么改}
-- **后端改动**：{待填写；不涉及则写"不涉及"}
-- **前端改动**：{待填写；不涉及则写"不涉及"}
-- **兼容处理**：{待填写 — 旧逻辑如何迁移、保留或替换}
-- **风险点**：{待填写 — 最容易出问题的位置}
+- **总体改法**：[[EC_TODO:一句话说清改哪里、怎么改]]
+- **后端改动**：[[EC_TODO:填写改动；不涉及则写“不涉及”]]
+- **前端改动**：[[EC_TODO:填写改动；不涉及则写“不涉及”]]
+- **兼容处理**：[[EC_TODO:旧逻辑如何迁移、保留或替换]]
+- **风险点**：[[EC_TODO:最容易出问题的位置]]
 
 ### 实施拆解
 
 | 单元 | 说明 | 类型 | 涉及文件 | 依赖 |
 |------|------|------|---------|------|
-| U1 | {title} | {backend/frontend/test/...} | {files} | — |
-| U2 | {title} | {type} | {files} | — |
-| U3 | {title} | {type} | {files} | U1, U2 |
+| U1 | [[EC_TODO:单元标题]] | [[EC_TODO:backend/frontend/test/...]] | [[EC_TODO:涉及文件]] | — |
+| U2 | [[EC_TODO:单元标题]] | [[EC_TODO:单元类型]] | [[EC_TODO:涉及文件]] | — |
+| U3 | [[EC_TODO:单元标题]] | [[EC_TODO:单元类型]] | [[EC_TODO:涉及文件]] | U1, U2 |
 
-**执行策略**：{parallel / sequential / single}
-- 第一批（并行）：U1 {title} ｜ U2 {title}
-- 第二批（等待第一批）：U3 {title}
-（若 single：单一实施单元，主 agent 直接执行）
+**执行策略**：[[EC_TODO:parallel / sequential / single]]
+- 第一批（并行）：U1 [[EC_TODO:单元标题]] ｜ U2 [[EC_TODO:单元标题]]
+- 第二批（等待第一批）：U3 [[EC_TODO:单元标题]]
+（若 single：单一实施单元，派发 1 个子代理执行）
 
 ### 测试策略
 
 | 测试点 | 级别 | 归属单元 | 方式 | 验证命令 |
 |--------|------|---------|------|---------|
-| {描述} | 必测 | U1 | 单测 | `npm test -- --filter=xxx` |
-| {描述} | 应测 | U2 | 快照 | `npm test -- --snapshot` |
+| [[EC_TODO:测试点描述]] | 必测 | U1 | 单测 | `npm test -- --filter=xxx` |
+| [[EC_TODO:测试点描述]] | 应测 | U2 | 快照 | `npm test -- --snapshot` |
 
-- **人工验收**：{待填写 — 用户需要检查的关键行为}
-- **无法验证项**：{待填写 — 无 / 说明缺失环境、数据或权限}
+- **人工验收**：[[EC_TODO:用户需要检查的关键行为]]
+- **无法验证项**：[[EC_TODO:无 / 说明缺失环境、数据或权限]]
 
 ### 风险与注意事项
-- {风险 1}
-- {风险 2}
+- [[EC_TODO:风险 1]]
+- [[EC_TODO:风险 2]]