1.6 KiB
1.6 KiB
Why
当前 skills 的 SKILL.md 文件内容较长（200-300 行），未遵循渐进式披露（Progressive Disclosure）原则。根据 skill 编写指南，应采用三层结构：YAML 前置元数据（触发判断）→ SKILL.md 正文（核心指令）→ references/（详细文档）。这样可以减少 token 消耗，提高 Claude 的响应效率。
What Changes
- 结构优化：为每个 skill 创建
references/目录，将详细文档、示例、错误处理等内容从 SKILL.md 正文移至 references/ - SKILL.md 精简：保留核心工作流程和关键指令，将详细说明改为链接到 references/ 中的文档
- Description 优化：确保 description 同时包含「做什么」和「何时使用」两部分，便于 Claude 判断是否加载
- lyxy-runner-python/js 保持宽泛：这两个 runner skill 的 description 需要保持宽泛，以便匹配所有 Python/JS 处理任务
Capabilities
New Capabilities
skill-progressive-disclosure: 定义 skill 渐进式披露的三层结构规范，包括 YAML 前置元数据、SKILL.md 正文、references/ 目录的职责划分和内容组织方式
Modified Capabilities
（无现有 spec 需要修改）
Impact
- 文件结构变更：每个 skill 目录新增
references/子目录 - SKILL.md 重构：4 个 skills 的 SKILL.md 文件需要精简，详细内容迁移到 references/
skills/lyxy-runner-python/SKILL.mdskills/lyxy-runner-js/SKILL.mdskills/lyxy-reader-office/SKILL.mdskills/lyxy-kb/SKILL.md
- 向后兼容：功能不变，仅优化文档结构，无破坏性变更