mcpField
N
no-comments

no-comments

github.com/ericlitmanテスト・品質53847 回インストール1 週間前に更新
リポジトリ

no-comments について

コードコメントをレビューするスキルです。comment-sicko サブエージェントに指定ファイルまたは現在の差分を調べさせ、指摘を選別して修正し、未解決事項を報告します。

主な機能

  1. 01指定ファイルまたは現在の差分を調査
  2. 02comment-sicko サブエージェントにレビューを委任
  3. 03報告を監査し範囲外の指摘を除外
  4. 04妥当な問題を修正して結果を報告

活用シーン

  1. 01現在のブランチ差分のコメントレビュー
  2. 02プロジェクト規則に沿ったコメント指摘への対応
  3. 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)に対する現在の差分を使用します。

手順

  1. subagent_type: "comment-sicko" を指定して Agent を起動します。対象範囲を渡します。各サブエージェントの作業量は、poteto-mode スキルの Subagents セクションに従って設定します。そのルールを言い直してはいけません。
  2. 報告と差分を確認します。アプリケーションコードの編集、対象範囲外への逸脱、例外で保護された削除、誤った MUST KILL の理由、意図的に残されたコードを問題ありとみなすフラグは却下します。こちらのコードに関する予想外の点を指摘するフラグは、引き続き対応可能な状態にします。そのようなコメントは復元しません。残す判断は、変更できないものについての説明だと証明できる場合に限ります。対象範囲内の lint 抑制と TypeScript 抑制の見落としも監査します。正確性や安全性に関する抑制は、引き続き対応が必要な MUST KILL とします。削除したコメントは、正確な例外と対象範囲内の根拠がある場合に限り復元します。根拠の薄い IMPORTANT や do not remove の削除・維持を受け入れる前に、そのシンボルに対して /how または /why を実行します。削除の判断が曖昧な場合は復元しません。維持の判断が反証された場合、または依然として曖昧な場合は削除します。却下した報告を、失敗した箇所を明示して元に戻し、再実行します。2回目も却下した場合は、その旨を未解決として報告し、/no-comments を失敗させます。
  3. 受け入れた些細な指摘は、不要な経路を削除する、パラメーターを取り除く、または実際の API を使うことで直接修正します。修正に形状の検討が必要な場合は、受け入れた指摘と周辺コードを対象に /architect を1回実行します。スケッチの段階で止めます。形状の設計は Architect が行い、手順4で実装します。
  4. 対象範囲内で、根本原因に対する最小限の修正を実装します。名前が挙がった回避策はすべて取り除きます。根本原因が対象範囲外にある場合は、対象範囲内で最小限の修正を行い、残りは未解決として報告します。principle-fix-root-causes と principle-redesign-from-first-principles の各スキルは、意図を導くためだけに使います。いずれも対象範囲を広げたり、その外にある箇所を修正したりする根拠にはなりません。症状に対するガードを追加してはいけません。
  5. 制約コメントには do not remove、do not change wording、または talk to X before changing と記載されています。変更できないものに関する維持判断は、そのまま残します。対象範囲内で最も低コストな型、ランタイム、テスト、または CI lint を提案します。対話型の実行では承認を待ちます。無人実行と評価では、呼び出し元による事前承認が必要です。承認された場合は制約をコード化してから削除します。それ以外の場合は削除し、制約を未解決として報告して、対象範囲外の作業案を示します。
  6. 削除数、復元したコメント、再実行、Architect のスケッチ、修正、制約のコード化提案、コード化した制約、強制されていない制約、その他の未解決作業を報告します。

コメント