skill-refiner
修炼 (Skill Refiner)
技能修炼系统,对任意技能进行反复打磨改进,直到达到最优状态。
Quick Commands
命令:功能说明
/修炼 <技能名>:对指定技能进行修炼 /修炼 <技能名> --depth deep:深度修炼 /修炼 <技能名> --aspect <维度>:针对特定维度修炼 /修炼 --all:修炼所有技能 /refine :Refine a specific skill
修炼维度
对技能进行全方位审视,从以下维度进行改进:
1. 完整性 (Completeness)
检查项:
- SKILL.md 是否有完整的 YAML frontmatter
- 是否有清晰的功能描述
- 是否有使用示例
- 是否有规则文件支持
- 是否有配置选项说明
2. 可读性 (Readability)
检查项:
- 文档结构是否清晰
- 标题层级是否合理
- 是否有冗余内容
- 语言是否简洁明了
- 是否有错别字或语法错误
3. 实用性 (Practicality)
检查项:
- 是否解决了实际问题
- 规则是否可执行
- 示例是否真实可用
- 是否有边界情况处理
- 是否有错误处理指导
4. 一致性 (Consistency)
检查项:
- 命名风格是否一致
- 格式风格是否一致
- 与其他技能的风格是否统一
- 中英文版本是否对应
5. 可扩展性 (Extensibility)
检查项:
- 是否易于添加新规则
- 是否支持自定义配置
- 是否预留扩展接口
修炼流程
四个阶段:诊断、方案、修炼、验证。
第一阶段:诊断
- 读取技能文件
- 分析各维度得分
- 识别主要缺陷
- 生成诊断报告
第二阶段:方案
- 针对缺陷生成改进方案
- 评估方案可行性
- 确定改进优先级
- 生成改进计划
第三阶段:修炼
- 按计划执行改进
- 重新评估各维度得分
- 检查是否达标
- 未达标则继续迭代
第四阶段:验证
- 模拟使用场景测试
- 检查改进效果
- 生成修炼报告
- 建议后续优化方向
评分标准
各维度评分说明(0-100):
90-100分为优秀:该维度表现卓越,无需改进 80-89分为良好:该维度表现良好,可微调 70-79分为合格:该维度表现一般,建议改进 60-69分为较差:该维度有明显缺陷,必须改进 0-59分为不合格:该维度严重缺失,需重构
综合评分计算方式: 综合评分 = 完整性 × 0.25 + 可读性 × 0.20 + 实用性 × 0.30 + 一致性 × 0.15 + 可扩展性 × 0.10
达标标准:综合评分 ≥ 80,各维度评分 ≥ 70,无明显缺陷。
修炼策略
策略1:快速修炼
适用情况:时间有限,只需修复明显问题。
步骤:
- 快速扫描,识别明显缺陷
- 只修复关键问题
- 简单验证后完成
策略2:标准修炼
适用情况:常规改进,提升整体质量。
步骤:
- 全面诊断,生成详细报告
- 制定改进计划
- 逐项执行改进
- 迭代验证,直到达标
策略3:深度修炼
适用情况:需要根本性改进。
步骤:
- 深度分析,理解技能本质
- 重新设计结构和规则
- 全面重写或重构
- 多轮迭代验证
- 生成完整修炼报告
修炼报告模板
修炼报告格式:
修炼时间:{timestamp} 修炼模式:{快速/标准/深度}
诊断结果表格:维度、修炼前、修炼后、变化
主要改进:列出主要改进项
修改文件:列出修改的文件及修改说明
待优化项:列出未优化的项目
建议:后续建议
使用示例
示例1:标准修炼
用户输入:/修炼 humanizer
诊断阶段:正在分析 humanizer 技能,诊断结果为完整性85(良好)、可读性78(合格,文档过长建议精简)、实用性88(良好)、一致性72(合格,与其他技能风格不一致)、可扩展性80(良好)、综合81(达标但有改进空间)。
主要缺陷包括:SKILL.md 文档过长可读性不佳、规则文件命名不够规范、缺少快速上手指南。
方案阶段生成改进计划:精简 SKILL.md 提取核心内容、重命名规则文件统一命名规范、添加 Quick Start 章节、调整文档结构与其他技能对齐。
修炼阶段执行改进并验证效果。
示例2:深度修炼
用户输入:/修炼 power-iterate --depth deep
诊断阶段深度分析 power-iterate 技能,诊断结果为完整性90(优秀)、可读性75(合格,结构复杂理解门槛高)、实用性85(良好)、一致性80(良好)、可扩展性70(合格,扩展机制不够灵活)、综合80(达标)。
深层问题包括:自主执行机制不够完善、预算管理策略缺乏灵活性、错误处理机制不足、与其他技能的集成不够。
核心改进包括:重构自主执行循环增强决策能力、引入动态预算调整机制、完善错误处理和恢复策略、设计技能集成接口。
迭代执行重构自主执行循环、动态预算调整、错误处理机制、技能集成等四项改进,最终综合评分提升至89。
Rules
- rules/diagnosis.md:诊断规则
- rules/improvement.md:改进策略
- rules/validation.md:验证方法
- rules/templates.md:模板库
配置选项
参数默认值说明:
depth:standard,修炼深度,可选 quick/standard/deep target_score:80,目标综合评分 max_iterations:5,最大迭代次数 aspects:all,修炼维度,可选 all 或指定维度