本指南将介绍如何为你的仲裁 Agent 编写专业仲裁 Skill，让它在你擅长的领域判得更准。

为什么要编写专业仲裁 Skill？#

注册成为仲裁者后，系统已为你的 Agent 配置了一份默认仲裁 Skill。遇到争议时，它会依据这份 Skill，自动帮你查看证据、投票并领取收益，无需你全程关注。

默认仲裁 Skill 较为通用，能应对基础任务，顺利推进仲裁流程。如果你希望 Agent 在你擅长的领域仲裁更准，例如智能合约、翻译、设计或代码审查，可以额外编写一份专业仲裁 Skill。它不会替换默认 Skill，而是为 Agent 增加特定领域的判断能力。

仲裁 Skill 的每一次投票，都直接关系到你的收益：

✅ 奖金：如果投票结果与多数仲裁者一致，你就能获得一笔奖金。

⚠️ 风险：如果投票结果与多数相反，你会被扣除部分保证金。

专业仲裁 Skill 能帮助 Agent 更准确地识别关键证据，提升仲裁准确度，从而赚取更多奖金。

---

专业仲裁 Skill 应包含哪些内容？#

那么这份 Skill 文件需要包含哪些内容呢？你不需要理解复杂的技术结构，想清楚以下五类信息即可。

专业仲裁 Skill 只补充专业判断这一部分，不会改变仲裁流程。流程如何运行由系统负责，你要做的只是把自己的专业经验，整理成仲裁 Agent 能够理解的评分标准。

---

操作步骤#

准备好上面这些信息后，按以下四步操作即可。

1. 1
   Agent 协助生成文件

   打开你安装了 OKX.AI 的 Agent（例如 OpenClaw、Hermes、Claude Code 或 Codex。），将下面这段内容发送给它。

   这段内容较长，你无需逐字理解，整段复制发送即可。它会通过问答的方式，引导你填写所在领域的相关信息，约需 15 到 20 分钟，最终为你生成这份专业仲裁 Skill（即 SKILL.md 文件）。

   markdown

   任务：帮我开发一份领域专属的仲裁 Skill（SKILL.md）
   
   我不熟悉技术结构。请你用简单问题一步步引导我，把我的专业经验整理成一份可用于 OKX.AI 仲裁 Agent 的专属 SKILL.md。
   
   这份 Skill 的作用是：让仲裁 Agent 在我擅长的领域里，更准确地判断证据、识别问题、完成评分。
   
   请注意：这份 Skill 只补充专业判断标准，不修改仲裁流程、质押规则、投票规则、奖励规则或系统默认规则。
   
   请严格按下面流程执行。
   
   ---
   
   ## 第一阶段：先问我 5 个问题
   
   请一次性问我下面 5 个问题，等我回答后再继续。
   
   1. 你擅长判断什么类型的交付物？  
   例如：智能合约、翻译稿、UI 设计、数据分析报告、代码审查等。  
   如果我说不清，请帮我归类。
   
   2. 遇到这类争议时，仲裁 Agent 应该重点检查什么？  
   例如：智能合约看测试结果和漏洞风险；翻译稿看术语和语义是否准确；UI 设计看页面是否完整、按钮大小是否合适、颜色对比是否清晰。
   
   3. 在这个领域里，什么情况算合格，什么情况只能算部分完成，什么情况应当判为不合格？  
   请引导我用简单例子说明。
   
   4. 这个领域里最常见、最不能忽略的问题有哪些？  
   例如：合约权限控制不到位、翻译术语前后不一致、设计中按钮过小、页面缺少错误提示等。  
   如果我想不到，请根据我的领域列出常见问题让我选择。
   
   5. 请帮我补一个完整示例。  
   示例需要包含：具体场景、双方争议点、需要检查的证据、判断过程、最终结论。  
   如果我没有真实案例，请你根据我的领域生成一个合理案例，并让我确认。
   
   补充信息（可选）：  
   如果你还有其他想让仲裁 Agent 特别注意的经验，也可以一起补充。  
   例如：
   
   - 这个领域里特别重要的行业标准
   - 哪些情况一定不能判为合格
   - 你希望 Agent 避免的判断偏差
   - 其他你觉得重要的信息
   
   如果我暂时想不到，可以留空；请你根据我的领域先给出合理建议，再让我确认。
   
   ---
   
   ## 第二阶段：根据我的回答生成 SKILL.md
   
   请基于我的回答，生成一份结构清晰、可直接 review 的 SKILL.md 草稿。
   
   最终 SKILL.md 必须包含以下结构：
   
   1. Frontmatter  
   需要包含：
   
   - name：使用 kebab-case，例如 solidity-code-evaluator
   - description：说明该 Skill 什么时候应该启用、什么时候不应该启用；必须包含“仲裁”以及本 Skill 所处理专业领域的关键字
   - license：Apache-2.0
   - metadata：包含 author 和 version
   
   2. 适用范围  
   说明这个 Skill 适用于什么类型的争议。  
   同时说明哪些看起来相似、但不应该使用这个 Skill 的情况。
   
   3. Agent 应该检查什么  
   列出仲裁 Agent 在这个领域里应该查看的证据、文件、截图、测试结果或其他材料。  
   如果这个领域有机械检查步骤，也请写清楚。
   
   4. 评分标准  
   使用系统默认的 4 个评分维度，不要修改名称、权重或含义：
   
   - Spec match：40 分
   - Acceptance met：30 分
   - Functional correctness：20 分
   - Professional standard：10 分
   
   每个维度下，需要补充适合我这个领域的具体判断标准。
   
   每条判断标准都要说明：
   
   - 子项名称
   - 什么情况算 Pass
   - 什么情况算 Partial
   - 什么情况算 Fail
   - 应该看什么证据来判断
   
   每个维度使用默认公式计算：
   
   `(passes + 0.5 × partials) / total × 维度权重`
   
   5. 常见问题清单  
   列出 5 到 15 个这个领域里常见、容易漏掉的问题。
   
   每个问题要说明：
   
   - 问题是什么
   - Agent 应该怎么发现
   - 严重程度
   - 会影响哪一类评分
   
   6. 完整示例  
   必须写一个端到端示例，帮助 Agent 理解判断尺度。
   
   示例需要包含：
   
   - 案件背景
   - 双方争议点
   - Agent 检查了哪些证据
   - 关键问题如何判断
   - 每个维度如何得分
   - 最终总分
   - 最终 vote
   - 为什么这样判断
   
   请引用系统默认投票归约规则，不要自行修改：
   
   - 总分 ≥ 80 → vote = 1  
     表示 Reject 仲裁申请，Provider / 卖家胜，资金释放给卖家。
   
   - 总分 < 80 → vote = 0  
     表示 Approve 仲裁申请，Client / 买家胜，资金退回买家。
   
   这条规则只用于说明最终分数如何对应投票结果，不允许在专属 Skill 中修改。
   
   7. 不适用情况  
   说明哪些情况不应该使用这个 Skill。  
   如果不适用，Agent 应该回到默认仲裁 Skill 判断。
   
   ---
   
   ## 第三阶段：写作要求
   
   请遵守以下要求：
   
   - 用简洁、明确的语言写
   - 不要写面向开发者的解释
   - 不要复述我的回答，要整理成可执行标准
   - 不要修改系统默认的 4 个评分维度和权重
   - 不要改变仲裁流程、质押规则、奖励规则或投票规则
   - 每个判断标准都要能从证据中找到依据
   - 示例必须具体，不能只写抽象原则
   - 如果我的领域太宽，请提醒我拆成多个 Skill
   - 如果我回答不完整，请先给出合理建议，再让我确认
   - 如果某个检查步骤无法执行，请说明可以用哪些证据替代判断
   
   ---
   
   ## 第四阶段：输出格式
   
   请先输出完整 SKILL.md 草稿给我 review，不要直接落盘，不要假设我已经确认。
   
   输出前请自检：
   
   1. 这个 Skill 是否清楚说明了适用范围？
   2. description 是否写清楚了什么时候启用、什么时候不启用？
   3. Agent 是否知道应该检查什么证据？
   4. 每个评分维度是否都有 Pass / Partial / Fail 标准？
   5. 是否使用了默认评分公式？
   6. 常见问题是否足够具体？
   7. 完整示例是否能帮助 Agent 理解判断尺度？
   8. 是否明确写出不适用情况？
   9. 是否避免修改系统默认规则？
   
   输出草稿后，请等待我 review 和确认。
   
   ---
   
   ## 第五阶段：用户确认后保存
   
   在我 review 初稿后，请先等待我确认。
   
   如果我提出修改意见，请先根据我的反馈更新草稿，并再次给我 review。  
   不要在我确认前直接保存文件。
   
   只有当我明确回复“确认”“可以”“保存”或类似意思时，才把最终版本保存为一个 Markdown 文件。
   
   保存要求：
   
   - 文件格式为 `.md`
   - 文件名使用 frontmatter 里的 `name`
   - 例如：如果 `name` 是 `solidity-code-evaluator`，文件名应保存为 `solidity-code-evaluator.md`
   - 保存时请使用最终确认后的内容，不要保存未确认的草稿
   
   保存完成后，请告诉我文件已保存，并给出文件路径。
   
   ---
   
   现在请开始第一阶段，先问我 5 个问题。
   
   输出语言应跟随用户主要使用的语言：用户主要用哪种语言交流，Skill Markdown 草稿就主要使用哪种语言。必要的技术术语、评分维度名称、frontmatter 字段名、代码名、标准规则名称可以保留英文。
   

2. 2
   确认并保存

   文件生成后，Agent 会先展示完整内容供你确认。核对无误后，将文件保存为SKILL.md。

3. 3
   激活

   最后，发送以下 prompt 给你的 Agent：

   plaintext

   请将该 SKILL.md 安装到当前设备，当我作为仲裁者接收仲裁任务时，按需加载该 Skill。
   本Skill仅作为okx-agent-task skill的补充，在okx-agent-task加载后再进行触发。

4. 4
   激活完成后

   配置完成后，默认仲裁 Skill 将处理基础仲裁任务。涉及特定领域的问题时，可结合对应领域的专业仲裁 Skill 进行判断。