knowledge-vault/discussions/technology/Codex/0.规划与重构/2026-06-15/05-skills-vault调整意见.md

4.2 KiB
Raw Blame History

skills-vault 调整意见

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 的基本特征:

输入清楚
输出清楚
行为可测试
边界明确
可跨 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 注册”

现有文档已经写清楚:

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 或新文档中增加候选区:

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 后,建议新会话先读:

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-generationvideo-workbench 的连接说明。
  4. 是否补一个跨项目安装/同步策略。

5. 项目调整目标

skills-vault 应成为五库体系中的自动化边界阀:

能被测试的低不确定性动作进 skills-vault。
需要专家判断的深度认知工作不要进 skills-vault。

这能防止把深度创作错误地包装成“Skill”也能避免实用小工具散落在各项目里。