[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77JQ1XESSFX1D7TBNQE3CCE":3,"skill-same:01M77JQ1XESSFX1D7TBNQE3CCE":46},{"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},"01M77JQ1XESSFX1D7TBNQE3CCE","technical-writing",null,"階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。\u002Ftechnical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。","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\u002Ftechnical-writing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: technical-writing\ndescription: \"階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。\u002Ftechnical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。\"\n---\n\n# Technical writing\n\n目標は、疲れたエンジニアが一読で理解できる文章を書くことである。そこへ至る層は 4 つあり、それぞれ問いが 1 つずつある。この文書はどの種類か、文は読者にどう語りかけるか、各文はどれだけの情報を運ぶか、二通りに読める文はないか。4 つすべてを適用する。\n\n層の上位に 3 つのルールがある。\n\n- **働いていない語はすべて削る。** ある語なしでも文が成り立つなら、その語は消す。「In order to」は「to」である。「It is important to note that」は何も言っていない。\n- **短い日常語を使う。** 「utilize」ではなく「use」。「facilitate」ではなく「help」。「perform」ではなく「do」。長い語は、その長さに見合う精度で対価を払わなければならない。\n- **ルールが文を悪くするなら、別の方法で文を直すか、そのままにしておく。** ルールは読者に仕える。すべてのルールに従いながら機械が書いたように聞こえる文は、失敗している。\n\nコードベースが語彙表である。実際のシンボル、ファイル、フラグ、コマンドの名前を書き、同義語やその説明を書かない。\n\n専門用語を発明しない。開発者が声に出して言う語を使う。「evacuate」「ratchet」「endgame」ではなく、「move」「delete」「a budget that only decreases」。名前の付いたパターンは、文書が初出時にその意味を述べていれば問題ない。新しい違反語とその置き換えを、`unslop` の抽象メタファールールへの追加として、diff 付きで返答の中に提案する。そのスキルを編集してはならない。\n\n## リズムを変える\n\n層は、文書が何を言うか、各文がどれだけ運ぶかを決める。文書はそれらすべてに従っていても、なお機械が書いたように読めることがある。すべての文が短く刈り込まれ、どこにも見解がなく、具体的なものが何もない。\n\n- 文の長さを意図的に混ぜる。短い文は要点を打ち込む。時間をかける長い文は、事実をその条件や帰結とともに運ぶ。\n- 一文一思考は、一文一長さを意味しない。2 つの思考を運ぶ文は分割する。1 つの思考を運ぶ長い文は残す。\n- モードが許すところでは見解を持つ。説明はトレードオフを秤にかけるものなので、長所と短所を列挙するのではなく、それをどう考えるかを述べる。リファレンスは乾いたままにする。\n- 無味乾燥より具体的に。「schema changes can cause issues」ではなく「a column rename fails the build」。\n\n## まずモードを選ぶ（Diátaxis）\n\n1 つの文書、1 つのモード。2 つの問いで選ぶ。内容は行動（doing）に資するか、理解（thinking）に資するか。そして学習に役立つか、仕事に役立つか。\n\n- 行動 + 学習: **チュートリアル**。\n- 行動 + 仕事: **ハウツー**。\n- 理解 + 仕事: **リファレンス**。\n- 理解 + 学習: **説明**。\n\nこのコンパスは文書全体にも、1 つの文にも使う。\n\n**チュートリアル: 実践による学習。** 自分は教師である。学習者の成功は自分の仕事であり、学習者の仕事ではない。学習者が何を「学ぶ」かではなく、何を作るかを述べて始める。すべてのステップが目に見える結果を、早く、頻繁に生む。何が見えるはずかを伝える。期待される出力、プロンプトの変化、ログの行。説明は 1 節とリンク 1 つに削る。教えるための中断は授業を壊す。具体的であり続ける。「we」として、命令で書く。「First, do x. Now, do y.」\n\n**ハウツー: 目標へのステップ。** 機械が実行できる操作ではなく、人が抱える問題を解く。能力があると仮定する。教えることは飛ばす。行動のみ。脱線なし、背景なし、完全性のための完全性なし。それらはリンクで代える。分岐と判断を許す。「If you want x, do y.」ガイドの名前はタスクで付ける。「Radar array calibration」ではなく「How to calibrate the radar array」。\n\n**リファレンス: 参照のための事実。** 記述する。記述だけをする。指示なし、説得なし、意見なし。乾いていて、完全で、確かであること。事実、選択肢、制限、エラーを、保険をかけずに述べる。記述対象の構造を映し、コードと文書を一緒にたどれるようにする。読者が期待する場所に素材を置く。可能ならコードから生成し、真であり続けるようにする。\n\n**説明: 理解と理由。** 境界のある 1 つのトピックで、製品から離れても読める。各タイトルは、先頭に暗黙の「About...」を付けても耐えられるべきである。実際の「なぜ」の問いに根ざす。文脈を与える。設計上の決定、歴史、制約、代替案。意見はここでは許され、他のどこでも許されない。\n\nモードを混ぜない。チュートリアルの中にリファレンスの表を入れない、リファレンスの中にチュートリアルの手取り足取りを入れない、ハウツーの中で論争しない。代わりに分割してリンクする。\n\n出典: diataxis.fr、2026-07-18 取得。\n\n## 読者に向けて文を書く（Google developer style）\n\n- 読者に「you」で、現在形で語りかける。「Will」は本当に後で起きることにだけ使う。\n- 誰が何をするかを言う。「is checked」ではなく「the compiler checks」。受動態は、行為者が不明か重要でないときだけ許される。\n- 指示は命令として書く。「Click Submit.」事実は平易に述べる。「should be done」は決して使わない。\n- 条件を指示の前に置く。「To delete the document, click Delete.」読者は該当しないものを飛ばす。\n- 一般的なケースを先に置く。例外は後。\n- 知識のある友人のように聞こえること。バズワードなし、比喩表現なし、指示に「please」なし、手順に「simply」「easy」「quickly」は決して使わない。簡単なら、読者はここにいない。\n- 予告しない（「we will soon support...」）。連続する文を同じ句で始めない。\n- リンク先がどこかを言う語でリンクする。ページタイトルか短い説明。「click here」は決して使わない。ページ外へのリンクより、ページ上の文脈の一文を優先する。\n- 見出しは主題だけでなく要点を運ぶ（「Modes」ではなく「Pick the mode first」）。センテンスケース。タスクの見出しは動詞句だけにする（「Create an instance」）。概念の見出しは名詞句。ページに h1 は 1 つ、レベルを飛ばさない。\n- 順序には番号付きリスト、それ以外はすべて箇条書き。リストは完全な文で導入する。項目は並列に保つ。\n- コードはコードフォントに。UI 要素は太字に。シリアルコンマを使う。「etc.」は落とし、リストが一部であることを最初に言う。\n\n出典: developers.google.com\u002Fstyle、2026-07-18 取得。\n\n## 文を 1 つずつ読み込ませる（STE ルール）\n\n- 1 文につき指示 1 つ。それ以外はすべて 1 文につき思考 1 つ。\n- 約 20 語を超える指示と、約 25 語を超えるその他の文は分割する。\n- 警告や条件は、それが守るステップの前に置く。「If hot oil touches your skin, injuries can occur.」\n- 「the」と「a」を残す。「Remove backup file」は二通りに読める。「Remove the backup file」は一通りに読める。\n- 各語に 1 つの意味と 1 つの役割を与え、それを守る。「check」が点検を意味するなら、抑止の意味でも使わない。\n- 行動ごとに 1 語を選び、それを貫く。ここでは「start」、あそこでは「initiate」ではなく、「start」。\n- 手順は直接の命令として書き、決して叙述にせず、決して受動態にしない。「the component must be installed」ではなく「Install the component」。\n- 可能なところでは「-ing」の語を避ける。文法上の役割を多く担いすぎ、誤読を生む。\n\n出典: asd-ste100.org（Issue 9、2025）、2026-07-18 取得。番号付きルールと辞書は仕様 PDF にある。上の原則は、他へ持ち運べる中核である。\n\n## 二通りに読める文を残さない（Global English）\n\n- 「only」や「not」のような語は、それが変える語の隣に置く。「only fails on growth」と「fails only on growth」は違うことを言う。\n- 長い名詞の連なりを分解する。「the proto import budget check script」は「the script that checks the proto-import budget」になる。\n- すべての「it」「they」「this」が 1 つの明白なものを指すようにする。迷ったら名詞を繰り返す。節全体を指すために「this」や「which」を決して使わない。\n- 動詞を落とさない。「Phase 1 moves the converters and Phase 2 the runtime」は Phase 2 に動詞がない。動詞を与える。\n- 構造を示す小さな語を残す。「Ensure that the switch is off」は、文の解釈を一通りにするので「that」を残す。明快さを語数と決して交換しない。\n- 誤読を防ぐなら、並列の中で冠詞を繰り返す。2 つのものであるなら、「the client and host」ではなく「the client and the host」。\n- 文が二通りにまとまり得るときは、「and」や「or」がどの部分を結ぶかを言う。「Both...and」「either...or」「if...then」はコストのかからない曖昧さ解消手段である。\n- セミコロンではなくピリオドを使う。em ダッシュは新しい文に置き換える。\n- 括弧内のテキストは、完全な文法単位か、それ自体で 1 文にする。「(s)」で複数形を決して作らない。\n- スラッシュなし。「a\u002Fb」や「and\u002For」ではなく「a, b, or both」と書く。\n- 各事物を、どこでも 1 つの名前で呼ぶ。1 つのものを「the gate」「the ratchet」「the budget check」と呼ぶ文書は、3 つのものを教えている。編集の間に、変わっていない文を言い換えるのも同じ代償を払う。変わっていないものをかき回さない。\n- 慣用句、口語表現、ラテン語の略語、メタファーは避ける。非ネイティブの読者、翻訳者、エージェントはいずれも、平易な構文を最もよく解析する。\n\n出典: Kohl, The Global English Style Guide（SAS Press）。ガイドライン本文は Internet Archive と SAS のサンプル章から 2026-07-18 に取得。\n\n## 文体とリポジトリ固有の事項\n\n- このスキルが触れるすべての文書に **unslop** スキルを適用する。そのスキルがスロップパターンのカタログを所有する。AI 語彙、フィラー、保険をかける表現、書式上の痕跡。\n- PR の説明とコミットメッセージも文章である。Diátaxis を除くすべての層がそれらに適用される。PR 本文は、レビュアーが 1 分以内に読めるブリーフィングである。swarm のログ、SHA の一覧、メトリクスの表を貼り付けない。リンクする。\n- 製品の UI 文字列はドキュメントではない。それらには自分の製品のコピーガイドラインを使う。\n- コードスニペットはタブでインデントする。実際のパスと実際のシンボルを書く。件数やツリーに関するすべての主張を、それを取り込むコミット時点で真にし、それを再生成するコマンドを含める。\n\n## 実例\n\n修正前:\n\n> Configuration of the proto import ratchet budget script parameters is performed via budget.json. Note that it's important to remember that running with --write, which updates the committed budget to reflect the current count, should only be done when lowering it. If exceeded, CI fails.\n\n修正後:\n\n> `budget.mjs` reads the committed budget from `budget.json` and counts the files that import protos. If the count exceeds the budget, CI fails. Run `budget.mjs --write` only to lower the budget.\n\n## レビューチェックリスト\n\nこのスキルが対象とするあらゆる文章に適用する。項目 1 は文書集合にのみ適用される。\n\n1. 各ファイルは 1 つの Diátaxis モードで、モードが接するところにリンクがあるか。\n2. すべての指示が、条件を前に置いた命令として書かれているか。\n3. 2 つの指示または 2 つの思考を運ぶ文はあるか。分割する。\n4. 意味を失わずに削れる語はあるか。削る。\n5. 「only」はそれが変える語の隣にあるか。すべての「it」は 1 つのものを指しているか。すべての節は動詞を保っているか。\n6. 各事物は文書全体でちょうど 1 つの名前を持つか。\n7. 開発者はこれらの語を声に出して言うか。発明されたメタファーや気取った同義語を、平易な語か実際のシンボル名に置き換える。\n8. すべてのシンボル、パス、件数はこのコミット時点で実在し、件数を再生成するコマンドが付いているか。\n","# Technical writing\n\n目標は、疲れたエンジニアが一読で理解できる文章を書くことである。そこへ至る層は 4 つあり、それぞれ問いが 1 つずつある。この文書はどの種類か、文は読者にどう語りかけるか、各文はどれだけの情報を運ぶか、二通りに読める文はないか。4 つすべてを適用する。\n\n層の上位に 3 つのルールがある。\n\n- **働いていない語はすべて削る。** ある語なしでも文が成り立つなら、その語は消す。「In order to」は「to」である。「It is important to note that」は何も言っていない。\n- **短い日常語を使う。** 「utilize」ではなく「use」。「facilitate」ではなく「help」。「perform」ではなく「do」。長い語は、その長さに見合う精度で対価を払わなければならない。\n- **ルールが文を悪くするなら、別の方法で文を直すか、そのままにしておく。** ルールは読者に仕える。すべてのルールに従いながら機械が書いたように聞こえる文は、失敗している。\n\nコードベースが語彙表である。実際のシンボル、ファイル、フラグ、コマンドの名前を書き、同義語やその説明を書かない。\n\n専門用語を発明しない。開発者が声に出して言う語を使う。「evacuate」「ratchet」「endgame」ではなく、「move」「delete」「a budget that only decreases」。名前の付いたパターンは、文書が初出時にその意味を述べていれば問題ない。新しい違反語とその置き換えを、`unslop` の抽象メタファールールへの追加として、diff 付きで返答の中に提案する。そのスキルを編集してはならない。\n\n## リズムを変える\n\n層は、文書が何を言うか、各文がどれだけ運ぶかを決める。文書はそれらすべてに従っていても、なお機械が書いたように読めることがある。すべての文が短く刈り込まれ、どこにも見解がなく、具体的なものが何もない。\n\n- 文の長さを意図的に混ぜる。短い文は要点を打ち込む。時間をかける長い文は、事実をその条件や帰結とともに運ぶ。\n- 一文一思考は、一文一長さを意味しない。2 つの思考を運ぶ文は分割する。1 つの思考を運ぶ長い文は残す。\n- モードが許すところでは見解を持つ。説明はトレードオフを秤にかけるものなので、長所と短所を列挙するのではなく、それをどう考えるかを述べる。リファレンスは乾いたままにする。\n- 無味乾燥より具体的に。「schema changes can cause issues」ではなく「a column rename fails the build」。\n\n## まずモードを選ぶ（Diátaxis）\n\n1 つの文書、1 つのモード。2 つの問いで選ぶ。内容は行動（doing）に資するか、理解（thinking）に資するか。そして学習に役立つか、仕事に役立つか。\n\n- 行動 + 学習: **チュートリアル**。\n- 行動 + 仕事: **ハウツー**。\n- 理解 + 仕事: **リファレンス**。\n- 理解 + 学習: **説明**。\n\nこのコンパスは文書全体にも、1 つの文にも使う。\n\n**チュートリアル: 実践による学習。** 自分は教師である。学習者の成功は自分の仕事であり、学習者の仕事ではない。学習者が何を「学ぶ」かではなく、何を作るかを述べて始める。すべてのステップが目に見える結果を、早く、頻繁に生む。何が見えるはずかを伝える。期待される出力、プロンプトの変化、ログの行。説明は 1 節とリンク 1 つに削る。教えるための中断は授業を壊す。具体的であり続ける。「we」として、命令で書く。「First, do x. Now, do y.」\n\n**ハウツー: 目標へのステップ。** 機械が実行できる操作ではなく、人が抱える問題を解く。能力があると仮定する。教えることは飛ばす。行動のみ。脱線なし、背景なし、完全性のための完全性なし。それらはリンクで代える。分岐と判断を許す。「If you want x, do y.」ガイドの名前はタスクで付ける。「Radar array calibration」ではなく「How to calibrate the radar array」。\n\n**リファレンス: 参照のための事実。** 記述する。記述だけをする。指示なし、説得なし、意見なし。乾いていて、完全で、確かであること。事実、選択肢、制限、エラーを、保険をかけずに述べる。記述対象の構造を映し、コードと文書を一緒にたどれるようにする。読者が期待する場所に素材を置く。可能ならコードから生成し、真であり続けるようにする。\n\n**説明: 理解と理由。** 境界のある 1 つのトピックで、製品から離れても読める。各タイトルは、先頭に暗黙の「About...」を付けても耐えられるべきである。実際の「なぜ」の問いに根ざす。文脈を与える。設計上の決定、歴史、制約、代替案。意見はここでは許され、他のどこでも許されない。\n\nモードを混ぜない。チュートリアルの中にリファレンスの表を入れない、リファレンスの中にチュートリアルの手取り足取りを入れない、ハウツーの中で論争しない。代わりに分割してリンクする。\n\n出典: diataxis.fr、2026-07-18 取得。\n\n## 読者に向けて文を書く（Google developer style）\n\n- 読者に「you」で、現在形で語りかける。「Will」は本当に後で起きることにだけ使う。\n- 誰が何をするかを言う。「is checked」ではなく「the compiler checks」。受動態は、行為者が不明か重要でないときだけ許される。\n- 指示は命令として書く。「Click Submit.」事実は平易に述べる。「should be done」は決して使わない。\n- 条件を指示の前に置く。「To delete the document, click Delete.」読者は該当しないものを飛ばす。\n- 一般的なケースを先に置く。例外は後。\n- 知識のある友人のように聞こえること。バズワードなし、比喩表現なし、指示に「please」なし、手順に「simply」「easy」「quickly」は決して使わない。簡単なら、読者はここにいない。\n- 予告しない（「we will soon support...」）。連続する文を同じ句で始めない。\n- リンク先がどこかを言う語でリンクする。ページタイトルか短い説明。「click here」は決して使わない。ページ外へのリンクより、ページ上の文脈の一文を優先する。\n- 見出しは主題だけでなく要点を運ぶ（「Modes」ではなく「Pick the mode first」）。センテンスケース。タスクの見出しは動詞句だけにする（「Create an instance」）。概念の見出しは名詞句。ページに h1 は 1 つ、レベルを飛ばさない。\n- 順序には番号付きリスト、それ以外はすべて箇条書き。リストは完全な文で導入する。項目は並列に保つ。\n- コードはコードフォントに。UI 要素は太字に。シリアルコンマを使う。「etc.」は落とし、リストが一部であることを最初に言う。\n\n出典: developers.google.com\u002Fstyle、2026-07-18 取得。\n\n## 文を 1 つずつ読み込ませる（STE ルール）\n\n- 1 文につき指示 1 つ。それ以外はすべて 1 文につき思考 1 つ。\n- 約 20 語を超える指示と、約 25 語を超えるその他の文は分割する。\n- 警告や条件は、それが守るステップの前に置く。「If hot oil touches your skin, injuries can occur.」\n- 「the」と「a」を残す。「Remove backup file」は二通りに読める。「Remove the backup file」は一通りに読める。\n- 各語に 1 つの意味と 1 つの役割を与え、それを守る。「check」が点検を意味するなら、抑止の意味でも使わない。\n- 行動ごとに 1 語を選び、それを貫く。ここでは「start」、あそこでは「initiate」ではなく、「start」。\n- 手順は直接の命令として書き、決して叙述にせず、決して受動態にしない。「the component must be installed」ではなく「Install the component」。\n- 可能なところでは「-ing」の語を避ける。文法上の役割を多く担いすぎ、誤読を生む。\n\n出典: asd-ste100.org（Issue 9、2025）、2026-07-18 取得。番号付きルールと辞書は仕様 PDF にある。上の原則は、他へ持ち運べる中核である。\n\n## 二通りに読める文を残さない（Global English）\n\n- 「only」や「not」のような語は、それが変える語の隣に置く。「only fails on growth」と「fails only on growth」は違うことを言う。\n- 長い名詞の連なりを分解する。「the proto import budget check script」は「the script that checks the proto-import budget」になる。\n- すべての「it」「they」「this」が 1 つの明白なものを指すようにする。迷ったら名詞を繰り返す。節全体を指すために「this」や「which」を決して使わない。\n- 動詞を落とさない。「Phase 1 moves the converters and Phase 2 the runtime」は Phase 2 に動詞がない。動詞を与える。\n- 構造を示す小さな語を残す。「Ensure that the switch is off」は、文の解釈を一通りにするので「that」を残す。明快さを語数と決して交換しない。\n- 誤読を防ぐなら、並列の中で冠詞を繰り返す。2 つのものであるなら、「the client and host」ではなく「the client and the host」。\n- 文が二通りにまとまり得るときは、「and」や「or」がどの部分を結ぶかを言う。「Both...and」「either...or」「if...then」はコストのかからない曖昧さ解消手段である。\n- セミコロンではなくピリオドを使う。em ダッシュは新しい文に置き換える。\n- 括弧内のテキストは、完全な文法単位か、それ自体で 1 文にする。「(s)」で複数形を決して作らない。\n- スラッシュなし。「a\u002Fb」や「and\u002For」ではなく「a, b, or both」と書く。\n- 各事物を、どこでも 1 つの名前で呼ぶ。1 つのものを「the gate」「the ratchet」「the budget check」と呼ぶ文書は、3 つのものを教えている。編集の間に、変わっていない文を言い換えるのも同じ代償を払う。変わっていないものをかき回さない。\n- 慣用句、口語表現、ラテン語の略語、メタファーは避ける。非ネイティブの読者、翻訳者、エージェントはいずれも、平易な構文を最もよく解析する。\n\n出典: Kohl, The Global English Style Guide（SAS Press）。ガイドライン本文は Internet Archive と SAS のサンプル章から 2026-07-18 に取得。\n\n## 文体とリポジトリ固有の事項\n\n- このスキルが触れるすべての文書に **unslop** スキルを適用する。そのスキルがスロップパターンのカタログを所有する。AI 語彙、フィラー、保険をかける表現、書式上の痕跡。\n- PR の説明とコミットメッセージも文章である。Diátaxis を除くすべての層がそれらに適用される。PR 本文は、レビュアーが 1 分以内に読めるブリーフィングである。swarm のログ、SHA の一覧、メトリクスの表を貼り付けない。リンクする。\n- 製品の UI 文字列はドキュメントではない。それらには自分の製品のコピーガイドラインを使う。\n- コードスニペットはタブでインデントする。実際のパスと実際のシンボルを書く。件数やツリーに関するすべての主張を、それを取り込むコミット時点で真にし、それを再生成するコマンドを含める。\n\n## 実例\n\n修正前:\n\n> Configuration of the proto import ratchet budget script parameters is performed via budget.json. Note that it's important to remember that running with --write, which updates the committed budget to reflect the current count, should only be done when lowering it. If exceeded, CI fails.\n\n修正後:\n\n> `budget.mjs` reads the committed budget from `budget.json` and counts the files that import protos. If the count exceeds the budget, CI fails. Run `budget.mjs --write` only to lower the budget.\n\n## レビューチェックリスト\n\nこのスキルが対象とするあらゆる文章に適用する。項目 1 は文書集合にのみ適用される。\n\n1. 各ファイルは 1 つの Diátaxis モードで、モードが接するところにリンクがあるか。\n2. すべての指示が、条件を前に置いた命令として書かれているか。\n3. 2 つの指示または 2 つの思考を運ぶ文はあるか。分割する。\n4. 意味を失わずに削れる語はあるか。削る。\n5. 「only」はそれが変える語の隣にあるか。すべての「it」は 1 つのものを指しているか。すべての節は動詞を保っているか。\n6. 各事物は文書全体でちょうど 1 つの名前を持つか。\n7. 開発者はこれらの語を声に出して言うか。発明されたメタファーや気取った同義語を、平易な語か実際のシンボル名に置き換える。\n8. すべてのシンボル、パス、件数はこのコミット時点で実在し、件数を再生成するコマンドが付いているか。\n",{"name":5,"description":7},"main","167c6691adf7e788205650c1a62c10567e69a75f","skills\u002Fpstack-skills\u002Ftechnical-writing","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 technical-writing",{"tool":38,"command":39},"bunx","bunx skills add seiei-sogen\u002Fagent-skills --skill technical-writing",{"tool":41,"command":42},"pnpm","pnpm dlx skills add seiei-sogen\u002Fagent-skills --skill technical-writing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Ftechnical-writing\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"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":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"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":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M77JQ8KDCH24TVAF36J7DKXS","unslop","あらゆる文章から AI の痕跡を削る。常に適用しなければならない。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"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":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"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":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M77JQ06FQB1C881N9R1ZWKT9","teach","ある作業のまとまりを平易に説明し、人が本当に理解できるようにする。`how` と `why` のスキルを実行し、その発見を 1 つの明快な説明に織り込む。'これを教えて'、'X を本当に理解する手助けをして'、'この変更またはサブシステムを説明して'に使う。","https:\u002F\u002Fgithub.com\u002Fseiei-sogen\u002Fagent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fpstack-skills\u002Fteach\u002FSKILL.md",[],[]]