magpie-debt
Ledger of `reuse:` shortcut comments — where, ceiling, upgrade path, which are due. Use on "magpie debt" or any ask about deferred shortcuts or a debt ledger.
- License 许可
- Apache-2.0
- 最近更新
- 2026-08-12
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- magpie-debt
- license
- Apache-2.0
- description
- Ledger of `reuse:` shortcut comments — where, ceiling, upgrade path, which are due. Use on "magpie debt" or any ask about deferred shortcuts or a debt ledger.
03 SKILL.md 正文
Magpie debt
Deliberate shortcuts are marked reuse: <ceiling>, <upgrade path> at the
site. This skill turns those markers into a decision, not a backlog.
Steps
- Search the repo for
reuse:comments (all comment syntaxes://,#,--,/* */,<!-- -->). - For each, read enough context to restate: where (
file:line), shortcut (what was deliberately not built), ceiling (the condition that breaks it), upgrade (the named path). - Judge each against the code as it is today: has the ceiling been hit or is it near? Look for the trigger the comment names — throughput, table size, caller count, whatever it says.
- A
reuse:comment whose code was since upgraded or deleted is stale — flag it for removal.
Output
A single table: location, shortcut, ceiling, upgrade, verdict (ok /
due / stale). After the table, at most one line per due item saying
what to do. No reuse: comments in the repo → say so in one line and stop.
Do not invent debt the markers don't claim; unmarked code belongs to
magpie-review, not here.
04 同仓库更多 Skills
magpie
Reuse before you write: existing code, stdlib, native features, installed deps, one line before fifty, proven by a cost line. Use on ANY coding task, and when the user says "magpie", "reuse", "yagni", "do less", or complains about over-engineering, bloat, or unnecessary dependencies. Not for non-coding requests.
magpie-review
Review a diff against the magpie ladder: over-building (should have stopped at a higher rung) and floor breaches (safety simplified away). Use on "magpie review" or any ask to check a diff for over-engineering, bloat, reinvented helpers, or new dependencies.
magpie-help
Magpie quick reference: ladder, floor, cost line, skills. Use on "magpie help" or any ask about what magpie is or how to use it.