148 lines
4.2 KiB
Markdown
148 lines
4.2 KiB
Markdown
# skills-vault 调整意见
|
||
|
||
```yaml
|
||
created: 2026-06-15
|
||
project_path: C:\Users\wangq\Documents\Codex\skills-vault
|
||
status: adjustment-brief
|
||
```
|
||
|
||
## 1. 当前判断
|
||
|
||
`skills-vault` 的定位很清楚：它是自动化 Skill 的实现源头，不是 CCPE 资产库，也不是深度创作工作台。
|
||
|
||
这次调整反而让 `skills-vault` 的边界更重要。深度创作中的很多东西不能自动化，但周边有大量低风险、可验证、可测试的自动化能力，应该进入 `skills-vault`。
|
||
|
||
当前已有能力：
|
||
|
||
- `fix-title`：标题层级修复。
|
||
- `voice-generation`：语音稿 / TTS 相关能力。
|
||
|
||
它们都符合 `skills-vault` 的基本特征：
|
||
|
||
```text
|
||
输入清楚
|
||
输出清楚
|
||
行为可测试
|
||
边界明确
|
||
可跨 Codex / Claude Code / OpenClaw 使用
|
||
```
|
||
|
||
## 2. 建议调整
|
||
|
||
### 2.1 坚持“自动化 Skill 实现源头”的边界
|
||
|
||
不要把深度创作主流程迁入 `skills-vault`。
|
||
|
||
可进入 `skills-vault` 的能力应满足：
|
||
|
||
- 能用脚本或明确步骤执行。
|
||
- 结果可以检查。
|
||
- 不依赖复杂审美或立意判断。
|
||
- 不需要模拟专家角色。
|
||
- 可复用到多个项目。
|
||
|
||
不适合进入 `skills-vault` 的能力：
|
||
|
||
- 文章立意判断。
|
||
- 提纲优劣判断。
|
||
- 张辽、认知显影、巨人认知等专家评审人格。
|
||
- 建模者委员会。
|
||
- 深度创作总控。
|
||
|
||
这些应留在 `knowledge-vault` 讨论显影，或在成熟后进入 `ccpe-system`。
|
||
|
||
### 2.2 优先接收“边缘自动化”
|
||
|
||
这次五库调整后，适合进入 `skills-vault` 的不是创作核心，而是边缘工作：
|
||
|
||
- Markdown 标题、front matter、链接修复。
|
||
- 文章 metadata 草案格式检查。
|
||
- 口播稿字数和时长估算。
|
||
- 口播稿转音频。
|
||
- PPT / 视频素材清单导出。
|
||
- source-map 格式检查。
|
||
- context-handoff 模板生成。
|
||
- 文件批量重命名或索引生成。
|
||
|
||
这些能力能减少手工负担，但不会越过创作判断。
|
||
|
||
### 2.3 与 CCPE 的关系保持“实现 vs 注册”
|
||
|
||
现有文档已经写清楚：
|
||
|
||
```text
|
||
skills-vault = implementation source
|
||
ccpe-system = architecture registration
|
||
```
|
||
|
||
建议继续坚持。若某个 Skill 被 CCPE Runtime 调用，CCPE 只记录：
|
||
|
||
- canonical implementation path
|
||
- installed path
|
||
- authority
|
||
- validation
|
||
- used by
|
||
|
||
不要复制 Skill 实现源码。
|
||
|
||
### 2.4 为 writing / video 周边能力建立候选清单
|
||
|
||
可以在 `registry/skills-index.md` 或新文档中增加候选区：
|
||
|
||
```text
|
||
candidate-writing-support-skills
|
||
candidate-video-support-skills
|
||
```
|
||
|
||
候选项先记录，不急着实现。
|
||
|
||
初始候选：
|
||
|
||
- `source-map-checker`
|
||
- `context-handoff-builder`
|
||
- `metadata-frontmatter-checker`
|
||
- `voiceover-budget-checker`
|
||
- `asset-log-builder`
|
||
- `publish-copy-exporter`
|
||
|
||
## 3. 暂缓事项
|
||
|
||
暂时不要做这些事：
|
||
|
||
- 不要把 `knowledge-vault/skills` 迁入 `skills-vault`。
|
||
- 不要把 CCPE Skill spec 当成 `skills-vault` 实现。
|
||
- 不要把文章生产 Runtime 写成 Skill。
|
||
- 不要把专家智能体 prompt 放进 `skills-vault`。
|
||
- 不要创建不可测试、只靠模型判断的“自动化 Skill”。
|
||
|
||
## 4. 进入 skills-vault 项目后的细化入口
|
||
|
||
进入 `skills-vault` 后，建议新会话先读：
|
||
|
||
```text
|
||
C:\Users\wangq\Documents\Codex\skills-vault\README.md
|
||
C:\Users\wangq\Documents\Codex\skills-vault\docs\architecture.md
|
||
C:\Users\wangq\Documents\Codex\skills-vault\docs\ccpe-relationship.md
|
||
C:\Users\wangq\Documents\Codex\skills-vault\registry\skills-index.md
|
||
C:\Users\wangq\Documents\Codex\skills-vault\skills\fix-title\SKILL.md
|
||
C:\Users\wangq\Documents\Codex\skills-vault\skills\voice-generation\SKILL.md
|
||
```
|
||
|
||
然后基于本文件细化：
|
||
|
||
1. 是否在 README 中增加“深度创作核心不进入 skills-vault”的说明。
|
||
2. 是否在 registry 中增加 writing/video 支撑类候选 Skill。
|
||
3. 是否检查 `voice-generation` 与 `video-workbench` 的连接说明。
|
||
4. 是否补一个跨项目安装/同步策略。
|
||
|
||
## 5. 项目调整目标
|
||
|
||
`skills-vault` 应成为五库体系中的自动化边界阀：
|
||
|
||
```text
|
||
能被测试的低不确定性动作进 skills-vault。
|
||
需要专家判断的深度认知工作不要进 skills-vault。
|
||
```
|
||
|
||
这能防止把深度创作错误地包装成“Skill”，也能避免实用小工具散落在各项目里。
|