# 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；
- 是否允许自动执行测试、验证、打包或提交。

这些内容不在本文档中定义。
