7.2 KiB

Raw Blame History

VAULT.md

本文档定义 Knowledge Vault 的工作规则。它优先服务人的长期检索，其次服务 Codex 的维护自动化。

1. Vault 定位

Knowledge Vault 是个人知识管理与写作工程体系中的长期层。它负责保存“值得长期留存、可被重新发现、可被重新加工”的材料，以及本仓库执行知识加工时需要遵守的本地运行规则。

它不是：

Writing Workbench：新文章创作、评审、润色、发布闭环应进入写作工作台。
CCPE System：Agent、Skill、Runtime、Model Card、Model Index 等 AI 认知资产工程应进入 CCPE System。
Delivery Systems：客户项目或外部可部署系统应独立管理。

2. 目录职责

目录	职责	典型内容
`diary/`	日常输入与临时想法	按年份保存日记、零散想法、随手记录
`discussions/`	活跃过程归档	文章观点讨论、Agent / Prompt / Committee 打造过程、Agent 交流、技术讨论、创意讨论、项目思考
`sayings/`	短句与表达资产	年度 sayings、金句、表达片段及 metadata
`rules/`	面向人的模型与规则文档	APTC、写作风格、认知模型、销售模型、教育模型
`prompts/`	提示词归档	CCPE / CCPE 2.0 Web 智能体提示词、ChatGPT GPT 提示词、写作提示词、评审提示词、metadata 提示词、旧提示词参考
`sources/`	来源材料	Deep Research、读书笔记、摘抄、网页原文、参考资料
`work/`	工作归档	内部项目、客户项目、敏感本地资料
`indexes/`	人和 Codex 共用索引	文章、模型、提示词、来源、项目索引
`templates/`	文档模板	模型文档、衍生模型、来源笔记、讨论归档、saying metadata
`skills/`	知识加工能力运行层	调用治理、上下文治理、能力 runbook、调用模板、Knowledge 侧能力规格

3. 层级与命名

约定：

示例：

rules/
  marketing-sales/
    APTC模型/
      APTC模型.md
      APTC模型-直播.md
      APTC模型-船长适配.md

这样可以同时满足系统稳定性和人的阅读习惯。

4. `rules/` 规则

rules/ 下保存 Human Model Document。它面向人解释模型，而不是面向 Agent 调用。

一个模型族可以包含：

基模文档
衍生模型文档
版本说明
适用场景说明
与 CCPE Model Card 的链接说明

版本规则：

最高版本不一定最好。
多版本可以并存。
索引中应说明每个版本的适用场景、状态和关系。
不应为了“整洁”删除仍有参考价值的旧版本。

5. `prompts/` 规则

prompts/ 是提示词档案，不等同于 CCPE System。

推荐目标分类：

prompts/
  ccpe/
    ccpe/
    ccpe-2.0/
  GPT/
  article-writers/
  reviewers/
  metadata/
  legacy/

prompts/ccpe/ccpe 与 prompts/ccpe/ccpe-2.0 是同时在使用的 Web 智能体提示词资产，主要面向 Gemini，其他 LLM 如 DeepSeek 可作为辅助适配对象。ccpe-2.0 既包含单智能体专家 Prompt，也包含由多个 Web 单智能体经人工传递上下文组成的多智能体协作提示词，例如 prompts/ccpe/ccpe-2.0/建模者委员会。

prompts/GPT/ 保存 ChatGPT 上的 GPT 提示词资产。legacy/ 仅用于确认为旧参考、停用或暂未分类的提示词，不应用来标记仍在生产中的 CCPE / CCPE 2.0 资产。

迁移旧目录时先建立映射和索引，再按文件夹移动。不要在没有清单的情况下散点移动单文件。

6. `discussions/` 规则

discussions/ 保存过程记录，不承担正式文章生产流。它不是冷库，可以保存仍在发生的观点形成、提示词打造、多智能体协作设计和流程复盘。

discussions/ 可以包含仍在持续更新的会话记录文件。例如当前会话如果通过 VS Code 持续维护在某个 Markdown 文件中，该文件仍属于过程归档，不需要迁出到 Writing Workbench。

当前认可的讨论分类包括：

article-discussions/
agent-building/
model-extraction/
project-thinking/
committees/
agents/
creative/
technology/
training/

其中 article-discussions/ 用于文章相关观点、提纲、评审和写作讨论的活跃过程归档；agent-building/ 用于打造、改造、评审 Agent / Prompt / Committee 的过程讨论；agents/ 用于保存与具体 Agent 的交流记录；creative/ 用于音乐、图片、视频等创意讨论；technology/ 用于技术相关讨论。

7. `skills/` 规则

skills/ 是 Knowledge Vault 的本地知识加工能力层。它保存“在本仓库中如何运行能力”的规则，而不是保存 CCPE canonical 资产。

它可以包含：

调用治理规则，例如 invocation-policy.md。
上下文治理规则，例如 context-management-policy.md。
面向具体知识加工能力的 runbook、context strategy、invocation contract。
invocation、prompt-to-send、skill-execution-record、thread handoff 等模板。
本地脚本或代码型加工能力的运行说明。

它不应包含：

CCPE System 中的 canonical Agent / Skill / Runtime 全文副本，除非 prompt-to-send 明确需要粘贴。
某次具体任务的大量运行日志。
某次具体任务的 source-map、topic-map、routing-log、topic docs 或 audit。
文章生产流水线。

具体任务的运行记录应放在对应工作目录，例如：

discussions/viewpoint-development/{date}-{topic}/
  invocations/
  handoff/
  audits/

公共层只保留可复用规则和模板。若 CCPE 规则不足以真实调用 participant，必须暂停并记录阻塞状态，不能模拟正式 Agent 输出。

8. `sources/` 规则

sources/ 合并旧的 sources 和 notes 职责。它保存外部材料和对材料的初步处理。

推荐分类：

sources/
  deep-research/
  reading-notes/
  excerpts/
  clipped-articles/
  web-archives/
  references/

当来源材料被提炼为模型、文章或项目资产时，应在对应索引中建立回链，而不是复制多份。

9. 索引维护

indexes/ 由 Codex 按需维护。人工不需要每次新增文件都手动更新。

触发条件：

新增一个模型族或重要版本。
批量迁移一个目录。
从旧库导入一批材料。
某个项目阶段完成，需要归档。
需要从文章、讨论或来源材料中提炼模型关系。
新增或调整公共知识加工能力。

索引原则：

优先记录关系，不追求全量复写。
标记状态和适用场景。
对版本关系给出明确说明。
对迁移中的旧目录保留过渡说明。

skills/ 的公共能力发现入口是：

indexes/skill-index.md

10. 迁移规则

迁移按文件夹进行，不做零散手工搬运。

标准步骤：

扫描目录规模和文件类型。
生成迁移清单。
标出源路径、目标路径、迁移理由和风险。
用户确认。
执行移动。
更新相关索引。
检查 Git diff。

本仓库已接入 Git。大规模迁移前仍应尽量保持单次变更边界清晰。

7.2 KiB Raw Blame History Unescape Escape