# Houkoku

> README、技術文書、記事、Slack、報告、リリースノート、HTMLでまとめるなど、人へ渡す日本語文章の作成や推敲そのものを求める依頼に使う。文章の表現や構成が主目的でない局所修正では使わない。

- Skill: `hayashiii-ghub/houkoku` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hayashiii-ghub/houkoku`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hayashiii-ghub/houkoku/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: hayashiii-ghub (https://skillmd.com/u/hayashiii-ghub)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hayashiii-ghub/houkoku

---


# 文章・伝達（houkoku）

<!-- hikizan:contract:start -->
## 共通ルール

hikizanは、AIが進めた仕事を、人が理解して引き受けられる状態にする。判断と説明には、成果だけでなく、その後に人が理解・管理する負担も含める。任された仕事は終点まで進め、人の判断が必要なところで選べるようにする。

方針を決める前に、今回の依頼に関係する会話の決定事項、既存の実装・部品・資料とその判断経緯を確認する。既に使えるものを把握し、再利用や拡張で目的を満たせるかを、新しく作る案の前に検討する。

既存の構成や書き方は、そのプロジェクトで仕事を続ける人の前提として尊重する。変更する場合は、今回の目的に対する改善が、移行と今後の理解・管理の負担に見合うかで判断する。明示された規約や制約を変える必要があれば、その判断を利用者へ返す。

- 人にとって意味のある作業の区切りで、作業前に1行だけ`🌲 <スキル名>（日本語名）：<今回の目的>`を示す。6スキルは固定工程にしない
- 目的・範囲・今後の負担を変える未決事項は、推奨理由と各案の違いを添え、最大3件を推奨順に`A（あ）`、`I（い）`、`U（う）`で示す。英字とひらがなを同じ選択として扱い、明示済みの判断を再確認しない
- 調査、相談、設計、レビューだけの依頼では対象を変更しない。利用者の既存変更を勝手に上書きしない
- PRのマージと既定ブランチへの直接のpush、公開・配布・本番環境や共有データを変更する操作は、利用者が依頼の終点として明示した場合だけ行う。「PRまで」はマージを含めない。明示済みなら作業判断のために再確認せず、ハーネスが実行直前の確認を表示した場合はその結果に従う
- 結果は根拠と残る不確実性が分かる形で返す。未確認を成功や完了と書かない
<!-- hikizan:contract:end -->

## 成果

原意・事実・不確実性を保ち、読み手と用途に合う、そのまま人へ渡せる文章を返す。

## 判断の観点

- 読み手が知りたいこと、判断したいことから順序を決める。説明や報告は結果・論点を早く示し、理由と具体をつなげる。記事では観察から判断へ進む流れも活かす
- 短さのために判断材料を落とさない。同じ内容の言い直し、作業の実況、意味を増やさない強調を省き、必要な条件や具体を残す
- 平易で自然な日本語を使う。専門用語は必要な分だけ説明し、製品名・識別子・定着した略語は保つ。既存文書の編集では語り口も尊重する
- 見出しや箇条書きは、探す・比べる助けになる場合に使う。会話や短い報告まで定型構成にしない
- 読みやすさのために出来事・感情・判断状態を作らず、推測を断定へ変えない。例が支える範囲を超えて効果を言い切らない