157 lines
6.8 KiB
Markdown
157 lines
6.8 KiB
Markdown
# 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](C:/Users/wangq/Documents/Codex/skills-vault/PROJECTS.md)，作为 `skills-vault` 的项目总览：五库关系、两类真实需求来源、安装边界、registry 不作为候选 backlog。
|
||
- 更新 [README.md](C:/Users/wangq/Documents/Codex/skills-vault/README.md) 和 [AGENTS.md](C:/Users/wangq/Documents/Codex/skills-vault/AGENTS.md)，补上“Skill 来自真实业务/工作流需求，不预注册候选”的规则。
|
||
- 更新 [docs/architecture.md](C:/Users/wangq/Documents/Codex/skills-vault/docs/architecture.md)、[docs/ccpe-relationship.md](C:/Users/wangq/Documents/Codex/skills-vault/docs/ccpe-relationship.md)、[docs/installation.md](C:/Users/wangq/Documents/Codex/skills-vault/docs/installation.md)、[docs/migration-guide.md](C:/Users/wangq/Documents/Codex/skills-vault/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"}
|
||
|