[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77JDNXY4PC8WG95BF241EWB":3,"skill-same:01M77JDNXY4PC8WG95BF241EWB":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M77JDNXY4PC8WG95BF241EWB","anti-ai-slop-no-magic-literal",null,"プログラミング言語を問わず、条件分岐・比較・引数などに散らばる文字列・数値などの意味を持つリテラルをレビューし、既存の定数、列挙、スキーマへまとめる。マジックリテラルの修正や、AI が生成したコードのリファクタリングに使う。","seiei-sogen\u002Fagent-skills","seiei-sogen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F66318252?v=4","01M77JBBV0RG0YC1XP2EP9GCW9","聖永宗玄 Seiei Sōgen","01M77JBBVNEGW6EPDCJECRQ1G5",0,"MIT","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fanti-slop\u002Fanti-ai-slop-no-magic-literal\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: anti-ai-slop-no-magic-literal\ndescription: プログラミング言語を問わず、条件分岐・比較・引数などに散らばる文字列・数値などの意味を持つリテラルをレビューし、既存の定数、列挙、スキーマへまとめる。マジックリテラルの修正や、AI が生成したコードのリファクタリングに使う。\n---\n\n# マジックリテラルを整理する\n\n意味を持つリテラルの用途や取りうる集合を、名前と定義から読み取れる形にする。定数化によって、同じ概念の値が複数箇所で食い違うことを防ぐ。\n\n## 1. 対象と使用言語を確認する\n\n依頼されたファイルまたは差分を対象にする。次の資料を対象ファイルの言語に応じて読み、依存関係、既存の定数・列挙・スキーマ、呼び出し元を確認する。\n\n- TypeScript は [typescript.md](references\u002Ftypescript.md) を読む。\n- Ruby は [ruby.md](references\u002Fruby.md) を読む。\n- ほかの言語は共通手順に従い、その言語の標準機能とプロジェクトの規約を使う。\n\n複数言語の変更では、ファイルごとに対応する資料を使う。言語固有の列挙機能や命名を、ほかの言語へそのまま当てはめない。\n\n## 2. 候補を検出し、修正対象を選ぶ\n\n次の箇所を候補として列挙する。リテラルがあるという理由だけで修正しない。\n\n- 状態・種別・ロールなどを、リテラルと直接比較する箇所。\n- 分岐の選択肢や集合への所属判定に、値を直接列挙する箇所。\n- ドメイン上の値を、引数、キー、添字として直接指定する箇所。\n- 同じ概念を表すリテラルが、複数箇所で繰り返される箇所。\n- 上限、期間、サイズなど、数値だけでは意味や単位が分からない箇所。\n\n次は原則として対象外にする。\n\n- 1箇所だけで使い、意味が自明なファイル名など。\n- ログやエラーメッセージの本文。\n- テストの固定値や期待値。検証対象の定義へ合わせて独立した根拠を失わせない。\n- 外部仕様で固定された、1回だけ使うキー。\n- 値が1つだけで、列挙にしても理解が深まらないもの。\n\n判断基準は、読み手が値の用途や取りうる集合を知る必要があるか、同じ概念の値を一緒に変更すべきかとする。同じ値でも、意味が異なるものはまとめない。\n\n## 3. 値の定義を1箇所にまとめる\n\n候補ごとに、同じ値と意味を持つ既存の定数・列挙・スキーマを探して再利用する。定義がなければ、プロジェクトで採用済みの機構か、その言語の標準機能で表す。単純な定数化のために依存関係を追加しない。\n\n- 値の集合は1箇所で定義し、必要な型や一覧は、利用できる導出機能でそこから得る。\n- 数値には意味が分かる名前を付け、期間やサイズは単位も名前に含める。\n- 元の値、型、単位、評価のタイミングを保つ。リテラルが毎回作られていた場合は、定数化による共有や凍結で挙動が変わらないかも確認する。DB・API・設定ファイルの値を内部都合で変えない。\n- 命名は言語とプロジェクトの規約に従う。\n- 定義はそのドメインのモジュールに置く。1箇所でしか使わないなら、利用側のファイル内に置く。\n- 無関係な値を巨大な共通定数ファイルに集めない。\n\n対象とした同じ概念の参照をすべて更新する。分岐がある場合は、必要な選択肢と不正値の扱いが保たれていることを、言語が提供する網羅性チェックや関連テストで確認する。\n\n公開 API や保存形式の変更が必要な置換は自動で進めず、影響と互換性を保つ代案を報告する。\n\n## 4. 検証して報告する\n\n差分と参照元を確認し、同じ値の二重定義、置換漏れ、過剰な定数化がないことを確かめる。利用できる関連テスト、型チェック、構文チェック、lint を実行する。検索や lint の指摘は発見の補助として使い、修正対象かどうかは手順2の基準で判断する。\n\n修正した箇所と定義先、見送った箇所と理由、互換性の判断が必要な箇所、実行した確認を簡潔に報告する。実行できなかった確認は、その理由も伝える。\n","# マジックリテラルを整理する\n\n意味を持つリテラルの用途や取りうる集合を、名前と定義から読み取れる形にする。定数化によって、同じ概念の値が複数箇所で食い違うことを防ぐ。\n\n## 1. 対象と使用言語を確認する\n\n依頼されたファイルまたは差分を対象にする。次の資料を対象ファイルの言語に応じて読み、依存関係、既存の定数・列挙・スキーマ、呼び出し元を確認する。\n\n- TypeScript は [typescript.md](references\u002Ftypescript.md) を読む。\n- Ruby は [ruby.md](references\u002Fruby.md) を読む。\n- ほかの言語は共通手順に従い、その言語の標準機能とプロジェクトの規約を使う。\n\n複数言語の変更では、ファイルごとに対応する資料を使う。言語固有の列挙機能や命名を、ほかの言語へそのまま当てはめない。\n\n## 2. 候補を検出し、修正対象を選ぶ\n\n次の箇所を候補として列挙する。リテラルがあるという理由だけで修正しない。\n\n- 状態・種別・ロールなどを、リテラルと直接比較する箇所。\n- 分岐の選択肢や集合への所属判定に、値を直接列挙する箇所。\n- ドメイン上の値を、引数、キー、添字として直接指定する箇所。\n- 同じ概念を表すリテラルが、複数箇所で繰り返される箇所。\n- 上限、期間、サイズなど、数値だけでは意味や単位が分からない箇所。\n\n次は原則として対象外にする。\n\n- 1箇所だけで使い、意味が自明なファイル名など。\n- ログやエラーメッセージの本文。\n- テストの固定値や期待値。検証対象の定義へ合わせて独立した根拠を失わせない。\n- 外部仕様で固定された、1回だけ使うキー。\n- 値が1つだけで、列挙にしても理解が深まらないもの。\n\n判断基準は、読み手が値の用途や取りうる集合を知る必要があるか、同じ概念の値を一緒に変更すべきかとする。同じ値でも、意味が異なるものはまとめない。\n\n## 3. 値の定義を1箇所にまとめる\n\n候補ごとに、同じ値と意味を持つ既存の定数・列挙・スキーマを探して再利用する。定義がなければ、プロジェクトで採用済みの機構か、その言語の標準機能で表す。単純な定数化のために依存関係を追加しない。\n\n- 値の集合は1箇所で定義し、必要な型や一覧は、利用できる導出機能でそこから得る。\n- 数値には意味が分かる名前を付け、期間やサイズは単位も名前に含める。\n- 元の値、型、単位、評価のタイミングを保つ。リテラルが毎回作られていた場合は、定数化による共有や凍結で挙動が変わらないかも確認する。DB・API・設定ファイルの値を内部都合で変えない。\n- 命名は言語とプロジェクトの規約に従う。\n- 定義はそのドメインのモジュールに置く。1箇所でしか使わないなら、利用側のファイル内に置く。\n- 無関係な値を巨大な共通定数ファイルに集めない。\n\n対象とした同じ概念の参照をすべて更新する。分岐がある場合は、必要な選択肢と不正値の扱いが保たれていることを、言語が提供する網羅性チェックや関連テストで確認する。\n\n公開 API や保存形式の変更が必要な置換は自動で進めず、影響と互換性を保つ代案を報告する。\n\n## 4. 検証して報告する\n\n差分と参照元を確認し、同じ値の二重定義、置換漏れ、過剰な定数化がないことを確かめる。利用できる関連テスト、型チェック、構文チェック、lint を実行する。検索や lint の指摘は発見の補助として使い、修正対象かどうかは手順2の基準で判断する。\n\n修正した箇所と定義先、見送った箇所と理由、互換性の判断が必要な箇所、実行した確認を簡潔に報告する。実行できなかった確認は、その理由も伝える。\n",{"name":5,"description":7},"main","167c6691adf7e788205650c1a62c10567e69a75f","skills\u002Fanti-slop\u002Fanti-ai-slop-no-magic-literal","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills","https:\u002F\u002Fgithub.com\u002Fseiei-sogen","https:\u002F\u002Fseiei-sogen.github.io","Software Developer\u002FEngineer.","2026-11-12 12:51:47",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add seiei-sogen\u002Fagent-skills --skill anti-ai-slop-no-magic-literal",{"tool":38,"command":39},"bunx","bunx skills add seiei-sogen\u002Fagent-skills --skill anti-ai-slop-no-magic-literal",{"tool":41,"command":42},"pnpm","pnpm dlx skills add seiei-sogen\u002Fagent-skills --skill anti-ai-slop-no-magic-literal","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fanti-slop\u002Fanti-ai-slop-no-magic-literal\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fruby.md","REFERENCE","参考文档",2457,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fanti-slop\u002Fanti-ai-slop-no-magic-literal\u002Freferences\u002Fruby.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Ftypescript.md",3509,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fanti-slop\u002Fanti-ai-slop-no-magic-literal\u002Freferences\u002Ftypescript.md",[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M77JQCQ91W9AK2G7HCAT8TEW","why","「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ（ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス）を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M77JQATY44K4PJ5X1ZK7DGAH","what-did-i-get-done","ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fwhat-did-i-get-done\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M77JQ8KDCH24TVAF36J7DKXS","unslop","あらゆる文章から AI の痕跡を削る。常に適用しなければならない。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M77JQ79R7RB2GNA5EMK7J7T9","typescript-best-practices","TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Ftypescript-best-practices\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M77JQ5CF7TS7Y91V0TXFJC2P","thermo-nuclear-code-quality-review","抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fthermo-nuclear-code-quality-review\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M77JQ1XESSFX1D7TBNQE3CCE","technical-writing","階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。\u002Ftechnical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Ftechnical-writing\u002FSKILL.md",[],[]]