跳到正文
cccskills
免费在 GitHub 公开

debug-loop

Systematic debugging playbook for the Forge agentic loop (src/core/loop.ts and src/agents/executor.ts). Use when a task is stuck, looping, or emitting wrong tool calls.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI
查看安装方法

包含的文件（1）

  • SKILL.md1.5 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

The loop is the most expensive place to be wrong. Instrument before you change anything.

1. Reproduce deterministically

FORGE_LOG_LEVEL=debug ./bin/forge.js <command>

Capture the session id. Events land in ~/.config/forge/events/<session>.ndjson.

If the bug only reproduces against a real provider, pin the model and disable router fallback:

FORGE_MODEL=... FORGE_ROUTER_FALLBACK=0 ./bin/forge.js <command>

2. Read the event stream, not the terminal

Each turn emits: turn.start, model.call, tool.call, tool.result, validation.result, turn.end. Missing or out-of-order events are your bug.

3. Check the usual suspects, in order

  1. Mode caps (src/core/mode-policy.ts) — is the agent hitting turn/token cap?
  2. Validation gate (src/core/validation.ts) — is a valid step being rejected?
  3. Tool registry — is the requested tool actually registered? tool.call with class: not_found means no.
  4. Permissions — silently denied? tool.result.denied=true.
  5. State machine (src/persistence/tasks.ts) — illegal transition attempted?

4. Add a failing test before the fix

Template: test/unit/executor-loop.test.ts. Mock callModel. If the test you add doesn't turn green after your fix, you fixed the wrong thing.

5. Finish with verify.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护，适用 Google 的隐私权政策和服务条款。

同一仓库的技能

add-agent

免费

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style). Use when adding anything to src/agents/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-agent

免费

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-provider

免费

Scaffold a new model provider for Forge — class implementation, registry wiring, providerEnum entry, local-catalog classification, and unit test with mocked transport. Use for anything under src/models/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-provider

免费

Scaffold a new model provider for Forge — class, registry wiring, providerEnum entry, local-catalog classification, router check, and a unit test with mocked transport.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-tool

免费

Scaffold a new Forge tool end-to-end — type, implementation, registration, permission/risk classification, and unit test. Use when adding anything to src/tools/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-tool

免费

Scaffold a new Forge tool — implementation, registration, permission/risk metadata, sandbox routing, and a unit test. Use when adding anything to src/tools/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

查看 hoangsonww 的全部技能

报告此技能的问题