debug
Execute a calcified recipe with verbose logging. Use when the user is iterating on a calcifier recipe, wants per-step transcripts, or asks to "debug a calcifier recipe".
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 22
- Forks
- 0
01 前言 Front Matter
- name
- debug
- description
- Execute a calcified recipe with verbose logging. Use when the user is iterating on a calcifier recipe, wants per-step transcripts, or asks to "debug a calcifier recipe".
- allowed-tools
- Bash
02 资源文件 2
03 SKILL.md 正文
calcifier:debug — author-friendly recipe execution
Same engine as calcifier:exec but with verbose Python logging. Per-step trace records show inputs, redacted outputs, durations, and any fail() reason. Intended for skill authors who are iterating on a calcified recipe.
When to invoke
- The user is editing a recipe and wants to see what each
@stepreturned. - A previous
calcifier execrun failed and the user wants more signal.
Procedure
- Run
calcifier --versionto confirm install. - Run:
First run on the recipe also needscalcifier debug <recipe-path> --input k=v ...--trust. Agent-backed recipes also require--agent-config <agents.json>. Use--trace-out <path>to retain incremental trace v1 data if the run is interrupted or output parsing fails. - The CLI prints:
- The full
RecipeRunsummary (every@stepinvocation with pass/fail and duration). - Verbose Python logging from
calcifier.*loggers (recipe load, agent invocations, retries). - On failure: the
fail()reason or the exception type and message.
- The full
- Walk the user through any
[fail]lines. Common author errors:@stepreturn annotation doesn't match what the LLM emits (rejected as schema mismatch — visible inAgentError).- An agent returned an undeclared output field (closed schemas reject it rather than caching false success).
- A required artifact was not written or failed host verification.
- The declared call or wall-clock budget was exhausted.
- Recipe body references a step output before calling it.
- Pre-condition check raised
fail("…")early.
Output
A long, line-by-line transcript of the run. Use it to refine the recipe; commit only after the run reaches OK.
04 同仓库更多 Skills
support
暂无简介
text-search
Find the files in a workspace that mention a phrase and explain each match.
style-review
Review a document against the team style guide and list concrete fixes.
release-notes
Write release notes for the merged changes in a workspace.
release-digest
Produce a short digest of the release notes for a workspace.
update
Re-calcify a SKILL.md and unified-diff the result against the on-disk recipe. Use when the user asks to "check calcifier drift", "diff a recipe against its skill", or "update a calcified recipe".