knowledge-vault/discussions/technology/Codex/0.规划与重构/0.环境规划-skills-vault-2026-06-15.md

1

要求： 阅读3份文档：

1. C:\Users\wangq\Documents\Codex\knowledge-vault\discussions\technology\Codex\0.规划与重构\2026-06-15\00-五库重构总纲.md
2. C:\Users\wangq\Documents\Codex\knowledge-vault\discussions\technology\Codex\0.规划与重构\2026-06-15-规划总结.md
3. C:\Users\wangq\Documents\Codex\knowledge-vault\discussions\technology\Codex\0.规划与重构\2026-06-15\05-skills-vault调整意见.md.md

本次应该只涉及到项目的描述、规则类文件及项目关系等。

projects文件

• 这是writing-workbench下的一个projects文件， C:\Users\wangq\Documents\Codex\writing-workbench\PROJECTS.md
• 类似的，knowledge-vault下也有自己的 C:\Users\wangq\Documents\Codex\knowledge-vault\PROJECTS.md
• CCPE的，C:\Users\wangq\Documents\Codex\ccpe-system\PROJECTS.md
• video的，C:\Users\wangq\Documents\Codex\video-workbench\PROJECTS.md

---

将来你的需求发起，可能来自于两部分：

1. “业务系统”的需求，比如voice-gen实际上就是为video-workbench配套的；
2. 我工作过程中发现的局部自动化，比如fix-title 就是我在与chatgpt交流时发现格式总是不对

---

请先提出你的问题。

我已读完三份材料；第三份实际路径是 05-skills-vault调整意见.md，你给的是 .md.md。

我的问题：

1. 这轮是否只改 skills-vault 仓库？ 我理解不直接修改 writing-workbench / knowledge-vault / ccpe-system / video-workbench 的 PROJECTS.md，只在 skills-vault 内补齐对应说明和关系。

2. 是否要为 skills-vault 新增自己的 PROJECTS.md？ 目前仓库里没有。结合你列出的四个项目，我倾向于新增一个，定位为“五库关系中的 skills-vault 项目说明 + 需求入口分类 + 与其他项目的协作边界”。

3. PROJECTS.md 的用途你希望偏哪一种？

   • 项目总览：给新会话快速理解仓库定位；
   • 操作路由：判断一个需求该进 skills-vault、业务项目、还是 ccpe-system；
   • 两者都要，但保持轻量。

4. “需求发起来自两部分”是否要固化成正式规则？ 我建议写成两个 intake source：

   • business-system-support：服务 video-workbench、writing-workbench 等业务系统；
   • local-workflow-automation：工作过程中发现的局部自动化，如 fix-title。 这条是否可以进入 PROJECTS.md 或 docs/architecture.md？

5. voice-generation 与 video-workbench 的关系要写到什么程度？ 我倾向于写成：voice-generation 是 skills-vault 拥有源码的 automation skill，但当前主要服务 video-workbench；业务流程、视频生产 Runtime、素材决策仍归 video-workbench。

6. 候选 Skill 是否只登记不实现？ 比如 voiceover-budget-checker、asset-log-builder、context-handoff-builder，我理解本轮只放入 registry / 项目说明的候选区，不创建 Skill 目录和脚本。

7. 本轮允许调整哪些文件？ 我的候选范围是：

   • README.md
   • AGENTS.md
   • docs/architecture.md
   • docs/ccpe-relationship.md
   • registry/skills-index.md
   • 新增 PROJECTS.md

   是否还有你明确希望纳入或排除的文件？

2

1. 这轮是否只改 skills-vault 仓库？ 只在 skills-vault 内补齐对应说明和关系。

2. 是否要为 skills-vault 新增自己的 PROJECTS.md？ 新增一个，定位为“五库关系中的 skills-vault 项目说明 + 需求入口分类 + 与其他项目的协作边界”。

3. PROJECTS.md 的用途你希望偏哪一种？ 这个是给你自己用的，作为项目总览就可以。

4. “需求发起来自两部分”是否要固化成正式规则？ 可以进入PROJECTS.md 或 docs/architecture.md

5. voice-generation 与 video-workbench 的关系要写到什么程度？ voice-generation 会安装到机器的.agent/skills/下，video-workbench用的是.agent/skills/ 下的，和本项目没直接关系。 video-workbench 只是需求发起方之一，算作“业务”系统。

6. 候选 Skill 是否只登记不实现？ 不创建 Skill 目录和脚本，也不放在 registry / 项目说明的候选区。这些可能都不是真实流程的需求。 将来Skill一定会来自于真实流程。

7. 本轮允许调整哪些文件？ 删掉registry/

---

若没有其他问题，可以进行调整工作了。

3

上一轮有歧义的部分：

你问：

7. 本轮允许调整哪些文件？
   我的候选范围是：
   - `README.md`
   - `AGENTS.md`
   - `docs/architecture.md`
   - `docs/ccpe-relationship.md`
   - `registry/skills-index.md`
   - 新增 `PROJECTS.md`

我说：

删掉registry/

我的意思不是要删掉这个目录，而是从变化范围中删掉registry/skills-index.md 即，本轮不做任何候选skill的预注册/登记，所有的skill都从真实业务需求中来，要么是业务系统，比如video-workbench的需求单；要么是我工作过程中发现的自动化要求。

---

然后，我看到你理解错了，在考虑删除这个路径，我按了停止。

---

现在，需要你重新理解，看下你上次做了哪些操作，恢复并继续。

已按纠正后的边界继续完成。

本轮实际变更：

• 新增 PROJECTS.md，作为 skills-vault 的项目总览：五库关系、两类真实需求来源、安装边界、registry 不作为候选 backlog。
• 更新 README.md 和 AGENTS.md，补上“Skill 来自真实业务/工作流需求，不预注册候选”的规则。
• 更新 docs/architecture.md、docs/ccpe-relationship.md、docs/installation.md、docs/migration-guide.md，同步业务系统、.agents/skills、ccpe-system 的边界说明。

我确认了：

• 没有删除 registry/。
• 没有修改 registry/skills-index.md，git diff -- registry/skills-index.md 为空。
• 没有创建候选 Skill 目录、脚本或 registry 预登记。
• git status 只显示上述文档变更和新增 PROJECTS.md。

4

现在提交并同步远程，打上tag。 本次重构工作就算结束了。

已完成。

• 已推送 main 到 origin/main
• 已推送 tag：skills-vault-restructure-2026-06-15
• 当前 HEAD：9109268 Document skills-vault project boundaries
• 本地状态：main...origin/main，已同步

本次 skills-vault 重构收尾完成。

::git-push{cwd="C:\Users\wangq\Documents\Codex\skills-vault" branch="main"}