mcpField
W
write-skill

write-skill

github.com/pwgulerAgent 工作流10114 次安装2 周前更新
代码仓库

关于 write-skill

指导 Agent 以测试优先的方式编写技能、AGENTS.md 和提示词：先观察无文档时的表现，再写最少文本并复测。适用于需要通过文档改变 Agent 行为的场景。

主要功能

  1. 01先运行无文档基线场景
  2. 02记录具体失败或借口
  3. 03只编写解决问题所需的文本
  4. 04加载文档后重新运行场景
  5. 05按新发现的漏洞迭代修订

适用场景

  1. 01编写新的 Agent 技能
  2. 02改进 AGENTS.md 或 CLAUDE.md
  3. 03验证系统提示词是否改变行为
  4. 04判断规则应由机制还是文本落实

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pwguler/skills --skill write-skill

安装后在 Claude Code 中输入/write-skill确认已加载。

附带文件references/conventions.mdreferences/encode-lessons-in-structure.md

详细介绍

为 Agent 编写文档，就是把测试优先开发应用于文本。每份 Agent 会读取的文档都采用同一套循环：技能、AGENTS.md、CLAUDE.md 和系统提示词。

  1. 先运行基线测试。在不加载该文档的情况下，让 Agent 执行文档针对的场景。准确记录它如何失败，或它给出的借口。在全新的子 Agent 中运行基线测试，确保它不加载任何技能和上下文文件，例如 AGENTS.md。它仍会使用 Agent 的基础系统提示词。如果 Agent 无法启动这样的子 Agent，就使用不加载技能和上下文文件的新会话。当你观察不到失败时，这份文档就没有内容可教。
  2. 只写能解决这些具体失败的最少文本。不要写手册。写出能改变行为的最简流程。
  3. 加载文档后再次运行该场景。要么通过，要么说明文档有误。
  4. 堵住漏洞。如果新一轮运行出现新的借口，就在文本中堵住它，并再次验证。

规则：

  • 评估脚本改变的是执行方式，而非循环本身。如果存在评估脚本，就由它运行基线测试和第二轮测试。
  • 用户第二次提出的修正，说明这条经验没有得到落实。请阅读将经验编码进结构。在能持久解决问题的最高层级修复：优先使用机制，而不是文本。只有机制无法解决的问题，才执行步骤 1 到 4。
  • 如果要编写的文档是本仓库中的技能，请遵循本仓库的技能约定。
  • 对于只做一次的工作，或标准做法已有充分文档说明的情况，请跳过此技能。如果可以用代码检查器或钩子强制执行规则，也请跳过此技能。在这种情况下，应改为构建代码检查器或钩子，正如将经验编码进结构所述。

评论

支持 Markdown