当前权威事实源注册表¶
状态:
active。表中的文件名是当前事实 Owner;其最初引入版本不决定当前适用范围。
1. 原则¶
同一事实只允许一个权威 Owner。其他文件可以引用或生成投影,但不能成为第二个可覆盖版本。
| 事实 | 唯一 Owner | 允许的投影 |
|---|---|---|
| 包版本、Skill、Reviewer 目录 | manifest.json |
README、Skill Matrix、校验报告 |
| 模型组合、代理单位、评分与根预算上限 | runtime/cp_runtime/data/dispatch-policy-v3.json;旧任务保留各自固定的 v1/v2 策略 |
manifest、模型策略文档与校验报告 |
| 项目身份和稳定边界 | project-profile.json |
Onboarding 报告、任务信封引用 |
| 项目当前阶段和基线 | project-state.json |
状态摘要 |
| 任务阶段、门禁、Evidence、动作 | execution-state.json |
Finalization Report、Handoff |
| Reviewer 轮次、Finding 与复审状态 | review-state.json |
Review Ledger |
| 根任务统一预算、permit 与预占 | 仓库外 DelegationBudget V3 账本;V2 保留冻结续写;scripts/delegation-budget.py 管理 |
任务信封引用、成本摘要 |
| Hook 注册入口 | 基础 hooks/hooks.json;增强 scripts/package_manager.py::hook_fragment |
配置指南、架构说明 |
| 工作区能力定位与覆盖 | Profile 同级 capability-index/<worktree_id>;CapabilityStore 管理 |
query 结果、任务决策引用 |
| 项目门禁启用与绑定 | 账户外部 capability-gates/<worktree_id>.json;GatePolicy 管理 |
status 读回 |
| 旧门禁任务与当前回执 | Profile 同级 capability-gate/<worktree_id>;GateTask/Workflow 管理 |
prepare/finish/check 结果;仅为 schema 1 旧状态事实,不授予 Operation v2 写入权限 |
| Operation v2 写前与结果回执 | Profile 同级 capability-operation/<worktree_id>;Hook 创建起点并绑定真实 A/B,CLI 只消费引用 |
只约束显式启用策略下的规范 apply_patch;不授予 Git、发布、部署或业务写权限 |
| Review 冻结输入 | Review Packet manifest.json |
Packet Summary |
| 当前任务恢复 | CURRENT_TASK.md + PROGRESS.md |
Recovery Summary |
| 项目长期事实 | project-memory.md |
项目文档引用 |
| 跨项目经验候选 | Knowledge Candidate JSON | 人工评估报告 |
2. 状态冲突处理¶
- 机器状态与 Markdown 冲突:优先机器状态,并记录冲突;
- 项目文档与实际 Git/运行结果冲突:优先当前可验证事实;
- Checkpoint 与 Project Memory 冲突:Checkpoint 只说明任务当时状态,不能覆盖已审核项目事实;
- Knowledge Candidate 与当前项目事实冲突:候选只作为输入,不能自动应用;
- Approval 与 Evidence 冲突:两者职责不同,不能互相替代。
3. 文档状态¶
建议文档显式标记:
active:当前适用规范;reference:按需读取资料;historical:仅用于追溯;generated:由机器状态生成,可重新生成。
历史文档不得覆盖 Active 规则,Generated 文档不得被当作独立事实源手工维护。
机器事实来源引用¶
- repository-external DelegationBudget V3 JSONL via delegation-budget.py; frozen V2 continuation
- review-state.json via review_controller.py