SuperAPI AI 工具集

improve-skill

通用与其它

查看项目

更新于 10-16 00:05

技能介绍

用途:improve-skill 用于根据刚刚发生的对话,增量改进其他 fabrik 技能。其前提是每次真实会话都是一次免费的用户研究:如果某个技能表现不佳(建议不完整、用户不得不手动追问、该触发时未触发),这就是值得转化为具体改进的信号。该技能收集这些信号,并在修复明确时以 PR、在观察真实但修复不明确时以 issue 的形式提交回 maragudk/fabrik。

使用方式:主要由用户主动调用,例如运行 /improve-skill,或说“把 X 技能改得更好”“brainstorm 技能应该少问几个问题”“这个技能漏了东西”。用户也可以自带想修复的想法,该想法会加入发现列表,而不是替代对话中得出的发现。仅在存在具体信号时,才在会话结束时主动建议,例如用户纠正了来自技能指导的输出、用户手动要求了技能本应主动完成的事、助手补充了本属于另一个技能职责的知识(漏触发)、被调用技能产出过时内容或与其他技能矛盾。没有信号就不建议,默认保持安静。

不适用:从零编写新技能应使用 skill-creator;修复用户项目中的代码 bug 属于普通编辑;fabrik 的通用代码库整理属于 garden。该技能只编辑 skills/*/SKILL.md 及其引用的子文件。

流程:第一步,回顾当前对话,收集候选技能及信号类型,包括纠正、本应覆盖的手动请求、漏触发以及其他值得标记的问题。第二步,以“[skill-name]: [观察] -> [变更类型]”的一行格式向用户展示发现,询问要处理哪些,并接受用户补充;若无发现则明确说明并停止,不制造工作。第三步,将接受的发现分类为具体修复(进入 PR)或模糊/重构(先在聊天中讨论,收敛则发 PR,否则发 issue)。第四步,准备 fabrik 工作副本:优先使用 ~/Developer/fabrik,不要直接编辑用户主检出,可用 git -C ~/Developer/fabrik worktree add ../fabrik-improve-skill-<slug> -b improve-skill/<slug> 创建工作树;否则克隆到临时目录。分支名为 improve-skill/<slug>。编辑前需显式阅读仓库根目录的 AGENTS.md 并遵循其约定。第五步,提交、推送并打开 PR 或 issue,PR 正文使用“What was observed / What changed / Why”,issue 正文使用“What was observed / Why this is worth discussing / Partial ideas”,每个模糊发现一个 issue,标题为 improve-skill: <skill-name> <one-line summary>。完成后回报 URL,后续评审与合并由用户决定。

限制:该技能只编辑技能文件,不处理用户项目代码 bug 或 fabrik 通用整理;默认一次调用一个 PR,但用户可要求逐条处理;编辑应保持外科手术式,大改写应先开 issue;不要为凑数而填充内容。