Skill ≠ 代码，以 Python 信条和 Skill 反信条为例

· Python：Simple is better than complex，Skill：Skill 是文件夹，复杂性是特性 · Python：Explicit is better than implicit，Skill：激活靠隐式模式匹配 + 渐进披露 · Python：Sparse is better than dense，Skill：每 token 都要榨出最大信号 · Python：特例不应破坏规则，Skill：Gotchas 才是最高价值内容 · Python：容易解释的实现是好实现，Skill：容易解释的，模型已经会了 → 删掉

Skill 的四重定义

1. Skill 是目录（不是单文件） · 标准结构：SKILL.md + scripts/ + references/ + assets/ + config.json · 复杂领域用多级层次。例：美国税法有 1945 个 IRC 条款，扁平加载比不加载效果更差；分三级嵌套后才可用。但层次本身有代价，需要导航工具（quick reference、自定义检索）来对冲间接性。

2. Skill 是格式 · frontmatter 必须有 name（小写、连字符、与目录同名）和 description。 · description 是路由触发器，不是文档。常见错误：写「This Skill does X」；正确写法是「Load when …」。 · depends：用于级联依赖；运行时元数据可用辅助 JSON/YAML 隔离，避免污染上下文。

3. Skill 是可调用的 · 加载流程：load_skill（） → 拷贝目录入沙箱 → 递归装依赖 → 剥离 frontmatter，仅暴露 body 与附属文件。

4. Skill 是渐进式的（这是最重要的成本模型） · Index：所有 Skill 的 name+description；~100 tokens/Skill；每次会话、每个用户、永远 · Load：SKILL.md body；~5，000 tokens；一次加载，会话内持续占用 · Runtime：scripts / references / 子 Skill；无上界；仅模型实际读取时

→ 越靠上的层，每个字越贵。Index 是「奢侈品柜台」，Runtime 是「无限仓库」。

什么时候不需要 Skill

反复强调「Every Skill is a tax」。三类典型滥用： · 模型已会的：写一串 git 命令 → 是好文档，是坏 Skill。 · 重复 system prompt 的：通用知识应进全局上下文，不该走条件加载。 · 变化太快的：远端 MCP 工具版本频繁变 → Skill 会漂移导致幻觉。 · 判断单句是否该留的尺子：「没有这句话，Agent 会做错吗？」答否即删。

引用 Pascal：「这封信写得长，是因为我没时间写短。」 -- 写短 Skill 很难；写得快的 Skill 大概率有问题。还引了一篇研究：LLM 自生成的 Skill 平均无收益，因为模型无法可靠地把"自己消费有用的程序性知识"写出来。

构建五步法（顺序不可调）

Step 0 - 先写 Evals：源自真实查询、已知失败、邻域混淆。负例往往比正例更重要。

Step 1 - 写 Description（最难的一行）： · 以 "Load when…" 开头，≤ 50 词 · 描述用户意图（用真实抱怨语：「babysit」「watch CI」「make sure this lands」） · 不要总结工作流 · 唯一目标：路由准确，最小化对其他 Skill 的回归影响

meng shao@shao__meng · X

77导出 Markdown

2026-05-09 21:01·54天前

在 X 看原推· x.com

AI 摘要

Perplexity 公开其Agent技能设计方法论，核心观点是技能设计并非传统编程，而是“为模型构建上下文”。其反直觉原则包括：技能是目录而非单文件，复杂性是特性；激活依赖隐式模式匹配；内容需榨取每token最大信号；记录陷阱（Gotchas）比罗列指令更有价值。设计遵循严格五步法，首要步骤是创建评估集，并以“Load when...”格式撰写精准描述进行路由。维护采用“仅追加为主”的飞轮，依靠持续添加Gotchas提升性能，并警惕新增技能可能无声降低现有技能性能的默认风险。

Perplexity 团队内部 Agent Skills 设计、迭代与维护之道

Perplexity Agents 团队的内部规范公开版，核心论点很反直觉：写 Skill 不是写代码，而是为模型构建上下文。把工程师写代码的本能直接套到 Skill 上，几乎一定会失败。 https://research.perplexity.ai/articles/designing-refining-and-maintaining-agent-skills-at-perplexity

Skill ≠ 代码，以 Python 信条和 Skill 反信条为例

Skill 的四重定义

什么时候不需要 Skill

构建五步法（顺序不可调）

Skill ≠ 代码，以 Python 信条和 Skill 反信条为例

Skill 的四重定义

维护：Gotchas 飞轮

关键 takeaway

什么时候不需要 Skill

构建五步法（顺序不可调）

维护：Gotchas 飞轮

关键 takeaway