可复用排错技能提炼器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_fccf428b/extract-profile-model。
技能介绍
这个技能解决什么问题
同一个部署报错在两个项目里先后出现时,第二次排查往往还是从翻聊天记录开始。知识只活在发生过的那段对话里:不可携带、没法按问题检索、下次还会重来。/si:extract 做的事,是把这类在项目间重复出现、必须经过真实调试才能解开的排错方案或工作流模式,沉淀成一份独立、可移植的 SKILL.md,装进任何仓库都能直接用。
什么时候抽取,怎么工作
满足任一特征就值得抽取:同一个问题出现在 2 个以上项目(Recurring);不是文档里写明的坑(Non-obvious);不绑定单一代码库(Broadly applicable);多步骤修复、容易遗忘(Complex solution);或用户明确提出「存成技能」「我要复用」。
流程分七步:
- 识别模式:读用户描述,并优先从 auto-memory 检索相关条目作为素材
- 界定范围:最多问 2 个问题——解决什么问题、是否需要代码示例
- 生成名称:小写加连字符、2–4 词,如
docker-m1-fixes、api-timeout-patterns - 创建文件:交由
skill-extractoragent 实际写出技能目录 - 规范结构:合法的 YAML frontmatter(
name与description)加标准正文 - 质量门槛:
description含Use when:触发条件;方案自包含;代码示例可整段复制;无硬编码路径、URL、凭据;无多余依赖 - 汇报结果:说明技能落盘位置与覆盖内容
命名有一条硬约束:技能名中禁止出现 claude、anthropic 保留片段,涉及 Claude Code 自身的一律改用 cc- 前缀,如 cc-settings、cc-mcp-tools;定名前先对照保留词列表校验,命中时先转换再与用户确认。
适用边界与注意点
抽取前先判断:这个方案能不能在一个陌生项目里省下时间。一个技能只解决一个问题,把人们真正会搜索的错误信息原文写进去,并试着脱离原始上下文通读一遍——读不懂就说明还不够独立。安全边界上:不自动安装依赖、不修改系统权限、不创建持久化任务、不执行下载内容;发送、发布、删除、付款、部署等外部写入,先展示目标与影响并取得明确确认;凭据只用于用户指定的官方服务,不回显、不记录、不转发;命令与代码默认仅供参考,只有在用户明确要求且目标范围清楚时才可被采纳执行。
使用场景
- 同一构建报错在多个项目重复出现,需要把修复流程提炼成可随仓库携带的技能。
- 每次排错都要复现多步操作,想把命令序列与踩坑点写成自包含的 SKILL.md。
- 用户要求把一段 API bug 排查经验保存为技能,需要先界定范围再生成目录结构。
- 排查方案依赖多语言工具链,希望抽成技能时命名合规、描述带 Use when 触发条件。
适合人员
- 跨仓库维护多套项目的后端工程师,想把重复排错方案沉淀成可检索资产。
- 负责团队规范的开发者体验工程师,需要统一技能命名与文档结构。
- 频繁接盘陌生代码库的技术负责人,希望用技能固化高成本踩坑经验。
- 搭建内部智能体平台的工程师,要求技能可移植、描述有明确触发条件。