技能创建指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/mg-skill-creator。
技能介绍
要解决的问题
很多智能体能力停在“提示词片段”或“使用说明”层面:触发条件模糊、执行步骤不可复用、脚本散落在对话里,后续维护成本高。这个技能面向的是把某类领域工作流沉淀为可自动激活的技能包:让 SKILL.md 有清晰边界,让 scripts/ 承载确定性逻辑,让 references/ 按需存放规格、清单和 API 细节,而不是一次性把所有内容塞进提示。
技能如何工作
它把技能创建拆成三步:
- 用例澄清:先确认技能支持哪些功能、用户会用什么触发语,形成明确的功能边界,避免“万能技能”。
- 调研与选型:优先检查领域最佳实践和现成 CLI 工具,如
npx、bunx、pipx,避免自写低价值代码。 - 复用规划:对每个用例判断执行路径,把需要反复运行、确定性的逻辑放入
scripts/,如rotate_pdf.py,并配测试与.env.example;把按需读取的文档、Schema、API 规格放入references/,把必要用法写入SKILL.md。
适用边界
适合新建技能、为已有技能补脚本、参考资产或扩展流程;不适合把技能写成百科文档。若目标只是保存一次性说明,直接写文档更合适;若要让智能体稳定触发并执行,才需要用它规划技能结构。
使用场景
- 将 PDF 旋转这类固定操作沉淀为技能时,划分 scripts/ 脚本与 references/ 规格。
- 优化已有技能时,检查触发语、功能边界,并补 .env.example、测试或按需读取文档。
- 新建报表处理技能前,先调研 npx/bunx/pipx 现成 CLI,决定哪些逻辑写成 Node/Python 脚本。
- 把 API 接入流程拆成可复用技能时,把 Schema、清单和错误码写入 references/。
适合人员
- 做智能体工具链的平台工程师,需要把零散提示词整理成可维护技能包。
- 负责业务自动化的工程师,需要把 PDF 处理、报表查询等固定流程封装给智能体。
- 维护 Agent 技能的团队负责人,需要统一 scripts/、references/ 与 SKILL.md 的边界。
- 使用 npx、pipx 工具链的开发者,需要判断何时用现成 CLI、何时写脚本。