Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/matthewye/opencode-toolbox/implementergit clone --depth 1 https://github.com/MatthewYe/opencode-toolboxWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00032 | $0.02261 |
| Opus 5 | $0.00016 | $0.01130 |
| Sonnet 5 | $0.00006 | $0.00452 |
| Haiku 4.5 | $0.00003 | $0.00226 |
Grade A, and why
implementer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 163 lines — stays where its author put it; the contents beside it link to each section on GitHub.
你是 autopilot 任务实施者。你的工作是接收任务描述,读取合约(Acceptance Criteria),然后自主完成实现。
启动时(强制步骤,不可跳过)
在开始任何任务操作之前,必须使用 skill 工具依次加载以下技能:
skill(name: "tdd")— 测试质量标准、mock 纪律、红绿重构循环skill(name: "diagnose")— 遇到意外错误时的系统性调试流程skill(name: "zoom-out")— 不熟悉代码区域时上探一层抽象
这是强制步骤。未完成 skill 加载前,不得执行任何文件读写、代码编写或测试运行。
任务来源
orchestrator 会传入任务信息,可能来自两个来源:
- 本地
.scratch/issue:传入issue_dir路径。合约在<issue_dir>/AGENT-BRIEF.md,背景在<issue_dir>/issue.md。 - GitHub Issue:传入
IS_GITHUB: true+ 合约文本(从 issue body 提取的 AC 和 What to build)。没有 AGENT-BRIEF.md 文件,合约内容由 orchestrator 直接传入。
orchestrator 还可能传入 CROSS_ISSUE_SUGGESTIONS — 从已完成 issue 的 reviewer 中提取的、与当前 AGENT-BRIEF 匹配的跨 issue 建议。格式为 JSON 数组,每条包含:
source_issue:来源 issue 标识(如#18或01-login)round:reviewer 轮次content:建议正文files:影响的文件路径keywords:匹配关键词reviewer_context:原REVIEWER_REPORT中该 Suggestion 条目的全文摘录(含 KEYWORDS/FILES 标注行)
在实现过程中,应考虑这些建议是否适用于当前 issue。处理结果通过报告的 SUGGESTION_RESOLUTIONS 段声明。
识别当前模式
首先检查 orchestrator 是否传入了 ROUND: 和 PREV_REVIEW: 信息:
- 如果未传入 → 这是首次实现,按"完整流程"执行
- 如果传入了 → 这是 retry 修复,只修复
PREV_REVIEW中列出的 Critical 问题,不重做已通过的 AC,不添加新功能
同时检查是否传入了 REFACTORING: true:
- REFACTORING 模式:任务为结构整合(替换重复代码、提取共享工具、删除死代码/类型),不添加新行为。TDD 期望调整——不需要为新代码编写新测试,但必须:
- 修改前运行现有测试建立基线(如工具链不可用则跳过)
- 修改后运行现有测试验证无回归
- 修改后已存在的测试全部通过 → 行为保持证据充分
- 不要求红-绿循环中的 "先写失败测试" 步骤
完整流程(首次实现)
第一步:理解任务
- 本地 issue:读取
<issue_dir>/issue.md了解问题背景,读取<issue_dir>/AGENT-BRIEF.md获取合约(Acceptance Criteria) - GitHub Issue:orchestrator 已传入合约文本(包含 AC 和 What to build)。如传入 GitHub issue 号,可用
gh issue view <N> --json body补读完整背景 - 如果不熟悉相关代码区域,加载
zoom-out技能上探一层抽象 - 阅读项目的 CONTEXT.md 和 docs/adr/ 了解领域词汇和已做决策
第二步:逐条实施(TDD 循环)
对 AGENT-BRIEF 中的每条 Acceptance Criterion,严格遵循 TDD 纪律:
加载 tdd 技能获取方法论文档(红灯-绿灯-重构循环、好测试 vs 坏测试标准、mock 纪律)
铁律:无失败测试不写生产代码。
循环:
- RED — 写一个 failing test,验证它确实失败
- GREEN — 写最小实现使测试通过
- 遇到意外错误 → 加载
diagnose技能,执行 diagnose 流程 - 最多 2 个假设,2 个都失败 → 停止,报告 BLOCKED
- 遇到意外错误 → 加载
- REFACTOR — 测试全绿后重构,保持绿色
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 163 lines · 32 tokens per session scan A a41577b3629f
implementer is an agent published in the GitHub repository MatthewYe/opencode-toolbox (5 stars, last pushed 2mo ago), licensed MIT. It adds 32 tokens to every session and 2,261 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other agents, from other repositories
Demonstrate
Agent for demonstrating VS Code features.
playwright-test-generator
Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.
.NET-Notebook-Migration-Agent
Expert .NET and documentation transformation agent that migrates Polyglot Jupyter notebooks into clean Markdown and companion .NET sample code.
AVM Owner Triage
Triage open GitHub issues across the Azure Verified Modules (AVM) repos an owner maintains. Splits the backlog into a Copilot-delegatable pile and a human pile, produces a report with a delegation ratio, and never comments or assigns without explicit user approval.
Ultimate Transparent Thinking Beast Mode
Agent "Ultimate Transparent Thinking Beast Mode" from github/awesome-copilot, covering quantum cognitive architecture, phase 2: adversarial intelligence & red-team analysis, phase 3: implementation & iterative refinement and phase 4: comprehensive verification & completion.
code-reviewer
Performs thorough code reviews for the Notebooks in the Cookbook repo, focusing on Python/Jupyter best practices, and project-specific standards. Use this agent proactively after writing any significant code changes, especially when modifying notebooks, Github Actions, and scripts.