Community写作与编辑github.com

ebursztein/agent-skills

编写或改进 Realm of Code 领域指南,包含实用触发器、具体操作、证据和奇幻风味。适用于撰写领域宪章本身,而非将其角色应用于普通软件工作。

agent-skills 是什么?

该技能专门用于协助开发人员或 AI 代理编写和改进“Realm of Code”领域指南。它强调指南必须包含清晰的触发条件、具体的操作步骤、可验证的证据,并带有统一的奇幻主题风味。技能文档指导用户如何设定领域规则,确保代理能在正确的时间选择正确的“领域”(例如 Faceless Men 或 Arryn),并执行定义好的最佳实践。它还提供了详细的编辑原则,如避免在指南和主触发表中重复信息、使用明确的术语而非抽象概念、通过“棘轮”机制保护改进成果。最终目标是创建一套可被 AI 代理准确解析和执行的结构化指南。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ebursztein/agent-skills/tree/HEAD/skills/realm-authoring

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

领域编写指南

领域告诉代理何时值班、下一步做什么,以及如何知道工作已完成。为该纪律赋予一个令人难忘的派系风格。

编写之前

阅读目标指南和宪章的触发器表。保留已商定的派系分配,并使其与邻近领域有所区别。基于用户希望处理的实际开发场景进行工作。命名可识别的技术:“模拟对象、桩对象和伪造对象”比单独使用“受控替身”更易于发现。

将选择逻辑放在主技能中

主 realms-of-code SKILL.md 拥有 何时使用每个领域。其表格必须让代理在加载指南之前进行选择。使用具体场景:测试文件删除、选择 API 标准,或保护查询计数改进。将触发器保留在那里,而不是在每个指南中重复。

将最佳实践放在领域指南中

  • 名称、纪律、格言: 一个标题、一行具体范围描述和格言。
  • 传说: 一段简短生动的段落,将派系与其工程角色联系起来。让隐喻解释工作。
  • 公理: 几个简洁的原则,指导决策。修改现有领域时,保留已建立的承诺。
  • 怎么做: 以动词开头的实际步骤。确定要检查或更改的内容,如何选择方法,以及要验证的内容。使用明确的技术名称并重用项目的工具。解释有意义的替代方案和陷阱。
  • 证据: 支持完成的可观察结果或产物,外加该证据所能证明的任何重要限制。

公理解释判断;步骤使其可执行。避免在两者中重复相同的建议。保持每个部分尽可能简短。领域参考文件为纯 Markdown:无 ID、重复的 YAML 字段、格言来源标签或署名说明。只有可发现的 SKILL.md 需要技能前置元数据。

已修正的示例

对于“无面者”,"控制依赖" 过于抽象。一个有用的触发器是“测试一个删除文件或调用外部支付服务的作业”。下一步是隔离该边界,选择模拟对象/桩对象/伪造对象,并测试成功、失败和重试行为,而不会产生意外的实时影响。证据包括预期目标和结果状态,以及在真实契约重要时的集成证明。仍然调用实时服务的间谍是一个值得命名的陷阱。

当配套的 realms-of-code 技能可用时,其 references/realms/faceless-men.md 是完整的示例。

对于“艾林”,"选择协议" 属于主触发器表。其指南必须说明要查找现有标准和技术,验证当前维护和弃用状态,评估可行性,重用已实现的实现并测试互操作性。

在实现过程中进行保护:将重要规则编码为护栏,将已验证的改进编码为棘轮。棘轮记录可重现的基线,拒绝回归并在改进后收紧。学城构建保护;铁金库强制执行。决不要通过悄悄削弱检查来解决失败的检查。

发布前审查

尝试两个真实的匹配任务和一个属于另一个领域的附近任务。从主表中选择领域,然后从其指南中识别出第一个具体操作和所需证据。如果任一步骤仍然模糊,则修改负责的文件。避免与任务无关的通用门控。

通过格言、传说和偶尔使用的工作短语(如“我们对虫子说什么?今天不行。”)保持风味鲜活。将其与有用的工程指导配对。删除既不增加决策也不增加角色的词语。遵循仓库的发布工作流程,并在受影响时验证相对链接和技能发现。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能