关于 skill-integrator
skill-integrator 会分析项目上下文和已安装的 skills,并生成按触发情境编写的指导,供写入 CLAUDE.md 或 AGENTS.md。它面向希望 Agent 能在适当时机调用现有 skills 的项目维护者。
主要功能
- 01分析项目类型与上下文
- 02扫描已安装的 skills
- 03生成触发式指导内容
- 04更新过时的 skill 指导
适用场景
- 01为新项目生成 skill 指导
- 02安装新 skill 后补充指导
- 03根据当前 inventory 重建指导
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jwynia/ agent-skills --skill skill-integrator安装后在 Claude Code 中输入/skill-integrator确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
data/project-patterns.jsonscripts/analyze-project.tsgenerate-guidance.tsscan-skills.ts详细介绍
技能集成器:在需要时呈现技能
你负责弥合已安装技能与 Agent 认知之间的差距。你的职责是分析项目上下文,评估已安装技能的相关性,并生成基于触发条件的可操作指南,将其插入 CLAUDE.md 或 AGENTS.md。
核心原则
只有当 Agent 知道何时使用技能时,技能才能发挥作用。 如果 Agent 不知道每项技能适用于什么情况,那么安装一百项技能也毫无用处。此技能会将沉默的技能清单转化为主动的上下文指南。
快速参考
| 情况 | 命令 |
|---|---|
| 首次设置 | /skill-integrator → 生成完整指南部分 |
| 安装技能后 | /skill-integrator <skill-name> → 添加单项技能 |
| 指南似乎已过时 | /skill-integrator → 根据当前清单重新生成 |
| 查看脚本的作用 | 在任意脚本上使用 --help 标志 |
工作流:
deno run --allow-read scripts/analyze-project.ts --json > /tmp/ctx.json
deno run --allow-read scripts/scan-skills.ts --json > /tmp/skills.json
deno run --allow-read scripts/generate-guidance.ts --project-context /tmp/ctx.json --skills /tmp/skills.json
状态
状态 SI0:未集成
症状: 项目在 .claude/skills/ 中安装了技能,但 CLAUDE.md/AGENTS.md 中没有技能指南部分。Agent 在不了解可用工具的情况下工作。
关键问题: 安装了多少项技能?这是哪种项目类型?CLAUDE.md 是否存在?
干预措施: 运行完整分析工作流:analyze-project → scan-skills → generate-guidance。生成全面的、基于触发条件的指南部分。提交给用户插入。
状态 SI1:集成已过时
症状: 已存在技能指南部分(查找 ``
评论
支持 Markdown