86 lines
4.0 KiB
Markdown
86 lines
4.0 KiB
Markdown
# Knowledge Vault
|
||
|
||
个人长期知识库。它的定位是“矿山和档案馆”：保存长期知识源、正式文章、面向人的模型文档、活跃讨论过程、资料来源、项目归档和知识加工能力的本地运行规则。
|
||
|
||
本仓库不承担 Writing Workbench、CCPE System 或 Delivery Systems 的职责。
|
||
|
||
周边项目关系见 [PROJECTS.md](PROJECTS.md)。
|
||
|
||
## 四层边界
|
||
|
||
| 层级 | 定位 | 主要内容 | 不做什么 |
|
||
| --- | --- | --- | --- |
|
||
| Knowledge Vault | 长期知识源与过程归档 | 日记、活跃讨论过程、模型说明、文章、资料源、项目归档、知识加工能力运行规则 | 不承载文章生产流水线，不替代 CCPE 的 AI 资产工程 |
|
||
| Writing Workbench | 写作工地 | 素材整理、提纲、正文、评审、润色、Metadata、发布 | 不做长期知识分类的唯一入口 |
|
||
| CCPE System | 造锤子的车间 | Agent、Skill、Runtime、Model Card、Model Index | 不保存面向人阅读的完整知识库 |
|
||
| Delivery Systems | 外部交付系统 | 客户或项目级 Agentic 产品 | 不和个人创作体系混放 |
|
||
|
||
## 当前目录
|
||
|
||
```text
|
||
knowledge-vault/
|
||
README.md
|
||
VAULT.md
|
||
|
||
diary/
|
||
discussions/
|
||
sayings/
|
||
rules/
|
||
prompts/
|
||
sources/
|
||
work/
|
||
indexes/
|
||
templates/
|
||
skills/
|
||
```
|
||
|
||
## 核心原则
|
||
|
||
- `diary/` 是临时想法和日常记录入口，因此本仓库不设置 `inbox/`。
|
||
- `rules/` 保存面向人阅读的模型文档、规则文档、版本说明和模型族说明。
|
||
- `prompts/` 保存仍在使用的 Web 智能体提示词、ChatGPT GPT 提示词、可复用提示词和从旧库迁入但尚未工程化的提示词。
|
||
- `sources/` 合并来源材料，包括 Deep Research、读书笔记、摘抄、网页原文、爬取文章和参考资料。
|
||
- `discussions/` 保存活跃过程归档，包括文章观点讨论、Agent / Prompt / Committee 打造过程、非工作台讨论和与具体 Agent 交流的记录。
|
||
- `indexes/` 由 Codex 按需维护，不要求人工每新增文件都同步更新。
|
||
- `templates/` 提供后续人工和 Codex 生成文档时使用的统一格式。
|
||
- `skills/` 保存 Knowledge Vault 本地知识加工能力的运行规则、调用治理、上下文治理、模板和 runbook；不保存 CCPE canonical Skill/Agent/Runtime。
|
||
|
||
## 命名与层级规则
|
||
|
||
- 一级目录使用固定英文名称。
|
||
- 二级目录优先使用英文分类名，用于稳定检索和跨系统引用。
|
||
- 三级目录及以下可以保持中文可读名称，用于保留人的语义习惯和历史上下文。
|
||
- 不因为“版本号更高”默认覆盖旧版本；同一模型族可以多版本并存，并在索引或 README 中说明适用场景。
|
||
- 目录表示材料类型和使用场景；`active`、`maintained`、`reference`、`superseded`、`deprecated`、`archived` 等状态字段表示活跃度，不用 `historic` 或 `legacy` 直接判定资产是否停用。
|
||
|
||
## 与 CCPE System 的双轨关系
|
||
|
||
面向人的模型文档保存在本仓库 `rules/` 下；面向 AI/Agent 调用的 Model Card 和 Model Index 保存在：
|
||
|
||
```text
|
||
C:\Users\wangq\Documents\Codex\ccpe-system
|
||
```
|
||
|
||
例如 APTC 这类模型应形成双轨：
|
||
|
||
- `knowledge-vault/rules/...`：基模、衍生模型、版本说明、面向人的解释。
|
||
- `ccpe-system/model-cards/...`：AI-Oriented Model Card。
|
||
|
||
知识加工能力也采用双轨：
|
||
|
||
- `knowledge-vault/skills/...`：本仓库如何调用、落盘、分段、交接和验收能力。
|
||
- `ccpe-system/agents|skills|runtimes/...`：canonical Agent、Skill、Runtime 定义。
|
||
|
||
如果 CCPE 提供的规则不足以真实调用 participant，Knowledge Vault 应暂停并记录阻塞状态，不模拟正式 Agent 输出。
|
||
|
||
## Codex 维护触发语
|
||
|
||
可以用以下方式触发维护：
|
||
|
||
- “请扫描某目录并更新索引。”
|
||
- “我新增了某模型，请更新模型索引和版本关系。”
|
||
- “请按目录生成迁移清单，不要移动文件。”
|
||
- “请执行这份迁移清单。”
|
||
- “请按 skills 中的某个能力处理这份材料。”
|
||
- “请为某个知识加工流程生成 invocation packet 或 continuation handoff。”
|