shortcut-ledger
Collects every `shortcut:` comment in the codebase into a ledger of deliberate simplifications, each with its ceiling and the trigger for revisiting it, and flags the ones with no trigger. Use when grooming the backlog, when the user asks what shortcuts or deferred work the code carries, and before planning work in an area with marked shortcuts.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- shortcut-ledger
- description
- Collects every `shortcut:` comment in the codebase into a ledger of deliberate simplifications, each with its ceiling and the trigger for revisiting it, and flags the ones with no trigger. Use when grooming the backlog, when the user asks what shortcuts or deferred work the code carries, and before planning work in an area with marked shortcuts.
- allowed-tools
- Read, Grep, Glob, Bash(<shared-scripts-dir>/scan-shortcuts.sh*), Bash(git blame *)
02 资源文件 1
- 参考文档agents/openai.yaml129 B
03 SKILL.md 正文
Shortcut Ledger
The minimal-change skill marks deliberate simplifications with a comment:
<comment> shortcut: <the ceiling> | revisit when <the trigger>
This collects them into one ledger, so a deferral can't quietly become permanent. It reads and reports; it changes nothing.
Scan
<shared-scripts-dir>/scan-shortcuts.sh [dir]
It greps for the marker after a comment leader (#, //, --, /*,
<!--), skipping Markdown and dependency and build folders; the groom skill
runs the same script. Requiring a comment leader keeps prose and config keys that merely contain
the word out of the ledger, and excluding Markdown keeps documentation that
shows example markers out. If your stack uses another comment leader (;,
%, '), extend the script's pattern.
Report
One row per marker, grouped by file:
src/locks.py:41 ceiling: one global lock revisit when: write throughput matters
src/dedupe.ts:12 ceiling: O(n²) dedupe revisit when: (none) no-trigger
Tag a marker with no | revisit when as no-trigger: those rot first. For an
owner per row, add git blame -L<line>,<line> <file>. End with
<N> shortcuts, <M> with no trigger, or "No shortcuts marked." when the scan
finds none.
Done when every marker is a row and every row without a trigger is tagged.
Rows whose trigger has plainly fired, and no-trigger rows, are candidates
for issues; recommend them, and let the user decide what to file.
04 同仓库更多 Skills
teach
Teach yourself a topic over several sessions, with lessons, references, and a record of what you've learned.
svg-logo-designer
Generate SVG logos with multiple concepts, layouts, and color variations.
documentation-writer
Writes and revises human-facing documentation — READMEs, contributor and setup guides, reference pages, architecture notes, CLAUDE.md, and changelog entries. Covers picking the right document type for the question being asked, structuring for skimming, writing examples that actually run, and keeping docs from going stale. Use when creating or rewriting docs, when a README has drifted from the code, or when deciding where a piece of information belongs. For SKILL.md and agent files, use /skill-writer instead.
adhd-mode
Shapes every response for a reader with ADHD: the next action first, numbered steps, progress restated each turn, tangents held back, concrete time estimates, wins made visible. Stays on for the rest of the session until the reader says "stop adhd mode". On Claude Code, the harness-kit:adhd output style does the same without invoking this skill.
wait-what
That last message didn't land: re-explain it with the missing context.
to-questionnaire
Turn a decision you can't make alone into a questionnaire for the one person who can answer it, filled in async or together in a meeting.