Agent Skills
› Tencent/LoopForge
› agent-observability
agent-observability
GitHub为 CodeBuddy 项目配置本地指标观测,追踪工具延迟、Token 用量及会话成本。通过合并 Hook 设置并检查日志文件,实现多 Agent 链路追踪与缺失事件调试。
Trigger Scenarios
需要本地监控工具调用延迟或 Token 消耗
调试缺失的使用量事件或多 Agent 追踪问题
Install
npx skills add Tencent/LoopForge --skill agent-observability -g -y
SKILL.md
Frontmatter
{
"name": "agent-observability",
"description": "Add or maintain CodeBuddy hook observability for projects that need local metrics for tool latency, transcript token usage, session cost, and multi-agent trace attribution. Use when wiring hook-based telemetry, and debugging missing usage events."
}
Workflow
- Merge
templates/settings-hook.jsoninto the user or projectsettings.json. - Keep hook entries command-only and keep timeouts around 5 to 10 seconds.
- Run a normal CodeBuddy session and inspect
logs/metrics.ndjson. - Inspect
logs/.state.jsonwhen usage replay or offsets look wrong. - Keep the runtime generic and verify output from
metrics.ndjsonand.state.json.
Read Next
- Read
references/quickstart.mdfor setup and smoke-test steps. - Read
references/schema-v2.mdwhen you need field definitions or sidecar state shape.
Key Files
scripts/main.py: hook entrypoint forsession-start,user-prompt-submit,pre,post, andstopscripts/run_hook.sh: stable shell wrapper for CodeBuddy hook commandsscripts/core/collector.py: transcript parsing, pre/post pairing, and session usage recordingscripts/core/state.py: persisted hook state, offsets, and pending tool eventsscripts/core/devflow.py: optional devflow-awareness — detects amulti-agents-devflow-*team, readsworkflow-state.json, and emitsstage_transitionevents. No-ops entirely on non-devflow projects.templates/settings-hook.json: hook wiring template
Output Contract
- Always emit
event,sid, andts. - Emit
toolfor per-call latency andusagefor transcript-derived token and cost events. - Emit
stopfor end-of-session flush. - Never block the main hook flow; hook exits must stay
0.
Version History
- dd56585 Current 2026-11-16 13:49


