anti-ai-slop-tsdoc-fixer
現在の Git ブランチで追加・変更した関数、schema、オブジェクト、定数のコメントを整備する。コメントがない定義への追加や、tsdoc-writing の形式に合わない既存コメントの書き直しに使う。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- anti-ai-slop-tsdoc-fixer
- description
- 現在の Git ブランチで追加・変更した関数、schema、オブジェクト、定数のコメントを整備する。コメントがない定義への追加や、tsdoc-writing の形式に合わない既存コメントの書き直しに使う。
03 SKILL.md 正文
AI Slop TSDoc Fixer
現在のブランチで実装した定義を確認し、tsdoc-writing スキルを使ってコメントを追加・修正する。
対象を確定する
- Git の状態を確認し、PR のベースブランチやリポジトリの規約から比較先を特定する。特定できなければユーザーに確認する。
- 比較先との merge-base から HEAD までの差分に加え、staged、unstaged、untracked の変更を確認する。
- 追加・変更された TypeScript ファイルから、対象となる関数、schema、オブジェクト、定数を列挙する。export の有無を問わず、変更行を含む定義全体とそのコメントを読む。同じファイル内でも、今回の変更に関係しない定義は対象外とする。
tsdoc-writing で整備する
tsdoc-writing の SKILL.md を読み、その規約と手順を適用する。このリポジトリでは tsdoc-writing を参照する。移設先では利用可能な同名スキルを探し、見つからなければその旨を報告して止める。
スキルに渡す対象は、上で列挙した定義に限定する。コメント形式の判断基準は tsdoc-writing を正とし、ここに複製しない。
- コメントがない定義には、規約に沿ったコメントを追加する。
- コメントがあるものの規約の形式に合わない定義は、意味のある説明を保ちながらコメントを書き直す。
- 規約に沿っているコメントは維持する。
説明の根拠が不足している場合は、呼び出し元や関連する型・テストを確認する。実装から分からない仕様は推測で補わない。 変更はコメントに限定し、実装、シグネチャ、値、テスト名は維持する。ライセンス表記やツール向けの指示コメントは保持する。
確認と報告
対象の全定義に規約に沿ったコメントがあることと、今回の編集がコメントだけであることを差分で確認する。変更したファイルと、コメントを追加・書き直した定義を簡潔に報告する。対象がなければ、その旨を報告して終了する。
04 同仓库更多 Skills
why
「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。
what-did-i-get-done
ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する
unslop
あらゆる文章から AI の痕跡を削る。常に適用しなければならない。
typescript-best-practices
TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。
thermo-nuclear-code-quality-review
抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。
technical-writing
階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。