一、先问一个问题你还在 调教AI 吗帮我写周报要简洁专业 不对太干了加数据 再加点行业洞察 还是不行换个风格这是 2025 年最常见的用法 ——把 AI 当员工靠对话一点点调教。但到了 2026 年这个方式已经明显落后了。原因是 2025 年底发生了一件大事Anthropic 在 12 月把 Agent Skills 正式发布为开放标准agentskills.ioOpenAI、微软全部跟进到 2026 年初公开市场上已经有4 万多个 Skill 在流通。它已经成为 2026 年面试的必考话题。而这一切的核心就是一个不起眼的文件SKILL.md。二、SKILL.md 是什么为什么它比提示词强一句话提示词是一次性对话Skill 是可复用的能力封装。提示词的问题在于每次都要重新写无法沉淀换一个 AI 工具Claude → Cursor → Codex就全部失效只能 说不能 做—— 调不动脚本和工具。而一个 Agent Skill 的结构是这样的plaintextmy-skill/ ├── SKILL.md # 技能的说明书YAML 元数据 Markdown 指令 ├── scripts/ # 可执行的脚本 ├── reference/ # 参考资料按需加载 └── assets/ # 模板、静态资源Agent 只按需加载不把整个技能塞进上下文—— 这就是它和 把一大段提示词贴进对话 的本质区别。官方管这叫四级渐进式披露先看到技能名字这里有个技能叫 weekly-report需要时加载元数据它能做周报要执行时读取指令和引用文档最后才执行脚本上下文窗口不被浪费技能可以做到很大、很深。三、手写一个你自己的 SKILL.md完整示例光说不练假把式。我们写一个周报生成器技能让 AI 自动读 git 提交记录、生成周报。第一步建目录plaintextweekly-report/ ├── SKILL.md └── scripts/ └── git_summary.py第二步写 SKILL.md这是核心YAML 头 Markdown 指令markdown--- name: weekly-report description: 读取当前 Git 仓库的提交记录生成结构化的周报。当用户说写周报/汇总这周的工作/生成周报时使用。 --- # 周报生成器 ## 什么时候用 用户要求生成周报、日报或汇总某段时间的 Git 提交时使用。 ## 步骤 1. 先运行 python scripts/git_summary.py 获取提交统计 2. 根据输出整理为周报包含本周完成、技术要点、下周计划三部分 3. 用简洁、专业的中文输出不要出现AI 生成字样 ## 注意 - 如果脚本报错先检查是否在 Git 仓库内 - 周报不要编造数据只基于脚本真实输出第三步写辅助脚本python# scripts/git_summary.py import subprocess import sys from datetime import datetime, timedelta def git_log(since: str) - str: 获取指定日期以来的 git 提交记录 cmd [git, log, f--since{since}, --prettyformat:%h|%an|%ad|%s, --dateformat:%m-%d] try: out subprocess.run(cmd, capture_outputTrue, textTrue, checkTrue) return out.stdout except subprocess.CalledProcessError as e: return fERROR: {e.stderr} if __name__ __main__: days int(sys.argv[1]) if len(sys.argv) 1 else 7 since (datetime.now() - timedelta(daysdays)).strftime(%Y-%m-%d) print(f# 最近 {days} 天提交记录\n) print(git_log(since) or 无提交记录)第四步让 Agent 用起来Claude Code放进.claude/skills/weekly-report/自动发现Cursor放进.cursor/skills/weekly-report/任意 AgentLangGraph 等读SKILL.md后按指令调用脚本这就是全部 ——一个文件夹 一个 SKILL.md 一个脚本你的 AI 就从 会聊天 变成 会干活 了。四、为什么 2026 年它必然爆火标准统一了同一个 SkillClaude Code、Cursor、Codex、Gemini 都能用不再为每个工具重写提示词生态起来了公开 marketplace 上 4 万 个 Skill从 Excel 处理到代码审查全都有开箱即用Python 开发者直接受益微软 2026 年 7 月发布了 Agent Framework 的 Agent Skills for Python和 LangChain/LangGraph 无缝衔接国产生态也在跟进2026 服贸会上中国电信的 TeleAgent 已经积累了数万个 Skill其中九成是用户自己贡献的 ——把自己的工作流变成 Skill 正在成为全民行为。五、但是这 3 个坑必须知道Skill 爆发太快安全已经跟不上Snyk 的 ToxicSkills 审计发现扫描的 Skill 中13.4% 存在严重安全问题—— 恶意脚本、数据外泄社区 SkillT1 级默认只有 指令 隔离环境厂商认证T4 级才有完整能力 ——别盲目信任下载的 Skill写 Skill 时注意不要把密钥、绝对路径、敏感业务信息写进 SKILL.md它会被 Agent 加载进上下文。安全建议从官方仓库agentskills.io、Anthropic 官方示例起步自己的 Skill 只用最小权限脚本。六、总结表格提示词SKILL.mdAgent Skill形态一次性对话文本可复用、可版本管理的文件 脚本跨工具每换一个工具重写一份到处用能力边界只能 说能 说 也能 做执行脚本上下文开销每次全量占用四级渐进式按需加载生态无4 万 现成技能2026 年程序员的核心竞争力已经从 会写提示词 变成了 会封装 Skill。趁面试还会考、生态还在爆发期现在动手写第一个自己的 SKILL.md正是时候。如果觉得有用点个赞收藏关注我下期写《Skill 的安全分级 T1-T4 全解析》—— 评论区告诉我你最想看的 Skill 实战。