AGENT SKILL

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 スキルを使ってコメントを追加・修正する。

対象を確定する

  1. Git の状態を確認し、PR のベースブランチやリポジトリの規約から比較先を特定する。特定できなければユーザーに確認する。
  2. 比較先との merge-base から HEAD までの差分に加え、staged、unstaged、untracked の変更を確認する。
  3. 追加・変更された TypeScript ファイルから、対象となる関数、schema、オブジェクト、定数を列挙する。export の有無を問わず、変更行を含む定義全体とそのコメントを読む。同じファイル内でも、今回の変更に関係しない定義は対象外とする。

tsdoc-writing で整備する

tsdoc-writing の SKILL.md を読み、その規約と手順を適用する。このリポジトリでは tsdoc-writing を参照する。移設先では利用可能な同名スキルを探し、見つからなければその旨を報告して止める。

スキルに渡す対象は、上で列挙した定義に限定する。コメント形式の判断基準は tsdoc-writing を正とし、ここに複製しない。

  • コメントがない定義には、規約に沿ったコメントを追加する。
  • コメントがあるものの規約の形式に合わない定義は、意味のある説明を保ちながらコメントを書き直す。
  • 規約に沿っているコメントは維持する。

説明の根拠が不足している場合は、呼び出し元や関連する型・テストを確認する。実装から分からない仕様は推測で補わない。 変更はコメントに限定し、実装、シグネチャ、値、テスト名は維持する。ライセンス表記やツール向けの指示コメントは保持する。

確認と報告

対象の全定義に規約に沿ったコメントがあることと、今回の編集がコメントだけであることを差分で確認する。変更したファイルと、コメントを追加・書き直した定義を簡潔に報告する。対象がなければ、その旨を報告して終了する。

04 同仓库更多 Skills

seiei-sogen
seiei-sogen/agent-skills

why

「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

what-did-i-get-done

ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する

★ 0
seiei-sogen
seiei-sogen/agent-skills

unslop

あらゆる文章から AI の痕跡を削る。常に適用しなければならない。

★ 0
seiei-sogen
seiei-sogen/agent-skills

typescript-best-practices

TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

thermo-nuclear-code-quality-review

抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

technical-writing

階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。

★ 0