no-comments について
コードコメントをレビューするスキルです。comment-sicko サブエージェントに指定ファイルまたは現在の差分を調べさせ、指摘を選別して修正し、未解決事項を報告します。
主な機能
- 01指定ファイルまたは現在の差分を調査
- 02comment-sicko サブエージェントにレビューを委任
- 03報告を監査し範囲外の指摘を除外
- 04妥当な問題を修正して結果を報告
活用シーン
- 01現在のブランチ差分のコメントレビュー
- 02プロジェクト規則に沿ったコメント指摘への対応
- 03Codex など Claude 以外の環境でツール名を解決
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ericlitman/ open-pstack --skill no-commentsインストール後、Claude Code で/no-commentsを入力して読み込まれたか確認します。
詳細
コメントなし
comment-sicko を起動します。受け入れた指摘に対応します。
comment-sicko の新鮮な視点を尊重します。
プラットフォームに関する注記。 Codex やその他の非 Claude ランタイムでは、comment-sicko サブエージェントと以下の Claude ツール名は Claude のデフォルトです。codex-tools.md を参照して解決してください。
対象範囲
呼び出し元のファイルまたは差分を使用します。それ以外の場合は、作業ツリーを含む、ベースブランチ(デフォルトは main)に対する現在の差分を使用します。
手順
subagent_type: "comment-sicko"を指定してAgentを起動します。対象範囲を渡します。各サブエージェントの作業量は、poteto-mode スキルの Subagents セクションに従って設定します。そのルールを言い直してはいけません。- 報告と差分を確認します。アプリケーションコードの編集、対象範囲外への逸脱、例外で保護された削除、誤った
MUST KILLの理由、意図的に残されたコードを問題ありとみなすフラグは却下します。こちらのコードに関する予想外の点を指摘するフラグは、引き続き対応可能な状態にします。そのようなコメントは復元しません。残す判断は、変更できないものについての説明だと証明できる場合に限ります。対象範囲内の lint 抑制と TypeScript 抑制の見落としも監査します。正確性や安全性に関する抑制は、引き続き対応が必要なMUST KILLとします。削除したコメントは、正確な例外と対象範囲内の根拠がある場合に限り復元します。根拠の薄いIMPORTANTやdo not removeの削除・維持を受け入れる前に、そのシンボルに対して/howまたは/whyを実行します。削除の判断が曖昧な場合は復元しません。維持の判断が反証された場合、または依然として曖昧な場合は削除します。却下した報告を、失敗した箇所を明示して元に戻し、再実行します。2回目も却下した場合は、その旨を未解決として報告し、/no-commentsを失敗させます。 - 受け入れた些細な指摘は、不要な経路を削除する、パラメーターを取り除く、または実際の API を使うことで直接修正します。修正に形状の検討が必要な場合は、受け入れた指摘と周辺コードを対象に
/architectを1回実行します。スケッチの段階で止めます。形状の設計は 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 対応