83 lines
3.6 KiB
Markdown
83 lines
3.6 KiB
Markdown
# Knowledge Vault
|
||
|
||
个人长期知识库。它的定位是“矿山和档案馆”：保存长期知识源、正式文章、面向人的模型文档、历史讨论、资料来源、项目归档和知识加工能力的本地运行规则。
|
||
|
||
本仓库不承担 Writing Workbench、CCPE System 或 Delivery Systems 的职责。
|
||
|
||
## 四层边界
|
||
|
||
| 层级 | 定位 | 主要内容 | 不做什么 |
|
||
| --- | --- | --- | --- |
|
||
| 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/` 保存历史提示词、可复用提示词和从旧库迁入但尚未工程化的提示词。
|
||
- `sources/` 合并来源材料，包括 Deep Research、读书笔记、摘抄、网页原文、爬取文章和参考资料。
|
||
- `discussions/` 主要归档历史讨论、非工作台讨论和与 Agent 交流的过程记录。
|
||
- `indexes/` 由 Codex 按需维护，不要求人工每新增文件都同步更新。
|
||
- `templates/` 提供后续人工和 Codex 生成文档时使用的统一格式。
|
||
- `skills/` 保存 Knowledge Vault 本地知识加工能力的运行规则、调用治理、上下文治理、模板和 runbook；不保存 CCPE canonical Skill/Agent/Runtime。
|
||
|
||
## 命名与层级规则
|
||
|
||
- 一级目录使用固定英文名称。
|
||
- 二级目录优先使用英文分类名，用于稳定检索和跨系统引用。
|
||
- 三级目录及以下可以保持中文可读名称，用于保留人的语义习惯和历史上下文。
|
||
- 不因为“版本号更高”默认覆盖旧版本；同一模型族可以多版本并存，并在索引或 README 中说明适用场景。
|
||
|
||
## 与 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。”
|