wantsong
/
the-mindscape-of-bro-tsong
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
the-mindscape-of-bro-tsong/reports/Codex新会话交接文档_模型库MVP_2026-06...

8.5 KiB
Raw Blame History

Codex 新会话交接文档：模型库 / 模型管理子系统 MVP

1. 当前状态

仓库：C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong

当前阶段：model_library_mvp

当前已完成：

  • QPI 和思想考古学两个样板模型已工程化为模型资产。
  • 本地规则、schema、workflow、index、validator、selector demo 已建立。
  • ChatGPT 交接规则和长期知识资产规则已建立。
  • knowledge_assets/ 已建立，放置长期复用的规则性文档，不复制具体模型卡 source of truth。
  • 索引维护已升级为脚本化规则：每次资产变更增量同步，关键节点全量重建或校验。
  • status 已加入模型 JSON，作为 models/model_index.json.status 的来源字段。
  • 第二轮内容稳定化已完成：字段级 evidence matrix、source excerpt quote 状态、QPI 输出契约、思想考古停止门、regression 扩展、selector v0.2、防误召回测试、JSON/Markdown 同步检查、content review report。

当前模型资产状态：

  • qpi: draft / B / pending
  • intellectual_archaeology: draft / B / pending

二者通过本地 contract，但仍等待产品 / ChatGPT / CCRA 内容审查。

当前 review 结论：

  • draft-callable: allowed
  • stable: not allowed
  • third model expansion: not allowed

2. 下个 Codex 会话先读文件

按顺序读：

  1. AGENTS.md
  2. README.md
  3. reports/Codex新会话交接文档_模型库MVP_2026-06-16.md
  4. reports/ChatGPT交接文档_模型库MVP_2026-06-16.md
  5. docs/MODEL_EXTRACTION_WORKFLOW.md
  6. docs/MODEL_EXTRACTION_RULES.md
  7. docs/MODEL_CARD_CONTRACT.md
  8. docs/CHATGPT_HANDOFF_RULES.md
  9. docs/KNOWLEDGE_ASSET_RULES.md
  10. docs/INDEX_MAINTENANCE_PROTOCOL.md
  11. models/model_index.json
  12. cards/card_index.md

如果用户带回 ChatGPT 新建议，先按 docs/GPT_PLAN_LOCALIZATION_PROTOCOL.md 做本地化计划，不要直接改内容。

3. 已验证命令

最近一轮验证通过：

python scripts\rebuild_indexes.py --check
python -m unittest discover -s tests -p "test*.py" -v
python scripts\check_card_contract.py
python scripts\validate_model_library.py
python scripts\run_selector_demo.py
python scripts\run_selector_regression.py
python scripts\check_model_card_sync.py

结果：

  • Index check: PASS.
  • Unit tests: PASS, 14 tests.
  • Card contract: PASS.
  • Model library validation: PASS.
  • Selector demo: PASS.
  • Selector regression: PASS.
  • Model/card sync: PASS.
  • reports/index_rebuild_report.md: Status: PASS.
  • reports/validation_report.md: Status: PASS.

4. 关键规则

GPT 规划规则

GPT 规划不是本地可直接执行规则。

必须先转为：

  • local rules
  • schemas
  • workflow gates
  • indexes
  • validation tools
  • owner review points

再进入内容修改。

相关文件：

  • docs/GPT_PLAN_LOCALIZATION_PROTOCOL.md
  • docs/MODEL_EXTRACTION_RULES.md

ChatGPT 交接规则

每次用户从 Codex 回 ChatGPT 时，生成：

reports/ChatGPT交接文档_<topic>_<YYYY-MM-DD>.md

相关文件：

  • docs/CHATGPT_HANDOFF_RULES.md
  • reports/ChatGPT交接文档_模型库MVP_2026-06-16.md

长期知识资产规则

稳定复用知识进入 knowledge_assets/。

不要把具体模型卡复制进 knowledge_assets/ 作为第二 source of truth。

具体模型卡 source of truth 仍在：

  • cards/
  • models/

相关文件：

  • docs/KNOWLEDGE_ASSET_RULES.md
  • knowledge_assets/

索引维护规则

models/model_index.json 是机器发现入口。

cards/card_index.md 是人读审查入口。

二者不再作为独立手工内容源长期维护，而是从模型 JSON、card 文件和 regression cases 生成或校验。

规则：

每次资产变更必须增量同步索引
+
关键节点必须全量重建或全量一致性校验

相关文件：

  • docs/INDEX_MAINTENANCE_PROTOCOL.md
  • scripts/rebuild_indexes.py
  • reports/index_rebuild_report.md

内容稳定化规则

工程 contract 通过不等于内容稳定。

本轮新增：

  • docs/CONTENT_STABILIZATION_PROTOCOL.md
  • sources/evidence_coverage.matrix.json
  • reports/evidence_coverage_report_v0.2.md
  • reports/content_review_report_v0.2.md
  • reports/model_review_status.json
  • reports/next_action_register_v0.2.md

当前结论：

QPI: draft / B / pending
Intellectual Archaeology: draft / B / pending
draft-callable: allowed
stable: not allowed
third_model_expansion: not allowed

5. 当前关键文件

模型资产：

  • models/qpi.model.json
  • models/intellectual_archaeology.model.json
  • cards/qpi.md
  • cards/intellectual_archaeology.md
  • models/model_index.json
  • cards/card_index.md

schema：

  • schemas/model_card.schema.json
  • schemas/source_article.schema.json
  • schemas/source_excerpt.schema.json
  • schemas/regression_case.schema.json
  • schemas/model_index.schema.json
  • schemas/card_index.schema.json

数据：

  • sources/source_articles.json
  • sources/source_excerpts.json
  • tests/regression_cases.json
  • tests/qpi.regression.json
  • tests/intellectual_archaeology.regression.json
  • selector/selector_rules.json
  • selector/selector_examples.json

工具：

  • scripts/validate_model_library.py
  • scripts/check_card_contract.py
  • scripts/rebuild_indexes.py
  • scripts/run_selector_demo.py
  • scripts/run_selector_regression.py
  • scripts/check_model_card_sync.py

知识资产：

  • knowledge_assets/00_用户背景与产品上下文.md
  • knowledge_assets/01_核心模型地图.md
  • knowledge_assets/02_模型卡结构规范.md
  • knowledge_assets/03_核心模型抽取样板.md
  • knowledge_assets/06_模型稳固性评级规则.md
  • knowledge_assets/07_产品规划过程记录.md

6. 当前已知未决问题

这些问题应由用户 / ChatGPT / CCRA 做产品或质量判断，不应由 Codex 直接拍板：

  • QPI 当前字段和边界是否准确。
  • 思想考古学是否应保持七层结构，还是需要更强的停止条件表达。
  • 是否应引入第三个核心模型。
  • 从产品角度看，后续模型抽取是否需要拆成抽取、检验、评分三个环节。
  • 如果需要多环节审查，这三个环节的质量标准分别是什么。
  • 当前 QPI / 思想考古样板是否已经暴露出需要多角色审查的质量问题。
  • regression cases 已按模型拆分，但用例真实性和遗漏边界仍需人工审查。
  • selector 已保持规则化并升级到 v0.2；是否未来加入 LLM 判断层仍不是本轮决策。
  • 当前索引策略已工程化，不再需要 owner 判断；但模型状态升级仍需要 owner / ChatGPT / CCRA 明确决定。
  • QPI 混合案例是否需要更细的主导匮乏物仲裁规则。
  • 思想考古 recommended_max_depth 是否应与 QPI 输出更强绑定。
  • draft-callable 是否应进入 schema，还是继续留在 review report。

本地仓库归属判断不交给 ChatGPT：

  • agent spec / invocation / evaluation / governance -> requirements/ccpe/
  • reusable deterministic tools / batch scripts / format transformers -> requirements/skills-vault/
  • product-specific config, adapters, state, selector behavior -> 本仓库

7. 下轮可能任务

用户即将带回 ChatGPT 新一轮讨论结果。

下轮开始时：

  1. 先读取用户带回的内容。
  2. 判断它是产品判断、内容修复、规则修复、schema 修复、workflow 修复、工具需求，还是 supplier request。
  3. 若是 GPT 规划或建议，先做本地化计划。
  4. 若是明确内容修改，按现有 contract 修模型卡和 JSON。
  5. 修改后运行 python scripts\rebuild_indexes.py --write。
  6. 再运行 python scripts\rebuild_indexes.py --check、python scripts\run_selector_regression.py、python scripts\check_model_card_sync.py 和验证命令。
  7. 若用户要再回 ChatGPT，生成新的 ChatGPT 交接文档。

8. 工作区提醒

当前 git status --short 显示大量新增文件和修改文件；这些是本轮模型库 MVP 工程化打样产物。

不要把 untracked 文件误认为无关临时文件。

测试运行会生成：

  • scripts/__pycache__/
  • tests/__pycache__/

验证后应清理这些缓存目录。

9. 不要重复做的事

不要重新初始化目录。

不要重新创建 QPI / 思想考古基础模型资产。

不要把具体模型卡复制进 knowledge_assets/。

不要把 GPT 对 agent / tool 归属的意见直接当成本地仓库归属决策。

不要在没有 owner 明确要求时引入数据库、后端服务、前端应用、RAG、认证或平台化能力。