关于 self-improvement
self-improvement 是用于将反馈和更正记录到仓库文档与技能中的技能。它会分类变更、在编辑前征求确认,并将更新纳入当前工作分支。
主要功能
- 01分类反馈并确定目标文件
- 02预览变更并请求确认
- 03更新文档和技能
- 04创建并注册新技能
- 05检查各处更正是否完整
适用场景
- 01记录实现过程中发现的错误
- 02整理仓库中反复出现的工作模式
- 03将多步骤工作流整理为技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ionfury/ homelab --skill self-improvement安装后在 Claude Code 中输入/self-improvement确认已加载。
附带文件references/classification.mdtests.yaml
详细介绍
自我改进技能
捕获反馈与修正,持续增强仓库知识。
理念
工作中获得的知识应当立即捕获,而不是任其流失。文档更新与揭示它们的工作相辅相成——将它们包含在当前分支中,而不是单独的 PR。
执行流程
阶段 1:对反馈进行分类
完整的信号 → 分类 → 目标映射,以及用于查找正确文件的决策树,请参见 references/classification.md。
简要总结:修正用于修复现有文档。新模式放入模块 CLAUDE.md 或技能。反模式放入根 CLAUDE.md。包含 5 个以上步骤的工作流应成为技能。
阶段 2:应用前确认
在做出更新前始终使用 AskUserQuestion。 呈现:
- 分类后的反馈类型和建议的目标位置
- 拟议更改的预览
- 不确定时的备选方案
阶段 3:应用更新
CLAUDE.md 更新:读取文件 → 找到合适的章节 → 在保持现有风格和结构的前提下添加内容。
技能更新:读取现有的 SKILL.md → 确定相关章节 → 添加或修改 → 如有需要则更新引用。
新技能:创建带有正确 frontmatter 的 SKILL.md,添加到 .claude/agents/ 中相关 Agent 的 skills: 列表,添加到 .claude/settings.json 允许列表。
修正:找到错误信息的所有出现位置 → 逐一更新 → 验证不会产生损坏的引用。
如果不确定放置位置,请询问而不是猜测。如果目标文件不存在,请询问是创建它还是寻找替代位置。如果更新内容较多(重写某个章节),请预览完整更改,并考虑是否值得将其作为单独的技能。
与 PR 工作流的集成
文档更新是当前工作的一部分。将相关的代码和文档更改归入同一批提交中。对于实现过程中发现的新模式,主动建议更新文档。
主动调用
在以下情况调用此技能:
- 完成实现工作且其中出现了新模式
- 同一概念已被解释过两次(将其捕获)
- 用户在任务进行中纠正了某个做法
- 发现了未记录的行为
交叉引用
- references/classification.md — 反馈分类表和目标位置决策树