📌 项目地址：agentskills/agentskills | ⭐ 19,604 颗星 | 🔧 Python | 📜 Apache-2.0
提示词工程化缺失的现场
我同时用Claude Desktop、Copilot Chat还有几个命令行AI工具。每次想让它们按我的方式写周报、检查代码、格式化数据，都得在窗口里重新粘贴一段提示词。改了逻辑要同步三个地方，下回对话忘记粘，输出又变回默认风格。
这不是工具不好，是提示词没有工程化：没有版本控制，没有复用标准，跨工具全凭手动复制粘贴。
一个文件夹就是一个技能
Agent Skills（https://github.com/agentskills/agentskills ，19604 星）把技能定义成一个文件夹，里面至少包含 SKILL.md 文件，写上元数据（name 和 description）和指令。还能附带 scripts/、references/、assets/ 等子目录。
my-skill/
├── SKILL.md # 必需：元数据 + 指令
├── scripts/ # 可选：可执行代码
├── references/ # 可选：文档
├── assets/ # 可选：模板、资源
└── ... # 任何其他文件或目录它没有SDK，没有API，产出就是纯文本加脚本。可以直接放进Git仓库，享受分支、合并、回滚。这是提示词从未有过的基础设施。
渐进式加载：挂100个技能也不撑爆上下文
README 描述了代理加载技能的三阶段：
发现：启动时只读 name 和 description，加起来不到100个token。挂100个技能，上下文几乎没增加。
激活：任务匹配某个skill的描述时，代理才读完整的 SKILL.md 进上下文。
执行：代理按指令操作，必要时运行捆绑的脚本或加载引用文件。
只有被激活的技能才占用token。我试过给Claude Desktop挂20个技能，第一次对话的回复速度和单用提示词一样快。这种“progressive disclosure”设计让挂载大量技能成为现实，上下文窗口不会被技能列表吃掉。
写好SKILL.md的三个要点
看了官方示例仓库（https://github.com/anthropics/skills ）和Discord讨论，发现新手容易把技能写成万能提示词，结果要么匹配不到，要么执行错乱。
第一，description 要精确得像开关。
有人把 code review 技能写成“帮助代理进行代码审查”。代理可能只检查缩进和命名，你需要的是审查安全漏洞。应该写：“审查Python PR中的数据泄露风险、未捕获异常、SQL注入点。” description 是代理激活的触发器，越具体越准。官方规范要求至少 name 和 description，Discord 社区建议额外加 dependencies 字段声明依赖。
第二，指令要给出步骤和验收条件。
一个“数据清洗”技能只写“清洗数据”，代理可能只去重空值。你需要写清楚：缺失值超过50%的列直接丢弃；重复行保留第一条；日期格式一律设为YYYY-MM-DD。每一步明确输出要求，代理执行完能自己判断对错。
第三，依赖声明不能漏。
如果 scripts/ 里的脚本要pandas 2.0，必须在 SKILL.md 里注明，或者把 requirements.txt 放进 references/。否则代理执行到一半报错找不到模块。我在 Discord 里看到有人踩过坑：技能调用了某个库，代理运行时报错，查半天才发现是版本不一致。现在建议在 SKILL.md 顶部加 dependencies 字段（规范未强制，但实践上强烈推荐）。
跨产品复用不再靠复制粘贴
这个格式是开放标准，由Anthropic发布。README 列出了官方维护的 Client Showcase 页面（https://agentskills.io/clients ），上面有所有兼容的产品列表。你不用为Claude写一套配置，再为Copilot写另一套。
我自己写了一个“周报生成”技能：查工时API、格式化Markdown、添加审批人清单。把它放到私有Git仓库里，Claude Desktop和Copilot Chat都能加载同一版本。上周更新了审批流程，一次commit搞定两个工具。同事在vscode上用另一个兼容的代理也能直接用——不需要额外配置。
19604个星说明需求真实
这个项目不是代码酷，是格式设计击中了两个真实痛点：跨工具同步成本高、上下文浪费。标准化文件夹结构 + 渐进式加载 + Git版本控制，把提示词从一段文本变成了可管理、可追溯、可复用的组件。
唯一的问题：写好一个skill，比写好一段提示词难。需要想清楚流程，写清楚边界，测试清楚结果。但这本来就是工程工作，不是提示工程。
如果想上手：
- 读规范文档（https://agentskills.io/specification ）几分钟看完格式细节。
- 去示例仓库（https://github.com/anthropics/skills ）挑一个贴近自己工作的技能克隆下来改。
- 有问题去Discord（https://discord.gg/MKPE9g8aUy ）问，社区活跃。
我个人的建议：从你最烦的手动重复任务开始，把提示词改写成SKILL.md。第一版不必完美，跑通后慢慢迭代成团队共享的标准。