no-comments について
コメントや抑制指定の検出を Comment Sicko サブエージェントに委任し、報告の評価と範囲内の修正を支援するコードレビュー用スキルです。根本原因の修正を重視し、未解決事項も報告します。
主な機能
- 01Comment Sicko にレビューを委任
- 02差分に照らして指摘を確認
- 03範囲外の変更を却下
- 04受け入れた問題を根本から修正
- 05修正と未解決事項を報告
活用シーン
- 01変更セット内のコメントをレビュー
- 02lint と TypeScript の抑制指定を監査
- 03対応可能なコメントを範囲内で削除
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hachej/ boring-stack --skill no-commentsインストール後、Claude Code で/no-commentsを入力して読み込まれたか確認します。
同梱ファイルLICENSEreferences/comment-sicko.md
詳細
コメントなし
Comment Sicko を起動します。受け入れた指摘に対応します。
Comment Sicko の新鮮な視点を尊重します。
対象範囲
呼び出し元のファイルまたは diff を使用します。それ以外の場合は、デフォルトの main を基点ブランチとして、作業ツリーを含む現在の diff を使用します。
手順
subagent_type: "Comment Sicko"を指定してTaskを起動します。対象範囲を渡します。そのルールを言い直してはいけません。- レポートと diff を確認します。アプリケーションコードへの編集、対象範囲からの逸脱、例外で保護された削除、誤った
MUST KILLの理由、意図的に残されたコードを問題ありとするフラグは却下します。自分たちのコードに関する予想外の点を示すフラグは、引き続き対応可能な状態にします。これらのコメントは復元しません。残すコメントは、変更できないものについて述べているという証拠がある場合に限り残します。見落とされた対象範囲内の lint と TypeScript の抑制を監査します。正確性または安全性に関する抑制は、引き続き対応が必要なMUST KILLとします。削除の復元は、正確な例外と対象範囲に関する証拠がある場合に限ります。内容の薄いIMPORTANTやdo not removeの削除指示または残置判断を受け入れる前に、そのシンボルに対して/howまたは/whyを実行します。削除指示が曖昧な場合は復元しません。残置判断に反証がある場合、または依然として曖昧な場合は削除します。却下したレポートを、失敗の内容を明示して元に戻し、再実行します。2 回目も却下する場合は、その旨を報告して/no-commentsを失敗させます。 - 受け入れた些細なフラグは、不要なパスの削除、パラメーターの削除、または実際の API の使用によって直接修正します。修正に設計が必要な場合は、受け入れた項目一式と周辺コードについて
/architectを一度実行します。スケッチの段階で止めます。設計は Architect が行います。手順 4 で実装します。 - 対象範囲内で、根本原因に対する最小限の修正を実装します。指摘された回避策はすべて削除します。根本原因が対象範囲外にある場合は、対象範囲内で最小限の修正を行い、残りは未対応として報告します。principle-fix-root-causes と principle-redesign-from-first-principles のスキルは、意図の指針としてのみ使用します。いずれも対象範囲を広げたり、範囲外の事例を修正したりする許可にはなりません。症状に対するガードを追加してはいけません。
- 制約コメントには
do not remove、do not change wording、またはtalk to X before changingと記載されています。変更できないものに関する残置判断はそのままにします。対象範囲内で最も低コストな型、実行時、テスト、または CI lint を提案します。対話的な承認を待ちます。無人実行および評価では、呼び出し元による事前承認が必要です。承認された場合は、制約をコード化してから削除します。承認されない場合は削除し、制約を未対応として報告し、範囲外の作業を簡潔に示します。 - 削除数、復元したコメント、再実行、architect のスケッチ、修正、コード化の提案、コード化した制約、未適用の制約、その他の未対応事項を報告します。
コメント
Markdown 対応