189 lines
5.3 KiB
Markdown
189 lines
5.3 KiB
Markdown
# Codex 新会话交接文档：Round 自动化规则调整
|
||
|
||
Date: 2026-06-19
|
||
|
||
## 1. 本文档目的
|
||
|
||
本文档用于下一次 Codex 新会话进入 Round 05 和 Local CCRA 正式处理流程。
|
||
|
||
本次会话没有启动 Round 05 内容工作，也没有运行正式 Local CCRA review。
|
||
|
||
本次只完成 Round 自动化 v0.1 + v0.2 的项目侧文件协议调整。
|
||
|
||
## 2. Owner 已确认的共识
|
||
|
||
Owner 同意：
|
||
|
||
- 先做 v0.1 + v0.2 的文件协议设计，不急着写通用 Skill。
|
||
- Round 自动化 v0.1 不只做本地评审编排；在 Owner 确认 findings 后，允许 Codex 自动进入 5.1 修复。
|
||
- 修复前必须有一次 Owner decision gate。
|
||
- Codex 需要把 Local CCRA findings 摘录成中文核心确认事项，供 Owner 快速确认；Owner 不清楚时再自行打开完整评审报告和规划意见。
|
||
|
||
## 3. 新增核心规则文件
|
||
|
||
新增：
|
||
|
||
```text
|
||
docs/ROUND_AUTOMATION_PROTOCOL.md
|
||
```
|
||
|
||
该文件定义项目本地 Round Conductor 协议。
|
||
|
||
重点：
|
||
|
||
- v0.1：自动化 Local CCRA 编排、上下文准备、helper 输出、真实子会话递交、中文 findings 确认。
|
||
- v0.2：Owner decision 后，Codex 只处理 `accept_for_codex_fix` 项，并进入下一次本地 review pass。
|
||
- 不创建通用 Skill。
|
||
- 不把 `ccra-local-reviewer` 变成执行者。
|
||
- 不替代 Owner / Web CCRA / 生命周期权限。
|
||
|
||
## 4. 新增 Local CCRA pass 文件
|
||
|
||
正式自动化 pass 应新增：
|
||
|
||
```text
|
||
findings-confirmation.md
|
||
```
|
||
|
||
该文件由主 Codex 会话在 Local CCRA 输出后编写，必须用中文摘录核心确认事项。
|
||
|
||
推荐条目格式：
|
||
|
||
```text
|
||
### F-001: <中文短标题>
|
||
|
||
- 核心确认事项：
|
||
- Local CCRA 建议：
|
||
- Codex 建议处理：
|
||
- 建议决策：accept_for_codex_fix | reject | defer_to_future_round | escalate_to_web_ccra | owner_clarification_required | accept_as_known_limit
|
||
- 若接受，Codex 可改范围：
|
||
- 若不接受，影响：
|
||
- 证据路径：
|
||
- 需要 Owner 回答：
|
||
```
|
||
|
||
`findings-confirmation.md` 不是完整评审报告替代品。它只负责把 Owner 需要确认的事项压缩出来。
|
||
|
||
## 5. Owner Decision Gate
|
||
|
||
Codex 不得在 `owner-decision.md` 之前修复 Local CCRA findings。
|
||
|
||
允许的状态：
|
||
|
||
```text
|
||
accept_for_codex_fix
|
||
reject
|
||
defer_to_future_round
|
||
escalate_to_web_ccra
|
||
owner_clarification_required
|
||
accept_as_known_limit
|
||
```
|
||
|
||
只有 `accept_for_codex_fix` 授权 Codex 修改项目文件。
|
||
|
||
## 6. 已同步的规则文件
|
||
|
||
本次同步了：
|
||
|
||
```text
|
||
AGENTS.md
|
||
README.md
|
||
PROJECTS.md
|
||
docs/PROJECT_BRIEF.md
|
||
docs/WORKFLOW.md
|
||
docs/DATA_CONTRACT.md
|
||
docs/DECISIONS.md
|
||
docs/FILE_TAXONOMY.md
|
||
docs/HANDOFF_TEMPLATE.md
|
||
local_ccra_reviews/README.md
|
||
knowledge_assets/10_本地CCRA评审机制说明.md
|
||
reports/README.md
|
||
```
|
||
|
||
同时修正两个旧状态用语：
|
||
|
||
```text
|
||
docs/DECISIONS.md
|
||
docs/model_case_preprocessing/qpi/CASE_PREPROCESSING_WORKFLOW.md
|
||
```
|
||
|
||
修正原因：lifecycle scan 对旧 `owner-approved` 表述报 blocker。已改成不声称批准状态的表述。
|
||
|
||
## 7. 验证结果
|
||
|
||
已运行：
|
||
|
||
```powershell
|
||
python scripts\rebuild_indexes.py --check
|
||
python scripts\validate_model_library.py
|
||
git diff --check
|
||
conda run -n skills-vault python C:\Users\wangq\.agents\skills\lifecycle-status-guard-scan\scripts\lifecycle_status_guard_scan.py --scan-root docs --config local_ccra_reviews\round-04\pilot-02\lifecycle-guard-config.yaml --output-dir reports\round_automation_lifecycle_status_guard_scan_2026-06-19
|
||
```
|
||
|
||
结果：
|
||
|
||
- index check passed
|
||
- validation passed
|
||
- staged-independent whitespace check passed; only Windows LF-to-CRLF warnings
|
||
- lifecycle status guard scan passed
|
||
|
||
Lifecycle scan report：
|
||
|
||
```text
|
||
reports/round_automation_lifecycle_status_guard_scan_2026-06-19/lifecycle-status-guard-scan.md
|
||
```
|
||
|
||
## 8. Round 05 新会话启动顺序
|
||
|
||
下一次新会话进入 Round 05 时，建议先读：
|
||
|
||
1. `AGENTS.md`
|
||
2. `reports/Codex新会话交接文档_LocalCCRA自动化讨论上下文_2026-06-19.md`
|
||
3. `reports/Codex新会话交接文档_Round自动化规则调整_2026-06-19.md`
|
||
4. `docs/ROUND_AUTOMATION_PROTOCOL.md`
|
||
5. `local_ccra_reviews/README.md`
|
||
6. `knowledge_assets/10_本地CCRA评审机制说明.md`
|
||
7. Owner / Web CCRA 提供的 Round 05 规划或指导
|
||
|
||
## 9. Round 05 第一动作
|
||
|
||
拿到 Owner / Web CCRA 的 Round 05 指导后，Codex 应先创建或更新 Round 05 charter：
|
||
|
||
```text
|
||
reports/Round05_round_conductor_charter_YYYY-MM-DD.md
|
||
```
|
||
|
||
charter 至少写明：
|
||
|
||
- public round label
|
||
- guidance source
|
||
- round goal
|
||
- explicit non-goals
|
||
- in-scope files or asset areas
|
||
- required validation
|
||
- expected Local CCRA pass path
|
||
- stopping conditions
|
||
- open product questions
|
||
|
||
然后再进入 Round 05 执行和 Local CCRA pass。
|
||
|
||
## 10. 当前未做事项
|
||
|
||
本次未做：
|
||
|
||
- 未启动 Round 05。
|
||
- 未创建 Round 05 charter。
|
||
- 未创建 `local_ccra_reviews/round-05/...`。
|
||
- 未调用 Local CCRA 子会话。
|
||
- 未实现 Round Conductor 脚本。
|
||
- 未创建 skills-vault 请求。
|
||
- 未创建 CCPE 新需求。
|
||
|
||
## 11. 下一步建议
|
||
|
||
1. Owner / Web CCRA 给出 Round 05 目标和指导。
|
||
2. Codex 按 `docs/ROUND_AUTOMATION_PROTOCOL.md` 创建 Round 05 charter。
|
||
3. Codex 执行 Round 05 工作并准备 Local CCRA pass 01。
|
||
4. Local CCRA 输出后，Codex 写 `findings-confirmation.md`，只问 Owner 需要确认的中文核心事项。
|
||
5. Owner decision 后，Codex 只修复 `accept_for_codex_fix` 项，并进入下一次 local pass 或 Web bundle 准备。
|