写 Agent Skills 五条实操法则:description 才是触发器,不是摘要
blaizedsouza · x · 2026-11-22
Akshay 分享了一套「让 Agent Skills 真正生效」的写法,核心五条:
- 先看失败再动笔:不给 skill 跑 3 个真实任务,记下所有出错点——那份清单才是 skill 本体,其余都是废话。
- description 是触发器不是摘要:agent 在决定加载前只看名字和描述,描述含糊则全文白写。
- 「何时使用」写进 description,不要在里面概括工作流——body 只在 agent 决定后才被读,一行式摘要反而会被当成 skill 本体执行。
- 用用户真实会打的词:文件名、报错信息、工具名、懒人版提问,而不是内部黑话。
- 别解释模型已知的事(Claude 知道 PDF 是什么),每一行都必须改变行为。
同帖还引用了其《.claude/ 目录解剖》长文,系统讲解 CLAUDE.md、自定义命令、skills、agents 与权限配置。
「编程与Agent」频道最新
- 开发者呼吁:模型权重与提示词都应编号版本化,拒绝静默更新 — ryunuck · 2026-11-22
- Qwen3.8-27B 编码任务爱绕圈?文章剖析过度思考成因与缓解方法 — blaizedsouza · 2026-11-22
- 框架设计者谈 Vibe Coding:失去代码细节枷锁,换来宏观掌控史诗级加强 — dotey · 2026-11-22
- Gamma 联合创始人谈垂直 Agent Harness:选对利基、设计工具、卖给为工作付费的人 — blaizedsouza · 2026-11-22
- Matt Pocock 用 AI 交付 2.1 万行 PR 全流程:从模糊想法到可评审的五步工作流 — blaizedsouza · 2026-11-22
- 开发者分享提示词收尾技巧:加一句「think out of distribution」 — amankhan · 2026-11-22