[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77JN366THHCN913R7MYVSPB":3,"skill-same:01M77JN366THHCN913R7MYVSPB":52},{"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},"01M77JN366THHCN913R7MYVSPB","no-comments",null,"TSDoc とコメントを規約に沿って追加・整備する。新規関数・型の TSDoc 追加、既存コメントの改善に使用する。","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\u002Fpstack-skills\u002Fno-comments\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: no-comments\ndescription: \"TSDoc とコメントを規約に沿って追加・整備する。新規関数・型の TSDoc 追加、既存コメントの改善に使用する。\"\n---\n\n# TSDoc・コメント整備\n\n指定されたファイル（またはディレクトリ配下の TypeScript ファイル）に対して、TSDoc とコメントを追加・改善する。\n\n---\n\n## 対象スコープの決定\n\n| 引数 | スコープ |\n|------|---------|\n| ファイルパス | そのファイルのみ |\n| ディレクトリパス | 配下の `.ts` \u002F `.tsx` ファイル |\n| なし | git diff で変更されたファイル |\n\n---\n\n## 基本方針\n\n- **TSDoc は短く要点だけ**（目安 3〜6 行）。\n- **関数内コメントは理由を書く**（なぜその分岐や処理が必要か）。\n- **オブジェクト周辺コメントは文脈を書く**（値の意味、優先順位、未指定時の扱い）。\n- **既存コメントは整理対象**（冗長なら短く、薄ければ補強）。\n- **挙動は変えない**（コメント改善のみ）。\n\n---\n\n## 絶対ルール\n\n- **TSDoc は `\u002F** ... *\u002F` を使う。**\n- **日本語で書く。**\n- **コメントに型を書かない。**\n  - NG: `@param {string} id` \u002F `id: string`\n- **TSDoc 本文の先頭に `目的:` と `内容:` を必須で書く。**\n  - `目的:` その関数\u002F型が必要な理由を1文で書く。\n  - `内容:` 何をするか（または何を保持するか）を1文で書く。\n- **export される関数には `@returns` を必須で付ける。**\n- **export される関数には入力例と出力例が分かる `@example` を必須で付ける。**\n  - 形式は簡潔でよい（`入力:` \u002F `出力:` の2行で可）。\n- 曖昧語（「適切に」「必要に応じて」「よしなに」など）は使わない。\n\n---\n\n## TSDoc の最小テンプレート（関数）\n\n```ts\n\u002F**\n * 目的: この関数が必要な理由を1文で書く。\n * 内容: 何をするかを1文で書く。\n * @param value 入力値の意味と制約を書く。\n * @returns 返り値の意味と失敗時の扱いを書く。\n * @example\n * 入力: `normalize(\"  user-001 \")`\n * 出力: `\"user-001\"`\n *\u002F\n```\n\n---\n\n## タグ運用\n\n- `@param`: 型ではなく「意味・制約・空値時の扱い」。\n- `@returns`: **必須**。返り値の意味、`null` や `false` を返す条件を明記。\n- `@example`: **必須**（export 関数）。入力例と出力例を最短で示す。\n- `@throws`: 呼び出し側が対処すべき例外がある場合のみ。\n- 不要なタグは増やさない。\n\n---\n\n## 型・オブジェクトコメント方針\n\n- `interface` \u002F `type` の先頭に、役割と利用文脈を1〜2文で書く。\n- プロパティには必要に応じて以下を補足する。\n  - 値の意味\n  - 未指定時の扱い\n  - 他プロパティとの優先順位や関係\n- 設定オブジェクトやマッピングは、定義直前に「なぜこの形か」を1〜2行で書く。\n\n---\n\n## 関数内コメント方針（丁寧寄り）\n\n- 段階ごとに短い見出しコメントを入れる（前処理 \u002F 検証 \u002F 実行 \u002F 後処理）。\n- 早期 return \u002F throw には停止理由を書く。\n- ループは「何を抽出・集計しているか」を書く。\n- DB更新、外部API呼び出し、ログ出力は副作用として明示する。\n- コードの言い換えだけのコメントは書かない。\n\n---\n\n## テストコメント方針\n\n- `describe` \u002F `it` は「何を・条件・結果」が分かる日本語名にする。\n- 必要ならテスト本体へ1〜2行だけ補足する（前提、検証観点、壊れやすい箇所）。\n\n---\n\n## 作業手順\n\n1. 対象ファイルを Read で読み込む\n2. 以下の観点でコメントを追加・改善する\n   - export 関数: `目的:` \u002F `内容:` \u002F `@param` \u002F `@returns` \u002F `@example` を確認\n   - 型定義: 役割と利用文脈のコメントを確認\n   - 関数内: 分岐理由・早期 return 理由・副作用の明示を確認\n3. Edit ツールでコメントのみを変更する（コードの挙動は変えない）\n\n---\n\n## 作業後セルフチェック\n\n- TSDoc は短く保てているか。\n- TSDoc 本文に `目的:` と `内容:` があるか。\n- export 関数に `@returns` があるか。\n- export 関数に入力例\u002F出力例が分かる `@example` があるか。\n- 関数内コメントに「判断理由」が書かれているか。\n- 型をコメントに書いていないか。\n","# TSDoc・コメント整備\n\n指定されたファイル（またはディレクトリ配下の TypeScript ファイル）に対して、TSDoc とコメントを追加・改善する。\n\n---\n\n## 対象スコープの決定\n\n| 引数 | スコープ |\n|------|---------|\n| ファイルパス | そのファイルのみ |\n| ディレクトリパス | 配下の `.ts` \u002F `.tsx` ファイル |\n| なし | git diff で変更されたファイル |\n\n---\n\n## 基本方針\n\n- **TSDoc は短く要点だけ**（目安 3〜6 行）。\n- **関数内コメントは理由を書く**（なぜその分岐や処理が必要か）。\n- **オブジェクト周辺コメントは文脈を書く**（値の意味、優先順位、未指定時の扱い）。\n- **既存コメントは整理対象**（冗長なら短く、薄ければ補強）。\n- **挙動は変えない**（コメント改善のみ）。\n\n---\n\n## 絶対ルール\n\n- **TSDoc は `\u002F** ... *\u002F` を使う。**\n- **日本語で書く。**\n- **コメントに型を書かない。**\n  - NG: `@param {string} id` \u002F `id: string`\n- **TSDoc 本文の先頭に `目的:` と `内容:` を必須で書く。**\n  - `目的:` その関数\u002F型が必要な理由を1文で書く。\n  - `内容:` 何をするか（または何を保持するか）を1文で書く。\n- **export される関数には `@returns` を必須で付ける。**\n- **export される関数には入力例と出力例が分かる `@example` を必須で付ける。**\n  - 形式は簡潔でよい（`入力:` \u002F `出力:` の2行で可）。\n- 曖昧語（「適切に」「必要に応じて」「よしなに」など）は使わない。\n\n---\n\n## TSDoc の最小テンプレート（関数）\n\n```ts\n\u002F**\n * 目的: この関数が必要な理由を1文で書く。\n * 内容: 何をするかを1文で書く。\n * @param value 入力値の意味と制約を書く。\n * @returns 返り値の意味と失敗時の扱いを書く。\n * @example\n * 入力: `normalize(\"  user-001 \")`\n * 出力: `\"user-001\"`\n *\u002F\n```\n\n---\n\n## タグ運用\n\n- `@param`: 型ではなく「意味・制約・空値時の扱い」。\n- `@returns`: **必須**。返り値の意味、`null` や `false` を返す条件を明記。\n- `@example`: **必須**（export 関数）。入力例と出力例を最短で示す。\n- `@throws`: 呼び出し側が対処すべき例外がある場合のみ。\n- 不要なタグは増やさない。\n\n---\n\n## 型・オブジェクトコメント方針\n\n- `interface` \u002F `type` の先頭に、役割と利用文脈を1〜2文で書く。\n- プロパティには必要に応じて以下を補足する。\n  - 値の意味\n  - 未指定時の扱い\n  - 他プロパティとの優先順位や関係\n- 設定オブジェクトやマッピングは、定義直前に「なぜこの形か」を1〜2行で書く。\n\n---\n\n## 関数内コメント方針（丁寧寄り）\n\n- 段階ごとに短い見出しコメントを入れる（前処理 \u002F 検証 \u002F 実行 \u002F 後処理）。\n- 早期 return \u002F throw には停止理由を書く。\n- ループは「何を抽出・集計しているか」を書く。\n- DB更新、外部API呼び出し、ログ出力は副作用として明示する。\n- コードの言い換えだけのコメントは書かない。\n\n---\n\n## テストコメント方針\n\n- `describe` \u002F `it` は「何を・条件・結果」が分かる日本語名にする。\n- 必要ならテスト本体へ1〜2行だけ補足する（前提、検証観点、壊れやすい箇所）。\n\n---\n\n## 作業手順\n\n1. 対象ファイルを Read で読み込む\n2. 以下の観点でコメントを追加・改善する\n   - export 関数: `目的:` \u002F `内容:` \u002F `@param` \u002F `@returns` \u002F `@example` を確認\n   - 型定義: 役割と利用文脈のコメントを確認\n   - 関数内: 分岐理由・早期 return 理由・副作用の明示を確認\n3. Edit ツールでコメントのみを変更する（コードの挙動は変えない）\n\n---\n\n## 作業後セルフチェック\n\n- TSDoc は短く保てているか。\n- TSDoc 本文に `目的:` と `内容:` があるか。\n- export 関数に `@returns` があるか。\n- export 関数に入力例\u002F出力例が分かる `@example` があるか。\n- 関数内コメントに「判断理由」が書かれているか。\n- 型をコメントに書いていないか。\n",{"name":5,"description":7},"main","167c6691adf7e788205650c1a62c10567e69a75f","skills\u002Fpstack-skills\u002Fno-comments","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 no-comments",{"tool":38,"command":39},"bunx","bunx skills add seiei-sogen\u002Fagent-skills --skill no-comments",{"tool":41,"command":42},"pnpm","pnpm dlx skills add seiei-sogen\u002Fagent-skills --skill no-comments","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fno-comments\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",43,"https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fno-comments\u002Fagents\u002Fopenai.yaml",[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"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":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"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":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M77JQ8KDCH24TVAF36J7DKXS","unslop","あらゆる文章から AI の痕跡を削る。常に適用しなければならない。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"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":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"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":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"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",[],[]]