Agent Skills
返回列表
可复用排错技能提炼器

可复用排错技能提炼器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 安装 @user_fccf428b/extract-profile-model。

技能介绍

这个技能解决什么问题

同一个部署报错在两个项目里先后出现时,第二次排查往往还是从翻聊天记录开始。知识只活在发生过的那段对话里:不可携带、没法按问题检索、下次还会重来。/si:extract 做的事,是把这类在项目间重复出现、必须经过真实调试才能解开的排错方案或工作流模式,沉淀成一份独立、可移植的 SKILL.md,装进任何仓库都能直接用。

什么时候抽取,怎么工作

满足任一特征就值得抽取:同一个问题出现在 2 个以上项目(Recurring);不是文档里写明的坑(Non-obvious);不绑定单一代码库(Broadly applicable);多步骤修复、容易遗忘(Complex solution);或用户明确提出「存成技能」「我要复用」。

流程分七步:

  1. 识别模式:读用户描述,并优先从 auto-memory 检索相关条目作为素材
  2. 界定范围:最多问 2 个问题——解决什么问题、是否需要代码示例
  3. 生成名称:小写加连字符、2–4 词,如 docker-m1-fixes、api-timeout-patterns
  4. 创建文件:交由 skill-extractor agent 实际写出技能目录
  5. 规范结构:合法的 YAML frontmatter(name 与 description)加标准正文
  6. 质量门槛:description 含 Use when: 触发条件;方案自包含;代码示例可整段复制;无硬编码路径、URL、凭据;无多余依赖
  7. 汇报结果:说明技能落盘位置与覆盖内容

命名有一条硬约束:技能名中禁止出现 claude、anthropic 保留片段,涉及 Claude Code 自身的一律改用 cc- 前缀,如 cc-settings、cc-mcp-tools;定名前先对照保留词列表校验,命中时先转换再与用户确认。

适用边界与注意点

抽取前先判断:这个方案能不能在一个陌生项目里省下时间。一个技能只解决一个问题,把人们真正会搜索的错误信息原文写进去,并试着脱离原始上下文通读一遍——读不懂就说明还不够独立。安全边界上:不自动安装依赖、不修改系统权限、不创建持久化任务、不执行下载内容;发送、发布、删除、付款、部署等外部写入,先展示目标与影响并取得明确确认;凭据只用于用户指定的官方服务,不回显、不记录、不转发;命令与代码默认仅供参考,只有在用户明确要求且目标范围清楚时才可被采纳执行。

使用场景

  • 同一构建报错在多个项目重复出现,需要把修复流程提炼成可随仓库携带的技能。
  • 每次排错都要复现多步操作,想把命令序列与踩坑点写成自包含的 SKILL.md。
  • 用户要求把一段 API bug 排查经验保存为技能,需要先界定范围再生成目录结构。
  • 排查方案依赖多语言工具链,希望抽成技能时命名合规、描述带 Use when 触发条件。

适合人员

  • 跨仓库维护多套项目的后端工程师,想把重复排错方案沉淀成可检索资产。
  • 负责团队规范的开发者体验工程师,需要统一技能命名与文档结构。
  • 频繁接盘陌生代码库的技术负责人,希望用技能固化高成本踩坑经验。
  • 搭建内部智能体平台的工程师,要求技能可移植、描述有明确触发条件。