メニュー
Prune nonessential comments and docstrings across a codebase. Use when asked to remove verbose or redundant comments, tighten documentation, or make comment style uniform. Aggressive downsizing, but retain high-value information.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Multi-agent review/refine loop. Use after a change or milestone, or when asked to review work: fan out fresh-context, single-focus reviewers across distinct tools, consolidate and fix, add a regression test for every defect, and repeat until reviews stay clean for three consecutive turns.
Keep the Python Cyphal rewrite in wire-visible behavioral parity with the C reference at `reference/cy`. Use when auditing/reviewing parity drift, identifying wire/state-machine discrepancies, updating `src/pycyphal2/` to match reference behavior, replacing conflicting Python tests with C-parity expectations, and adding regression tests for every discovered divergence. API-level discrepancies are by design and are to be ignored; this skill focuses on wire-visible and state-machine behavior only.
| name | comment-cleanup |
| description | Prune nonessential comments and docstrings across a codebase. Use when asked to remove verbose or redundant comments, tighten documentation, or make comment style uniform. Aggressive downsizing, but retain high-value information. |
Trim ALL comments/docstrings EXCEPT those that carry information a competent reader could not reconstruct from names, signatures, and code in a few seconds.
REMOVE: name-echo describers, control flow / type / structure narration, section-divider banners, value-trace and "what the next line does" comments, type-obvious prose.
KEEP: design rationale (the WHY), gotchas and edge-cases, contracts and invariants, cross-references, standards or paper citations, hardware and timing facts, and the provenance of a regression test.
When uncertain whether something is rationale or restatement, keep it. The expensive mistake is erasing valuable information, not leaving one extra obvious line.
Functional comments are not prose: type-checker and linter directives, formatter on/off switches, coverage pragmas, shebangs, and encoding lines. Preserve every one. Never delete a docstring that is a block's only body — it breaks syntax; reduce it to a terse line or a bare ellipsis instead.
This safety net is what lets you cut confidently. Parse each file before and after, strip the docstrings from both, and compare the syntax trees: equality proves only comments and docstrings changed, since comments never appear in the tree. Treat an empty body, a bare ellipsis, and a lone pass as equivalent, so converting a sole-body docstring passes. Run it after auto-formatting. The type checker is the separate guard that no functional directive was lost.
Partition by file ownership so agents never share a file, and never let an agent run a history-rewriting or revert command — it destroys a sibling's concurrent work; undo mistakes by hand-editing. Keep the verification script out of their writable set; they only run it. Fresh subagents apply a given policy more willingly than ones asked to reverse an earlier, more conservative instruction.
When the cutting is done, audit every deletion once more for erased rationale and restore the genuine losses. Run review agents to cross-check the results. Then format, type-check, and run the full test suite before committing. A differential fuzzer or a simulation pass, if the project has one, is strong independent proof that behavior is unchanged.
