技能构建器

边写技能文件，边检查那个决定它会不会被用到的字段。

技能说明往往写着你们团队的做事方式。一切都在浏览器里编辑，不会上传。

检查你已有的技能

关于 技能构建器

一个技能就是一个装着 SKILL.md 的文件夹：一小段 YAML 头部，加上 Markdown 写的说明。人们把时间花在说明上，但决定这些说明会不会被读到的，是描述。描述会与手头的任务做匹配，所以一段只说清技能是关于什么、却从不说何时该用它的描述，会无限期地闲置下去——而且没有任何报错告诉你原因。这个构建器会写出文件，并对这一个字段查得最严：它有没有点明触发时机、够不够长到能被匹配上、开头几个字是不是白白浪费了。名称会对照文件夹命名规则检查，说明则对照那个"低于此长度基本不起作用"的界线。

功能特性

• 按文件夹规则检查名称，并给出改好的写法
• 检查描述里有没有触发语句——真正促成匹配的正是它
• 描述短到承载不了信号时发出警告
• 可选的工具白名单，靠勾选而不是靠记忆输入
• 把阻断性错误与建议分开的评分
• 文件该放的确切路径
• frontmatter 正确加引号，描述里的冒号不会把值切开
• 可直接下载为 SKILL.md

如何使用 技能构建器

1. 用小写字母加连字符给技能命名
2. 写一段既说做什么、也说何时用的描述
3. 用 Markdown 写说明
4. 读完提示，下载 SKILL.md

示例

输入

name: release-notes

输出

description: Writes release notes from a range of git commits. Use when the user asks for a changelog.

"当……时使用"这句话，才把一个主题变成触发条件。

常见错误与故障排除

• 技能好像从来没被用过。 — 几乎总是描述的问题。它必须说清何时适用，而且要用人真正会说的词：文件类型、任务名称、别人会敲出来的说法。
• 名称被拒绝。 — 它同时也是文件夹名，所以只能用小写字母、数字和单个连字符。不合规时会给出改好的写法。
• 描述里有冒号，文件就坏了。 — 本不该如此——需要时值会被加上引号。如果之后手工改文件，请把含"冒号加空格"的值用引号括起来。
• 技能能加载，却什么都没改变。 — 极短的说明基本不会改变行为。写清要产出什么、怎么做、不要做什么。

常见问题

什么样的技能描述才算好？

它用一两句话回答两个问题：这个技能做什么，以及何时该用。被拿去匹配的是后半句，所以要点出文件类型、任务本身，以及人们真会用的说法。"帮你处理文档"跟什么都对不上。

文件放在哪里？

放在一个与技能同名的文件夹里，位于 skills 目录之下。路径显示在编辑器下方，会随你输入名称而更新。文件夹名和 name 字段应当一致。

要不要设置工具白名单？

只有当技能确实用不上会话已有的那么多工具时才需要。留空表示继承可用的一切，多数情况下这正是你想要的；收窄它，是让专注的技能保持专注的办法。

说明应该写多长？

长到足够具体，不必更长。几句话很难改变行为；好几页则会被略读。带小标题的分节比一大块文字更经得起修改。

文件在别处会被校验吗？

加载器会照单全收一个描述很弱的文件——问题恰恰在这里。之后没有任何东西告诉你这个技能根本匹配不上，所以检查该放在发布之前。

相关工具

• 技能检查器 — 粘贴 SKILL.md，看清是什么让它无法与任务匹配。
• 子代理构建器 — 生成子代理定义文件，含工具与模型设置。
• 斜杠命令构建器 — 构建自定义命令，带参数与工具白名单。
• 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。
• 插件清单构建器 — 生成 plugin.json，并查看它所预设的目录结构。
• 系统提示检查器 — 找出自相矛盾、无效指令与未替换的占位符。

更多AI 与智能体工具

• 技能检查器 — 粘贴 SKILL.md，看清是什么让它无法与任务匹配。
• 子代理构建器 — 生成子代理定义文件，含工具与模型设置。
• 斜杠命令构建器 — 构建自定义命令，带参数与工具白名单。
• 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。
• 插件清单构建器 — 生成 plugin.json，并查看它所预设的目录结构。
• 钩子构建器 — 构建 settings.json 钩子，找出永远不会触发的匹配式。
• 权限规则测试器 — 用真实命令测试允许、询问与拒绝规则。
• MCP 服务器配置 — 为 stdio、HTTP 或 SSE 生成 MCP 服务器条目。
• MCP 工具模式构建器 — 定义工具并得到 JSON Schema，严格模式一并校验。
• 工具模式校验器 — 粘贴工具定义，查清它为何被拒绝或被错误调用。
• 提示模板填充 — 把一条提示展开到整张表格，并看清缺了哪些值。
• 系统提示检查器 — 找出自相矛盾、无效指令与未替换的占位符。
• 提示差异比较 — 逐词比较两个提示版本，并给出 token 差额。
• 少样本示例构建器 — 把输入输出对转成带标签、JSON 或对话格式的示例。
• XML 提示分节构建器 — 用内容无法越出的标签包裹提示的各个部分。
• JSONL 查看与校验 — 逐行读取、筛选并检查 JSONL 文件。
• 对话记录转换 — 把消息数组转成可读记录，也能转回去。
• 微调数据集校验 — 检查 chat 格式 JSONL，找出会中断训练的错误。
• SSE 流查看器 — 粘贴原始流式响应，取回正文、工具调用与用量。
• 上下文窗口规划 — 在提示、工具、历史与回复之间分配上下文窗口。
• 提示缓存规划 — 重排请求的各块，让可缓存前缀尽可能长。
• 文本切分 — 把文档切成有重叠的片段，只在真正的边界处断开。
• 代理循环成本估算 — 逐轮估算成本，计入重发的历史与缓存。
• 批量请求构建器 — 把表格转成批量任务，每条请求都有唯一 id。

查看全部AI 与智能体工具 · 全部工具