writing-skills 把创建和修改 Skill 当成面向流程文档的测试驱动开发。你不是写一篇看起来完整的说明,而是要确认未来代理在压力场景下会不会跳步、误解触发条件或绕过关键护栏。
开始时先写压力场景,观察没有这份 Skill 时代理会怎样失败;再写最小规则去解决这些具体偏差,最后重新运行场景并继续收紧漏洞。Skill 的 frontmatter 要有清楚的触发描述,description 只说明什么时候该用,不把整套流程塞进去。正文则按信息层级组织步骤和参考资料,让每个步骤有可判断的完成条件。
审稿时要删掉环境已经能直接告诉代理的缓存信息、重复意义和无效禁令;能用正面目标表达的,就不要只写“不要这样”。这份 Skill 适合创建或验证可复用的代理技能,不是写一次性项目说明书。