256 lines
6.5 KiB
Markdown
256 lines
6.5 KiB
Markdown
# 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；
|
||
- 是否允许自动执行测试、验证、打包或提交。
|
||
|
||
这些内容不在本文档中定义。
|