技能写作

写作 社区

技能解读

当前原文的自动摘译,尚未人工审校。

铁律

没有先通过测试就没有技能。在编写技能之前,请在没有技能的情况下对目标任务运行子代理。记录它出错的地方——确切的合理化、捷径和跳过的步骤。然后编写解决这些特定故障的技能。这是应用于文档的 TDD。 TDD 步骤·技能等效红色·无需技能即可运行场景。记录代理人做错了什么。绿色 · 写出解决这些特定故障的最低限度的技能。验证代理现在是否符合要求。

何时创建技能

创建时间:该技术并不明显,您可以跨项目引用它,其他人会受益,或者代理在没有它的情况下反复失败。不要创建:一次性解决方案、其他地方记录的标准实践、特定于项目的约定(使用 CLAUDE.md)或机械约束(改为使用 linter/hooks 强制执行)。

核心原则

说明是有限的预算。模型可靠地遵循约 150 条指令。系统提示烧~50。您添加的每条指令都会降低所有指令的合规性。对赢得一席之地的事物要毫不留情。外围位置受到更多关注。第一部分和最后一部分受到了不成比例的关注。将一条关键规则埋在中间,它就会被跳过。特异性驱动合规性。 “考虑进行审核”被忽略。 “在发出RUN_COMPLETED之前调用accessibility_audit”得到遵循。

描述优化

description字段控制技能何时激活。代理阅读它并决定:“我应该立即加载它吗?”描述触发条件,而不是工作流程。不好:description: A skill for TDD - write test first, watch it fail, write code 好:description: Use when tests have race conditions, timing dependencies, or pass/fail inconsistently. Covers flaky tests, hanging tests, zombie processes.

前题

使用动词优先的主动命名:creating-skills不是skill-creation,condition-based-waiting不是async-helpers。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
写作
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@millionco · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 skill-writing.preview
**Bad:** `test the login page`
**Good:** `Submit login with empty fields, invalid email, wrong password, valid credentials. Verify errors and redirect.`

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。