Harden task board and specs for weaker coding agents

- 06-tasks: add per-task detail sheets for Phase 0/1 (concrete init
  commands, BLOCKED preconditions, verification commands with expected
  results) and a constraint/verification quick table for Phase 2/3;
  replace subjective acceptance wording with checkable items
- 04-architecture: promote 3.4 to an authoritative filter-param
  contract (names, values, AND combination, invalid-value handling);
  add required/optional/default field annex with 0-5 validators to
  3.3; state AiCodingScore is not a model in MVP; record structure
  decision (keep wagtail-start home/search apps, business models in
  new core app, no Dockerfile)
- 03-tech-stack: add version-pinning policy row for T-001
- routes/02-requirements: point filter wording back to the 3.4
  contract instead of maintaining copies
- T-104: human-input boundary - seed projects, scores and verdicts
  must be user-confirmed; BLOCKED without a confirmed list
- current-state snapshot updated; maintenance record appended to
  progress.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
ila
2026-07-06 16:11:54 +08:00
co-authored by Claude Fable 5
parent d98bfb7531
commit 678d081124
7 changed files with 147 additions and 21 deletions
+15
View File
@@ -65,3 +65,18 @@
- 决策:`deploy/` 整目录不入库,部署凭证只保留在本机;行尾规范定为 LF(与 WSL2/Linux 标准开发环境一致)。
- 下一步:T-001 初始化 Wagtail 项目骨架。
## 2026-07-06 任务看板加固(面向执行能力较弱的模型)
- 状态:DONE
- 变更:
- `docs/06-tasks.md`:新增「任务详单」一节。Phase 0/1 每任务给出实现指引、前置检查和带预期结果的验证命令(T-001 含 `wagtail start` 逐步命令和 BLOCKED 条件);Phase 2/3 给出关键实现约束与验证速查表。表格中的主观验收措辞("字段校验合理""移动端不溢出"等)替换为可勾选项。
- `docs/04-architecture.md`:§3.4 升级为筛选参数契约表(唯一权威:`language`/`framework`/`database`/`min_score`/`q`/`page`,单值、AND 组合、非法值处理规则);§3.3 表下新增必填/可空/默认附注和评分校验器要求;§3.2 明确 `AiCodingScore` MVP 不建模型;§一/§六记录结构决策:保留 `wagtail start` 生成的 `home`/`search` app,业务模型集中在新建 `core` app,测试放各 app `tests.py`,删除生成的 Dockerfile。
- `docs/03-tech-stack.md`:新增版本钉死策略行(T-001 时按 pip 实装稳定版 pin `wagtail==X.Y.Z` 并回写)。
- `docs/routes.md`、`docs/02-requirements.md`:筛选相关表述指回 §3.4 契约,不再各自维护。
- `docs/current-state.md`:快照与目录要点同步上述结构决策。
- T-104 明确人工输入边界:候选项目、评分、评语必须经用户确认,无清单时标 BLOCKED,禁止模型编造。
- 验证:`grep` 检查 §3.4 引用一致(routes、requirements、06-tasks 均指向 04-architecture);人工核对任务详单命令与 03-tech-stack §三目标命令形态一致。
- 阻塞:无。
- 决策:筛选参数契约以 `04-architecture.md` §3.4 为唯一权威;`home`/`search` app 保留不改名;`AiCodingScore` 不建模型;种子内容评分必须人工确认。
- 下一步:T-001 初始化 Wagtail 项目骨架(详单已可直接照做)。