Prompt file imported from zls3434/Software-Engineering-Studios (
.windsurf/workflows/skill-improve.md). Copyright stays with the author.
/skill-improve — 使用测试-修复-重测循环改进技能,运行 skill-test 识别问题,提出修复方案,用户批准后重写 SKILL.md 并重测验证。
触发方式
在 Cascade 对话框中输入 /skill-improve 触发此工作流。
工作流内容
skill-improve — 技能改进
技能目的
使用测试-修复-重测循环改进现有技能定义文件(SKILL.md)的质量。先运行 /skill-test 识别合规性与完整性问题,提出修复方案,经用户批准后重写 SKILL.md,再重新测试验证修复效果,确保技能定义持续改进。
参数说明
[技能名]:待改进的技能名称,对应.claude/skills/[技能名]/SKILL.md。
分阶段工作流
阶段 1:运行 skill-test 识别问题
- 输入:
[技能名]参数 - 处理:
- 使用 Glob 查找
.claude/skills/[技能名]/SKILL.md - 使用 Read 读取当前 SKILL.md 内容
- 执行与
/skill-test相同的检查逻辑:验证 YAML frontmatter 字段(name / description / allowed-tools / model) - 验证 markdown body 完整性(工作流阶段 / 协作协议 / 推荐下一步 / 最少行数)
- 汇总全部问题清单
- 使用 Glob 查找
- 输出:问题清单
阶段 2:提出修复方案
- 输入:问题清单
- 处理:
- 为每个问题设计具体修复方案
- 区分必需修复(缺失必需字段)与可选改进(格式优化、内容增强)
- 评估每项修复对现有技能行为的影响
- 整理修复方案清单
- 输出:修复方案清单
阶段 3:用户批准
- 输入:修复方案清单
- 处理:
- 通过 AskUserQuestion 向用户展示全部修复方案
- 逐项确认用户是否同意修复
- 记录用户选择:采纳、跳过或修改方案
- 确认最终修复列表
- 输出:经批准的修复列表
阶段 4:重写 SKILL.md
- 输入:经批准的修复列表 + 当前 SKILL.md
- 处理:
- 基于修复列表逐项修改 SKILL.md 内容
- 使用 Write 写入修改后的完整 SKILL.md
- 确保修改不破坏原有的正确部分
- 保留修改前后的差异记录
- 输出:更新后的 SKILL.md
阶段 5:重测验证
- 输入:更新后的 SKILL.md
- 处理:
- 重新执行阶段 1 的全部检查逻辑
- 对比修复前后的问题清单
- 确认所有目标问题已解决
- 检查是否引入新问题
- 通过 AskUserQuestion 向用户报告验证结果
- 如仍有问题,询问是否继续下一轮改进
- 输出:重测验证报告
协作协议引用
- 遵循
docs/examples/COLLABORATIVE-DESIGN-PRINCIPLE.md用户驱动协作协议 - 修改 SKILL.md 前必须获得用户明确批准
- 参考
docs/skills-reference.md技能定义格式规范 - 参考
docs/templates/skill-test-spec.md技能测试规格模板 - 技能变更触发
validate-skill-change.shHook
推荐下一步
改进完成后,使用 /skill-test 再次验证合规性。技能变更需通过 chief-architect 审批。新技能创建可参考改进后的格式作为模板。
