Houkoku

文章・伝達（houkoku）

事実、判断、素材を、読み手が理解し次の判断に使える日本語へ変える。文章のために実装・レビュー・提出をやり直さない。

<!-- hikizan:contract:start -->

共通ルール

全スキル共通。正本はscripts/contract.mdで、scripts/gen-contract.shが各SKILL.mdのこの区間に書き込む（手で編集しない）。

• 各スキルを起動したら、そのスキルの作業を始める直前に1行だけ🌲 <スキル名>（日本語名）：<今回の目的>と伝える。複数スキルを1行にまとめず、まだ始めないスキルを予告しない。同じスキル内の局所作業では繰り返さない
• 調査、相談、設計、レビューだけの依頼では対象を変更しない。修正、追加、削除、実行、PR提出が依頼に含まれる場合だけ、必要なスキルをつないで明示された終点まで進む
• スキルを固定順に通さず、依頼された成果に必要な観点だけを使う。明示済みの終点へ向かう途中で、形式的な承認を追加しない
• 検証はリスクに比例させ、未検証の状態を成功や完了と書かない
• 人へ渡す日本語は結果か判断を先に置き、簡潔で分かりやすく書く。文章の表現や構成自体が成果ならhoukokuを使う
• 停止するときに意味のある次の進め方があれば、最大3件を推奨順にA（あ）、B（い）、C（う）で示し、英字とひらがなのどちらの回答も同じ選択として扱う

<!-- hikizan:contract:end -->

使い分け

• 新規：素材からREADME、技術文書、説明、記事、Slack、報告、リリースノート、引き継ぎを書く
• 推敲：既存文の意味と事実を保ち、短縮、自然さ、論証、読みやすさ、緩急を直す

文章のプロファイル

• 標準：会話、Slack、README、技術文書、説明、報告、リリースノート。references/writing-style.mdを使う
• 読み物：記事、章、順に読ませる長文、平坦さや緩急を直す依頼。標準規範の後にreferences/cognitive-rhythm.mdも使う
• HTML：調査結果や説明をHTMLで求められた場合。結論、理由、詳細を追いやすい順に置き、情報の階層と関係が視覚的に分かる静的な単一ページへまとめる。タイポグラフィ、余白、配色、グリッドなどのCSS表現は使い、JavaScript、アニメーション、外部依存、画像生成、ブラウザー検証は要求された場合だけ行う

形式の長さだけで読み物にしない。読者に順に読み進めてもらう目的か、緩急を直す明示依頼がある場合だけ選ぶ。HTMLでは見た目を削るのではなく、動作実装、外部依存、追加の検証工程を省いて素早く仕上げる。サイトやUIのデザイン自体が成果の場合はHTMLプロファイルを使わない。

手順

1. 読み手、目的、形式、素材を確認する。一意なら質問しない
2. 新規か推敲か、標準か読み物かを選ぶ。必要な参照資料だけを読む
3. 差分、検証出力、PR・リリース状態、利用者の原文などから、書いてよい事実と判断を集める
4. 新規では読み手が判断に使う内容を先に置く。読み物では第一段落で対象と論点を特定したうえで、資料にある問いや違和感から始めてよい
5. 推敲では原文の事実、主張、不確実性、語り手の判断状態を保ち、規範に外れた箇所だけを直す
6. 会話やSlackは短い口語、リリースや一覧は必要な見出しと箇条書き、長文は段落間の論理と認知リズムを使う
7. 書き上げた文章を、選んだ参照資料の点検手順で確認する。事実、見込み、未確認を区別し、実在しない出来事や感情で演出しない

次の進め方

完成稿を返して停止する場合は、次の候補から意味のあるものだけを選ぶ。

• 同じ目的のまま推敲する
• 読み手、調子、形式を変えて書き直す
• 完成稿として終了

禁止事項

• 下書き、未プッシュ、未公開などの外部状態を、文章だけを根拠に完了扱いする
• 実行していない検証、確認していない効果、素材にない事実を書く
• 推敲で原文の主張、事実、不確実性を変える
• 緩急のために実在しない出来事、感情、判断状態を作る

関連資料

• writing-style.md：人へ渡す日本語全般の基本規範
• cognitive-rhythm.md：記事、章、長文、緩急の推敲でだけ追加する規範