Codex Knowledge

这个目录承接从 docs/agent 中拆出的专题知识、产品资料、工具资料、敏感资料与历史经验。

这里默认采用单层扁平目录，不再通过分类子目录组织文档；主题分类优先由 frontmatter 的 tags 承载，而不是靠数字前缀。

说明：

• docs/agent 继续保留高频运行规范、计划台账与少数 live canonical 入口。
• codex-knowledge 负责承接不应继续混在 docs/agent 的专题资料。
• 一次性证据、截图、探针输出、烟测结果默认放 _artifacts，不要直接落进这里。

放置规则：

• 属于 live canonical 协议、规范、手册、浏览层、任务 owning 文档：放 docs/agent
• 属于专题知识、产品说明、工具指南、参考汇编、敏感附录、dated migration note：放 docs/codex-knowledge/ 根目录
• 属于一次性验证、日志、扫描、导出证据：放 _artifacts

命名规则：

• 本目录默认保持单层平铺，禁止再建分类子目录
• 文件名与文档标题默认优先使用人类可读的中文标题，不再强制使用数字前缀或 kebab-case
• 只有在术语本身就是稳定标识时，才保留必要英文或协议字样，例如 OpenAI v1、PaddleOCR、DOCX
• 仅当文档天然带日期边界时，才把日期写进标题或文件名，例如 （2026-04-23）
• 避免使用 final、new、temp、misc、整理后 这类失控命名

标签规则：

• 分类优先写进 frontmatter tags，不要再用 10/20/30/... 数字前缀编码主题
• 推荐至少打两层标签：
  • 主题类：如 类-治理规则、类-运维执行、类-能力设计、类-产品方案、类-工具工作流、类-参考索引
  • 形态类：如 形态-规范、形态-方案、形态-清单、形态-记录、形态-汇编、形态-草稿、形态-转录
• 需要表达归档状态时，优先使用 状态-归档
• 建议补一个目录归属标签：目录-codex-knowledge

归档规则：

• 原始聊天草稿、过程转录、与现有 canonical 文档明显重叠但仍值得保留的材料，优先保留为归档文档
• 归档材料默认通过 状态-归档 标签表达；如果仅看文件名也需要一眼识别，可以使用 归档 - 作为中文前缀
• 归档不等于 live canonical；不要把原始草稿直接伪装成正式专题文档

2026-04-23 整理补充（本次按主题收口）：

• 主题文档示例：
  • AI 执行控制架构.md
  • Claude Codex CC Switch 机器级控制面说明书.md
  • Claude Codex CC Switch 最终总清单.md
  • claude-codex-control-plane.json
  • 智能体调试策略优化.md
  • 应付论文工作流.md
  • Atramenti-Console 文档汇编.md
• 归档文档示例：
  • 归档 - Agent 自配置规则草稿.md
  • 归档 - 浏览器自动化与人机验证笔记.md
  • 归档 - key.tengokukk.com 请求链路笔记（2026-04-23）.md
  • 归档 - Codex 本地运行栈转录（2026-04-23）.md

补充说明：

• 本次保留扁平目录，不新建主题子文件夹。
• 本次分类主轴改成“中文标题 + frontmatter tags”；文件名只负责可读性，不再承担数字分类编码。