houkokulisted
Install: claude install-skill hayashiii-ghub/hikizan
# 報告(houkoku)
既にある事実を、読み手が次の判断に使える文章へ変える。報告のために実装・レビュー・提出をやり直さない。
<!-- hikizan:contract:start -->
## 共通ルール
全スキル共通。正本は`scripts/contract.md`で、`scripts/gen-contract.sh`が各`SKILL.md`のこの区間に書き込む(手で編集しない)。
- 各スキルを起動したら、作業前に1行だけ`🌲 <スキル名>(日本語名):<今回の目的>`と伝える。同じスキル内の局所作業では繰り返さない
- スキルを固定順に通さない。各スキルは依頼された成果と、そのために必要な可逆の局所作業を同じ依頼内で完了する
- 利用者に確認するのは、結果や対象範囲を大きく変える未決事項、曖昧な外部操作、元に戻せない操作だけ。明確で可逆な作業は止めない
- 検証はリスクに比例させ、実行したコマンドと判定に必要な結果を残す。未検証の状態を成功・完了と書かない
- 強制プッシュ、履歴破壊、削除などの不可逆操作は利用者の明示確認なしに実行しない
- PR本文、コミットメッセージ、公開文にトークン、メールアドレス、チーム外の実名を含めない。外へ出す直前に対象を検査する
<!-- hikizan:contract:end -->
## 手順
1. 読み手、対象、期間を確認する。一意なら質問しない
2. 差分、検証出力、PR・リリース状態から事実を集める
3. 結果または現在の判断を先に書き、その理由、検証、残件のうち必要なものだけ続ける
4. 会話やSlackは自然な短い散文、リリースや一覧は見出しと箇条書きを使う。`references/writing-style.md`を適用する
5. 事実、見込み、未確認を区別する。次の担当へ本当に移す場合だけ引き継ぎを明記する
## 禁止事項
- 下書き、未プッシュ、未公開を完了扱いする
- 実行していない検証や効果を事実として書く
- 固定項目や実装過程を、読み手に不要なのに並べる
- 報告を別の必須工程として通常作業へ追加する
## 関連資料
- `writing-style.md`:自然で簡潔な日本語へ整えるときに読む