Add Local CCRA automation handoff context

This commit is contained in:
wantsong 2026-06-19 07:34:13 +08:00
parent e798cd2923
commit 930b9ced90
2 changed files with 257 additions and 0 deletions

View File

@ -0,0 +1,255 @@
# Codex 新会话交接文档Local CCRA 自动化讨论上下文
Date: 2026-06-19
## 1. 文档目的
本文档只提供新会话讨论 Local CCRA 后续自动化时需要的当前状态上下文。
本文档不设计自动化方案,不定义 Round 级 orchestration不提出实现路径。自动化需求由 Owner 在新会话中另行说明。
## 2. 当前仓库状态
当前项目仍处于:
```text
model_library_mvp
```
Local CCRA v0.1.2 项目侧同步基线:
```text
e798cd2 Sync local CCRA runtime 0.1.2 contract
```
截至该提交,本地 Local CCRA 运行合同、项目文档和 `knowledge_assets/` 机制说明已完成同步。
## 3. Local CCRA 当前结论
Local CCRA 已完成从规划到历史试运行验证的闭环。
当前可用版本:
```text
ccra-local-reviewer / ccra-local-review: 0.1.2
```
项目侧判断:
```text
ready_for_formal_local_first_review_with_conditions
```
含义:
- 可以作为 `the-mindscape-of-bro-tsong` 的正式本地初审使用。
- 不替代 Owner judgment。
- 不替代 Web CCRA final review。
- 不授权模型生命周期升级。
- 不自动决定下一轮工作范围。
## 4. 已完成的关键工作
已完成:
1. 建立项目侧 Local CCRA 运行区:`local_ccra_reviews/`。
2. 明确 Local CCRA 运行记录留在本项目,不建立独立 reviewer 项目。
3. 明确正交性来自真实子会话 / Agent Runtime 隔离,而不是目录隔离。
4. 完成 CCPE 初版需求、Patch 1 需求、Patch 2 需求。
5. CCPE 完成 Patch 1 后,完成 `pilot-02` 两回合历史试运行。
6. 完成 Web baseline / pilot-01 / pilot-02 三方对比。
7. CCPE 完成 Patch 2 后,本地文档已同步到 v0.1.2 运行合同。
8. `knowledge_assets/10_本地CCRA评审机制说明.md` 已更新到 v0.3,可同步到 Web CCRA / GPT knowledge side。
## 5. 试运行结果
历史试运行目录:
```text
local_ccra_reviews/round-04/pilot-01/
local_ccra_reviews/round-04/pilot-02/
```
`pilot-01` 结论:
- 证明了真实子会话、文件优先审查和本地全量证据优势。
- 主要不足是偏治理审计,弱于 Web CCRA 的早期产品诊断。
- 由此形成 CCPE Patch 1 需求。
`pilot-02` 结论:
- 真实子会话 id
```text
019edcde-24be-7593-99b2-5cf014467340
```
- `review_turn` 用时:
```text
512317 ms
```
- `planning_turn` 用时:
```text
342925 ms
```
- 成功复现 Web CCRA 对 Round 04 的关键产品诊断。
- 成功保留本地全文件证据审查优势。
- 成功验证同一子会话 `review_turn` -> `planning_turn` 的会话保持。
- 不需要第三次历史试运行,除非 CCPE 后续改变核心 reviewer 行为。
## 6. 当前 Local CCRA 运行合同
正式本地初审默认使用同一子会话两回合:
```text
review_turn -> 04_LOCAL_CCRA_REVIEW_REPORT.md
planning_turn -> next-review-requirements.md
```
每个 run 目录应在:
```text
local_ccra_reviews/<public-round>/<local-pass>/
```
核心运行文件:
```text
run-notes.md
review-metadata.json
gate-manifest.yaml
lifecycle-guard-config.yaml
agent-invocation-packet.md
prompt-to-send.md
turn-prompts/
review-context.md
review-file-manifest.json
helper-outputs/
04_LOCAL_CCRA_REVIEW_REPORT.md
next-review-requirements.md
returned-output.md
owner-decision.md
```
## 7. v0.1.2 新增必填策略
CCPE Patch 2 已把 helper/runtime hardening 纳入 v0.1.2。
未来新建 Local CCRA run 时,应在 `review-metadata.json``agent-invocation-packet.md` 中明确:
```text
bundle_audit_profile: ccra_mindscape_review_bundle | generic | not_applicable
gate_execution_mode: dry_run | run | owner_waived | not_applicable
routing_diff_policy: required | skipped_no_after_evidence | manual_equivalent_required | not_applicable
lifecycle_scan_scope: current_review_bundle | changed_files | knowledge_assets | model_library_state | whole_repo
```
`returned-output.md` 应包含短摘要,方便 Owner / 主会话快速读取,不必解析完整长报告。
## 8. 关键路径
项目侧机制说明:
```text
knowledge_assets/10_本地CCRA评审机制说明.md
local_ccra_reviews/README.md
docs/WORKFLOW.md
docs/DATA_CONTRACT.md
docs/DECISIONS.md
README.md
```
CCPE 需求与状态:
```text
requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime.md
requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime-patch1.md
requirements/ccpe/2026-06-19-ccra-local-reviewer-runtime-patch2.md
```
试运行与对比:
```text
local_ccra_reviews/round-04/pilot-01/04_LOCAL_CCRA_REVIEW_REPORT.md
local_ccra_reviews/round-04/pilot-01/05_WEB_LOCAL_CCRA_COMPARISON.md
local_ccra_reviews/round-04/pilot-02/04_LOCAL_CCRA_REVIEW_REPORT.md
local_ccra_reviews/round-04/pilot-02/next-review-requirements.md
local_ccra_reviews/round-04/pilot-02/05_WEB_LOCAL_CCRA_COMPARISON.md
local_ccra_reviews/round-04/pilot-02/run-notes.md
```
本地 CCRA 总结:
```text
reports/Codex_本地CCRA规划落地_2026-06-19.md
```
## 9. 不能误解的边界
不要把 Local CCRA 理解为:
- Web CCRA 替代品;
- Owner 决策替代品;
- 自动修复授权;
- 生命周期升级依据;
- 自动开始 Round 05 的触发器;
- 完整 Round 级自动化 runtime
- skills-vault 通用 Skill 源码目录。
下一轮工作范围仍需 Owner 与 Web CCRA 先讨论确定。
## 10. 新会话建议先读
新会话如要讨论自动化,建议先读:
1. `knowledge_assets/10_本地CCRA评审机制说明.md`
2. `local_ccra_reviews/README.md`
3. `docs/DECISIONS.md` 的 Decision 018、019、020、021
4. `reports/Codex_本地CCRA规划落地_2026-06-19.md`
5. 本文档
## 11. 当前无需重复的事
当前无需:
- 再跑第三次历史试运行;
- 重建 Local CCRA reviewer 项目;
- 把 Local CCRA Agent Spec 复制进本项目;
- 把 Local CCRA report 默认塞进 Web CCRA bundle
- 重新讨论 pilot-01 / pilot-02 的结论;
- 把 Round 04.1 closeout 当成 Round 05 scope。
## 12. 最近验证结果
最近一次本地同步后验证通过:
```powershell
python scripts\rebuild_indexes.py --check
python scripts\validate_model_library.py
git diff --cached --check
```
结果:
```text
index check passed
validation passed
staged whitespace check passed
```
## 13. 待 Owner 在新会话提供的信息
新会话需要 Owner 提供:
- 自动化目标与边界;
- 哪些步骤需要人工确认;
- Local CCRA findings 如何进入 accepted / rejected / deferred
- 何时停止 local pass
- 何时构建正式 Web CCRA bundle
- 是否允许自动执行测试、验证、打包或提交。
这些内容不在本文档中定义。

View File

@ -19,5 +19,7 @@ Current reports:
- `Round04_blind_routing_evaluation_report_2026-06-18.md`
- `Round04_1_post_patch_routing_verification_report_2026-06-18.md`
- `Codex新会话交接文档_Round04.1关闭与Round05准备_2026-06-18.md`
- `Codex_本地CCRA规划落地_2026-06-19.md`
- `Codex新会话交接文档_LocalCCRA自动化讨论上下文_2026-06-19.md`
Reports should separate verified facts, assumptions, unresolved questions, and suggested next tasks.