菜单
Extract and triage TODO/FIXME/HACK comments from a codebase. Categorize by urgency, group by file, identify stale TODOs older than threshold. Use during cleanup sprints, before releases, or when onboarding a new project.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generate concise documentation from code. README, function docs, API references, architecture notes — written in plain language, with examples that work, no padding. Use when shipping or onboarding and you want docs that read fast and stay accurate.
Scope-guarded refactoring. Define target → identify minimum diff → preserve behaviour → verify with tests. Pre-Action Gate prevents scope drift into unrelated improvements. Use when you want a targeted refactor that does not turn into a 50-file rewrite.
Compress long content into structured summary. TLDR + key points + action items, length-tunable. Use for meeting notes, transcripts, long docs, threads, codebases. No padding, no editorial commentary.
Generate disciplined test cases. Focus on behaviour not implementation, cover edge cases without bloat, name tests for the case not the function. Use when writing tests for new code or filling gaps in coverage.
Generate a concise commit message from the current git diff. Conventional commits format (feat/fix/refactor/etc). Use when staged changes are ready to commit and you want Claude to write the message instead of typing it manually.
Disciplined debug session protocol. Read symptom → form hypothesis → verify before fixing → propose minimum-change fix. Pre-Action Gate prevents hasty rewrites that break unrelated code. Use when an error or unexpected behaviour appears and you want a focused diagnosis instead of guess-and-check.
| name | maji-todo |
| description | Extract and triage TODO/FIXME/HACK comments from a codebase. Categorize by urgency, group by file, identify stale TODOs older than threshold. Use during cleanup sprints, before releases, or when onboarding a new project. |
A skill that scans a codebase for TODO/FIXME/HACK comments and outputs a triaged list — by category, by file, by age. Helps you decide what to address vs what to delete.
Type maji-todo <target> where target is:
maji-todo .)maji-todo src/)maji-todo src/auth.ts)Optional flags:
--stale — only show TODOs older than 30 days (via git blame)--owner <name> — filter by author--type <TODO|FIXME|HACK> — filter by tag| Tag | Meaning | Default urgency |
|---|---|---|
TODO | Future work, not blocking | 🟢 Low |
FIXME | Known bug, should fix | 🟡 Medium |
HACK | Workaround, technical debt | 🟡 Medium |
XXX | Mark of caution / surprise | 🟡 Medium |
BUG | Confirmed bug | 🔴 High |
NOTE | Important context | ⚪ Info |
WARNING | Future hazard | 🟡 Medium |
[N] TODOs found in [target]
🔴 High Priority (BUG)
─────────────────────
src/auth.ts:42 — BUG: token refresh fails on Safari
Author: ijam, 14 days ago
🟡 Medium Priority (FIXME, HACK, WARNING)
─────────────────────
src/api/users.ts:18 — FIXME: rate limiting not enforced
Author: ijam, 32 days ago [STALE]
src/utils.ts:7 — HACK: monkey-patch for IE fallback (delete in 2026)
Author: mung, 95 days ago [STALE]
🟢 Low Priority (TODO)
─────────────────────
src/ui/Modal.tsx:23 — TODO: extract animation logic
Author: ijam, 5 days ago
src/utils.ts:14 — TODO: support locale strings
Author: ijam, 60 days ago [STALE]
⚪ Info (NOTE)
─────────────────────
src/db.ts:1 — NOTE: connection pool size tuned for 100 concurrent
Author: mung, 200 days ago
SUMMARY
- 1 high (BUG)
- 3 medium (FIXME, HACK, WARNING)
- 2 low (TODO)
- 1 info (NOTE)
- 4 stale (>30 days)
After listing, output a short triage section:
TRIAGE SUGGESTIONS
Address now:
- src/auth.ts:42 (BUG, 14 days) — confirmed Safari issue
Decide and act:
- src/utils.ts:7 (HACK, 95 days) — IE fallback; if IE no longer supported, delete
- src/api/users.ts:18 (FIXME, 32 days) — schedule or document why deferred
Convert or delete:
- src/utils.ts:14 (TODO, 60 days) — convert to issue, or delete if not actually planned
node_modules, dist, build, .git, vendor| ❌ Avoid | ✅ Do instead |
|---|---|
| Suggesting "fix all TODOs" as the recommendation | Triage by urgency + age |
| Showing every TODO as equally important | Rank by tag type + age |
| Auto-deleting stale TODOs | List + recommend, don't act |
| Including TODOs in node_modules | Default exclude vendored code |
| Paraphrasing comment intent | Show exact text |
# Run before a release
maji-todo .
# See only high-priority items
maji-todo . --type FIXME,BUG
# Find stale items older than 60 days
maji-todo . --stale --age 60
# Focus on one author's TODOs
maji-todo . --owner mung
maji-debug — for any BUG-tagged TODOs that need diagnosismaji-refactor — for HACK-tagged items requiring redesignmaji-review — surface TODOs introduced in current PRmaji-mode — token discipline appliesOPTIMIZE, SECURITY, DEPRECATED).ts, .tsx, .py, etc.)maji-todo is part of MAJI Skills · By MAJI · No Codes, Only Vibes.