163 lines
7.0 KiB
Markdown
163 lines
7.0 KiB
Markdown
# GPT 规划落地差异检查 v0.1
|
||
|
||
## Source Plan
|
||
|
||
`C:\Users\wangq\Documents\Codex\knowledge-vault\work\internal\强哥的思想宇宙\GPT成果\2026-06-16-核心模型抽取样板 v0.1.md`
|
||
|
||
## Scope Of This Pass
|
||
|
||
本轮只修复规则层。
|
||
|
||
已落地：
|
||
|
||
- GPT 规划本地化协议。
|
||
- 模型抽取规则。
|
||
- GPT 规划与当前仓库差异检查。
|
||
- 决策日志。
|
||
|
||
未在本轮执行：
|
||
|
||
- schema 修复。
|
||
- card contract 修复。
|
||
- workflow 文档修复。
|
||
- index 文件创建。
|
||
- validator 或 selector 工具修复。
|
||
- QPI / 思想考古内容修复。
|
||
|
||
## Adopted Into Local Rules
|
||
|
||
已写入 `docs/GPT_PLAN_LOCALIZATION_PROTOCOL.md`：
|
||
|
||
- GPT 规划是上游计划输入，不是本地可直接执行规则。
|
||
- 每次 GPT 规划进入后，必须先做本地计划。
|
||
- 本地计划必须识别规则、schema、workflow、tooling、index、owner gate。
|
||
- 未完成本地化前，不允许直接进入内容抽取或内容修复。
|
||
- 模型抽取必须保持双工模式：
|
||
- workflow/tooling track
|
||
- content extraction track
|
||
|
||
已写入 `docs/MODEL_EXTRACTION_RULES.md`：
|
||
|
||
- 字段名英文，中文来源的 JSON 值和 Markdown 内容保持中文。
|
||
- 模型抽取不是文章摘要。
|
||
- 每个模型必须有 source article 和 source evidence 引用。
|
||
- placeholder evidence 必须明确标注，不能伪装成 verified evidence。
|
||
- 完整模型资产链为 source article、source excerpt、Markdown card、JSON model card、regression cases、selector routing、model index、card index、validation report。
|
||
- 每个核心模型至少五个 regression cases，覆盖 positive、boundary、misuse。
|
||
- v0.1 selector 不调用 LLM，必须输出 model ID、score、reason、routing notes。
|
||
- 机器模型索引使用 `models/model_index.json`。
|
||
- 人读模型卡索引使用 `cards/card_index.md`。
|
||
- 未来超过约 8-10 个核心模型后，再考虑 full rebuild index script。
|
||
- 缺失可复用工具时走 `requirements/skills-vault/`。
|
||
- 缺失 CCPE 规格、治理、调用协议或评估能力时走 `requirements/ccpe/`。
|
||
|
||
## Adopted Into Local Schema
|
||
|
||
本轮尚未修改 schema。
|
||
|
||
GPT 规划中待落地到 schema 的关键点：
|
||
|
||
- `schemas/model_card.schema.json` 应成为机器可读模型卡的权威 schema。
|
||
- 当前 `schemas/model_spec.schema.json` 只覆盖最小字段，不覆盖 GPT 样例完整字段。
|
||
- model JSON 需要补充推荐字段：
|
||
- `trigger_keywords`
|
||
- `negative_triggers`
|
||
- `related_models`
|
||
- `conflicting_models`
|
||
- `disciplinary_anchors`
|
||
- `example_inputs`
|
||
- `example_outputs`
|
||
- `output_contract`
|
||
- `depth_control`
|
||
- `stabilization_path`
|
||
- `version`
|
||
- `last_updated`
|
||
- `selection_priority` 应使用 1-10 范围，而不是当前 95 / 80 这类百分制风格。
|
||
- `model_type` 应使用 GPT 规划中的枚举，例如 `routing_model`、`deep_modeling_model`。
|
||
- `pipeline_position` 应使用 GPT 规划中的枚举，例如 `pre_analysis`、`deep_analysis`。
|
||
- `stability_profile` 需要包含：
|
||
- `stability_level`
|
||
- `needs_stabilization`
|
||
- `main_risks`
|
||
- `reason`
|
||
- `next_stabilization_action`
|
||
- 每个 schema 属性需要中文 `description`，避免字段歧义。
|
||
|
||
## Adopted Into Local Workflow
|
||
|
||
本轮只在规则文件中记录 workflow gate，尚未创建 `docs/MODEL_EXTRACTION_WORKFLOW.md`。
|
||
|
||
待落地 workflow：
|
||
|
||
1. GPT plan intake。
|
||
2. Local plan creation。
|
||
3. Owner review of local plan。
|
||
4. Rules/schema/index/workflow implementation。
|
||
5. Validation of rules/schema/index/workflow。
|
||
6. Owner review of the foundation。
|
||
7. Content extraction or content repair。
|
||
8. Validation and audit report。
|
||
9. Owner content review。
|
||
|
||
## Adopted Into Tooling Plan
|
||
|
||
本轮尚未修改工具。
|
||
|
||
GPT 规划中待落地的工具要求：
|
||
|
||
- `scripts/validate_model_library.py` 需要升级为 schema、引用、index、card contract、regression coverage 的综合校验器。
|
||
- 需要新增 `scripts/check_card_contract.py`，检查 Markdown card 必需章节。
|
||
- 需要新增 `scripts/run_selector_demo.py`，按关键词、输入类型、负向触发、pipeline position、selection_priority 输出推荐模型、分数、理由和 routing notes。
|
||
- 如果后续需要从 GPT 规划自动提取字段和验收标准，可新增 `scripts/extract_plan_requirements.py`，但 v0.1 暂不必做。
|
||
|
||
## Differences From Current Repository
|
||
|
||
当前仓库与 GPT 规划的主要差异：
|
||
|
||
1. `cards/qpi.md` 和 `cards/intellectual_archaeology.md` 目前不是按完整 card contract 写成，缺少 GPT 规划中的多个章节。
|
||
2. 当前没有 `docs/MODEL_CARD_CONTRACT.md`。
|
||
3. 当前没有 `schemas/model_card.schema.json`。
|
||
4. 当前 `schemas/model_spec.schema.json` 缺少字段描述、枚举、推荐字段和稳定性理由字段。
|
||
5. 当前 model JSON 的 `model_type`、`pipeline_position`、`selection_priority` 与 GPT 规划枚举和范围不一致。
|
||
6. 当前没有 `models/model_index.json`。
|
||
7. 当前没有 `cards/card_index.md`。
|
||
8. 当前没有 index schema。
|
||
9. 当前 selector 只有 data-only rules 和 examples，没有可执行 demo。
|
||
10. 当前 regression cases 是合并文件，不是 GPT 规划中建议的按模型拆分文件；这不一定错误，但需要在后续 schema/workflow 中明确采用合并还是拆分。
|
||
11. 当前 validation 只检查基础必填字段和引用完整性，没有完整 schema、card contract、index、selector demo 或 regression coverage 检查。
|
||
12. 当前 handoff 把第一版内容称为“资产链路”，但按新的规则判断，它只能算草稿内容，不能算已通过 GPT 样板契约。
|
||
|
||
## Deferred Items
|
||
|
||
以下内容留到后续任务执行：
|
||
|
||
- 创建 `docs/MODEL_CARD_CONTRACT.md`。
|
||
- 创建 `docs/MODEL_EXTRACTION_WORKFLOW.md`。
|
||
- 创建 `schemas/model_card.schema.json`。
|
||
- 为现有 schemas 添加中文 `description` 和枚举约束。
|
||
- 创建 `schemas/model_index.schema.json` 和 `schemas/card_index.schema.json`。
|
||
- 创建 `models/model_index.json` 和 `cards/card_index.md`。
|
||
- 升级 validator。
|
||
- 新增 card contract checker。
|
||
- 新增 selector demo。
|
||
- 重新修复 QPI 和思想考古模型内容。
|
||
|
||
## Owner Review Questions
|
||
|
||
1. `tests/regression_cases.json` 是否继续使用合并文件，还是改为 GPT 规划建议的 `tests/qpi.regression.json` 与 `tests/intellectual_archaeology.regression.json`？
|
||
2. 当前两个已经生成的模型内容，后续是直接改写，还是先保留为 `draft_pre_contract` 状态并新建合规版本？
|
||
3. `model_spec.schema.json` 是否保留为旧名兼容，还是迁移到 `model_card.schema.json` 并废弃旧名？
|
||
4. selector demo 是否应在 schema/index 基础完成后立即实现，还是等模型内容修复后再实现？
|
||
5. index 是否在 v0.1 手动维护即可，是否暂缓 full rebuild script？
|
||
|
||
## Current Recommendation
|
||
|
||
下一步应执行计划 Task 2 和 Task 3：
|
||
|
||
1. 建立 `docs/MODEL_CARD_CONTRACT.md`。
|
||
2. 建立 `schemas/model_card.schema.json`。
|
||
3. 给 source、excerpt、regression schema 补中文说明与枚举。
|
||
4. 定义 model/card index schema。
|
||
|
||
在这些完成并经 owner 检查前，不继续修复 QPI 和思想考古内容。
|