关于 heal-skill
heal-skill 用于根据执行中发现的问题修订 Agent 技能文件。它会分析问题、展示修改提案并征求批准,之后才应用变更,并可选择提交。
主要功能
- 01从对话识别技能
- 02分析问题与根因
- 03展示修改前后差异
- 04获批后编辑文件
- 05可选择提交变更
适用场景
- 01修正技能中的过时说明
- 02处理执行中发现的错误
- 03审阅相关文件的修改提案
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill heal-skill安装后在 Claude Code 中输入/heal-skill确认已加载。
详细介绍
根据执行过程中发现的修正,更新技能的 SKILL.md 和相关文件。
分析对话,判断当前运行的是哪个技能,反思出了什么问题,提出具体修复方案,征求用户批准,然后应用更改,并可选择提交。
技能检测:!`ls -1 ./skills/*/SKILL.md | head -5`<quick_start>
- 检测技能:根据对话上下文判断(调用消息、最近引用的 SKILL.md)
- 反思:分析出了什么问题,以及如何发现修复方法
- 展示:提供拟议更改及修改前后的差异
- 征求批准:获得批准后再进行任何编辑
- 应用:应用更改,并可选择提交
</quick_start>
根据对话上下文识别技能:- 查找技能调用消息
- 检查最近引用的是哪个 SKILL.md
- 查看当前任务上下文
设置:SKILL_NAME=[skill-name] 和 SKILL_DIR=./skills/$SKILL_NAME
如果无法确定,请询问用户。 </step_1>
<step_2 name="reflection_and_analysis"> 如果提供了 $ARGUMENTS,则重点分析该参数;否则分析更广泛的上下文。
确定:
- 问题所在:引用 SKILL.md 中有误的具体内容
- 发现方式:Context7、错误消息、反复试验或查阅文档
- 根本原因:API 已过时、参数不正确、端点错误或缺少上下文
- 影响范围:单个部分还是多个部分?是否影响相关文件?
- 拟议修复:涉及哪些文件、哪些部分,以及每处修改前后的内容 </step_2>
<step_3 name="scan_affected_files">
ls -la $SKILL_DIR/
ls -la $SKILL_DIR/references/ 2>/dev/null
ls -la $SKILL_DIR/scripts/ 2>/dev/null
</step_3>
<step_4 name="present_proposed_changes"> 按以下格式展示更改:
**Skill being healed:** [skill-name]
**Issue discovered:** [1-2 sentence summary]
**Root cause:** [brief explanation]
**Files to be modified:**
- [ ] SKILL.md
- [ ] references/[file].md
- [ ] scripts/[file].py
**Proposed changes:**
### Change 1: SKILL.md - [Section name]
**Location:** Line [X] in SKILL.md
**Current (incorrect):**
[当前文件中的准确文本]
**Corrected:**
[新文本]
**Reason:** [why this fixes the issue]
[repeat for each change across all files]
**Impact assessment:**
- Affects: [authentication/API endpoints/parameters/examples/etc.]
**Verification:**
These changes will prevent: [specific error that prompted this]
</step_4>
<step_5 name="request_approval">
Should I apply these changes?
1. Yes, apply and commit all changes
2. Apply but don't commit (let me review first)
3. Revise the changes (I'll provide feedback)
4. Cancel (don't make changes)
Choose (1-4):
等待用户回复。未经批准不得继续。 </step_5>
<step_6 name="apply_changes"> 仅在获得批准后(选项 1 或 2):
- 使用 Edit 工具,在所有文件中应用每项修正
- 重新读取修改后的部分以进行验证
- 如果选择了选项 1,则使用结构化提交说明,明确说明修复了什么
- 列出文件并确认完成 </step_6>
<success_criteria>
- 根据对话上下文正确检测技能
- 通过修改前后对比找出所有错误内容
- 应用修改前获得用户批准
- 完成 SKILL.md 和相关文件中的所有编辑
- 通过重新读取确认更改已应用
- 如果选择了选项 1,则已创建提交
- 列出文件并确认完成 </success_criteria>
- 重新读取每个修改部分,确认更改已应用
- 确保跨文件内容一致(SKILL.md 中的示例与 references/ 中的内容相符)
- 如果选择了选项 1,验证 Git 提交已创建
- 检查是否修改了非预期文件
评论
支持 Markdown