本文へ移動
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（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

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-CLI252026年9月28日 更新

add-agent

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

hoangsonww/Forge-Agentic-Coding-CLI252026年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-CLI252026年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-CLI252026年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-CLI252026年9月28日 更新

add-tool

無料

Scaffold a new Forge tool end-to-end — implementation, registration, permission/risk metadata, sandbox routing, and a unit test.

日本語の概要は準備中です。原文の説明を表示しています。

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

hoangsonww のスキルをすべて見る

このスキルの問題を報告する