如何写一份真正好用的 SKILL.md：结构、示例与 5 个常见坑

by 小K·2026-06-28·8 min 读

Skill 不是「更长一点的提示词」

很多人把 Skill 当成「把常用话术存成文件」。这样写出来的 SKILL.md 往往能用一两次，但换场景就失灵——因为 AI 不知道边界在哪、失败怎么办、输出长什么样。

一份好的 Skill 应该像给新同事的 SOP：有目标、有步骤、有检查清单、有反例。

假设你要写「提交前代码审查」：

本站「代码审查助手」就是这类 Skill 的典型——你可以在详情页复制它的安装提示词，对照上面的结构拆解学习。

把 Skill 装到 Claude Code 或 Cursor，用 3 个边界 case 测：

通过后再发布或分享给团队。askskill 的「创造模式」可以按你的描述生成初稿，但最后的边界与验收标准仍建议人工改——那是 Skill 可信度的来源。

按安全 / 性能 / 可维护性三维审查代码，给出可落地修改建议。

三端都能用 Skill，但目录、触发方式、与 MCP 的配合并不一样。这篇按客户端逐项对照，帮你一次配对。

让 AI 查库很有用，但读写权限、网络暴露、凭证轮换都是真实风险。这篇给一套可落地的最小权限配置清单。

「PDF」「数据库」搜出一堆无关结果？语义搜索理解意图，用自然语言描述任务即可。这篇解释原理，并给可复制的提问模板。

$ ~/blog/how-to-write-a-good-skill-md

🎓 教程

by 小K·2026-06-28·8 min 读

一份好的 Skill 应该像给新同事的 SOP：有目标、有步骤、有检查清单、有反例。

假设你要写「提交前代码审查」：

本站「代码审查助手」就是这类 Skill 的典型——你可以在详情页复制它的安装提示词，对照上面的结构拆解学习。