# 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”，也能避免实用小工具散落在各项目里。