全仓库工件文件名与状态词汇的单点定义。新增命名先改本表,再使用。 代码面唯一出处:src/constants.ts;本文件是仓库工件清单的注册视图。
| 状态 | 语义 | 禁止别名 |
|---|---|---|
| not_started | 未开始 | 如 todo/new 等 |
| in_progress | 进行中(全局最多一个,WIP=1) | 如 active/doing |
| blocked | 阻塞(必须附 blocked_reason 与解除条件) | 如 stuck |
| passing | 仅由验证门置位(验证通过 + 证据落盘) | 如 pass/done/complete(AP-07) |
| 工件 | 规范名 | 允许别名 |
|---|---|---|
| 入口指令文件 | AGENTS.md | CLAUDE.md / agents.md |
| 特性清单 | feature_list.json | feature-list.json / features.json |
| 进度日志 | PROGRESS.md | progress.md / claude-progress.md |
| 决策日志 | DECISIONS.md | docs/decisions/ |
| 交接文档 | session-handoff.md | — |
| 验证入口 | scripts/check.sh | make check / CI 等价物 |
| 清洁清单 | clean-state-checklist.md | clean-state-check |
| 评估准则 | evaluator-rubric.md | — |
| 架构规则 | .harness/arch-rules.json | check-arch |
| 命名注册表 | naming-registry.md | — |
- 新增工件名/状态词:先改 src/constants.ts(代码面唯一出处),再同步本表。
- 指令、清单、脚本、CI 一律引用规范名;别名仅限兼容遗留且须在本表声明(§14.1)。
- 状态词禁止第二套(AP-07);文件名禁止多处异名引用(AP-08)。
| 命名 | 语义 | 备注 |
|---|---|---|
| ctx.features | 状态机服务:create/update/transition/verify + CAS 修订号 | 仿 harness goal/goal 模式 |
| feature/change | 状态变更会话事件(声明 ignorable: true) |
兼容 harness known-event-types 读路径 |
| get_feature / update_feature / verify_feature | 三工具(替代手改 feature_list.json) | verify 跑 verification 步骤成功才提交 |
| feature_dashboard | 模型可见状态视图(C-3a:计数/WIP/证据摘要/投影一致性) | 只读;GUI 看板暂缓(D-018) |
| corrupt | 严格 fold 的判定结果(WIP=1 违约 / passing 无证据 / 非法跳转) | 不是状态词(状态词表 §3.3 不变) |
| 导出投影 | feature_list.json 作为会话日志的导出视图(方案甲真源) | 会话日志为真源,文件为投影 |