メニュー
Use while debugging or troubleshooting failures, flaky tests, incidents, production alerts, CI failures, local dev setup issues, repeated bugs, prior fixes, failed attempts, and verification history.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/potpie-ai/potpie --skill potpie-debug-memoryコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Use when the task is centered on running, explaining, configuring, or troubleshooting the `potpie` command: doctor, login, pot management, source registration, search, graph workbench reads/writes, and pot scope behavior.
How to backfill a newly-added repo or team — the enumerate-then-drain loop, the single-event contract, and resume-safe todo discipline. Load this when handling a *.added seed event with the planner on.
Cookbook for composing an apply_graph_mutations plan — stable entity_key patterns, the canonical label/edge vocabulary, evidence/invalidation/confidence discipline, and a worked example. Load this when building a non-trivial mutation plan.
| name | potpie-debug-memory |
| description | Use while debugging or troubleshooting failures, flaky tests, incidents, production alerts, CI failures, local dev setup issues, repeated bugs, prior fixes, failed attempts, and verification history. |
Use this skill before digging into a failure so prior symptoms, known fixes, and failed attempts can guide the investigation.
Search by symptom first, not just component name. Include exact error text, commands, failing tests, environment, service, dependency, and synonyms.
potpie graph read \
--subgraph debugging \
--view prior_occurrences \
--query "<expanded symptom query>" \
--scope service:<service-name> \
--limit 12
If no service is known, omit --scope. If the failure smells like a regression,
correlate with the timeline:
potpie graph read \
--subgraph recent_changes \
--view timeline \
--format table \
--time-window 7d \
--query "<symptom feature dependency>" \
--limit 20
If dependencies, adapters, environments, or deploys matter, read infra too:
potpie graph read \
--subgraph infra_topology \
--view service_neighborhood \
--scope service:<service-name> \
--depth 2 \
--direction both
Treat prior fixes as leads. Check whether the same symptom, environment, version, dependency, data shape, command, or test path matches this incident. Failed prior attempts are useful because they prevent repeated work.
Record after the investigation when the learning is reusable: bug pattern, fix, verification, failed attempt, incident summary, runbook note, or setup gotcha.
Use the workbench write flow:
potpie --json graph catalog --task "record bug fix"
potpie graph search-entities "<service or symptom>" --limit 10
potpie --json graph describe debugging --view prior_occurrences --examples
potpie --json graph propose --file mutation.json
potpie --json graph commit <plan_id> --verify
potpie --json graph history --plan <plan_id>
Good debug memory includes the distinctive error text, repro signal, root cause or uncertainty, fix steps, verification status, scope, truth class, evidence, and a retrieval-grade description with symptom synonyms.
If the source may matter but the canonical update is uncertain, use
potpie --json graph inbox add instead of committing a weak fact.
Debug memory is harness-led: investigate and verify before writing. Do not use scanner-driven graph updates or record a bug/fix from filenames or logs alone.