Init
Skill kompiro/hane/skills/init
Reusable Claude Code skills for branch/worktree-based PR workflow, design docs, acceptance tests, and doc maintenance.
npx -y skills add kompiro/hane --skill initAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Scaffold the host-repo conventions the hane skills expect — doc directories, document templates, a process.md skeleton, and optionally status labels and a rules directory. Trigger when the user says: "hane init", "init", "初期設定", "セットアップ", "scaffold", "hane を導入", "ディレクトリ構造をセットアップ", "set up hane", or similar phrases requesting host-repo setup for the hane skills.
SKILL.md
7.0 KB, as published. Nobody here has run it
Host Repo Init Skill
hane の各 skill（start-dev / design-doc / acceptance-test / test-perspective /
qa など）は、host repo が一定のディレクトリ・ドキュメント慣習を採用していることを
前提に動く。このスキルは、その初期セットアップを対話で行う。
このスキルの価値は「固定のファイルを置くこと」ではなく、repo ごとに異なる選択を 対話で決め、hane が前提とする慣習の単一の出所になることにある。選択肢を持たず 固定構造を吐くだけならテンプレート repo やシェルスクリプトで足りる。
手順
1. 前提確認
- カレントが git repo であることを確認する（でなければ
git initを提案する）。 .gitignoreに.claude/worktrees/が含まれているか確認する。無ければ追記を 提案する（start-dev/ship/design-docがここに worktree を作るため）。
2. 既存状態のスキャン
docs/{design,adr,acceptance,test-perspectives}/、docs/process.md、.claude/rules/、
status: * ラベルの有無を調べる。このスキルは冪等で、既に存在するものは
上書きせず skip する。スキャン結果を踏まえて次の質問を出す。
3. 4 つの選択をユーザーに確認
以下を対話で確認する（既に存在するものは「採用済み」として扱い、質問から除いてよい）。
- 採用するドキュメントディレクトリ —
docs/design/（Design Doc）/docs/adr/（ADR）/docs/acceptance/（受け入れテスト）/docs/test-perspectives/（TPL）のうちどれを採用するか。複数選択可。 - ADR のファイル名規約 — GitHub 番号ベース（
<番号>-slug.md、hane の既定。 ADR-8 参照）か、日付ベース（YYYYMMDD-NN-slug.md）か。docs/adr/を採用する場合のみ訊く。 status: *ラベル運用 —start-dev/shipが Issue の進捗をstatus: ready / blocked / on-hold / implementing / designing / designed / in-reviewラベルで追跡する運用を採用するか。.claude/rules/ディレクトリ — repo 固有の authoring ルール（ADR の言語など） を置くディレクトリを作るか。
4. scaffold する
回答に基づき、以下を生成する。既存ファイルは上書きしない（skip して記録する）。
| 選択 | 生成物 |
|---|---|
docs/design/ を採用 | docs/design/TEMPLATE.md |
docs/adr/ を採用 | docs/adr/TEMPLATE.md |
docs/acceptance/ を採用 | docs/acceptance/TEMPLATE.md |
docs/test-perspectives/ を採用 | docs/test-perspectives/TEMPLATE.md |
| いずれかの doc ディレクトリを採用 | docs/process.md（スケルトン。下記参照） |
.claude/rules/ を採用 | .claude/rules/.gitkeep |
| ラベル運用を採用 | status: * ラベル 6 種を gh label create で作成 |
テンプレートアセットのコピー元
各 TEMPLATE.md は hane plugin 内の skill アセットをコピーする（複製・再生成
しない）。コピー元はこの init skill のディレクトリからの相対パス:
| 生成物 | コピー元 |
|---|---|
docs/design/TEMPLATE.md | ../design-doc/TEMPLATE.md |
docs/adr/TEMPLATE.md | ../design-doc/ADR-TEMPLATE.md |
docs/acceptance/TEMPLATE.md | ../acceptance-test/TEMPLATE.md |
docs/test-perspectives/TEMPLATE.md | ../test-perspective/TEMPLATE.md |
コピー後、内容は変更しない。各テンプレート冒頭の HTML コメントに規約（ファイル名・ 言語・番号規約）が書かれているので、host repo 側で追加の説明は不要。
status: * ラベルの作成
ラベル運用を採用する場合、以下を gh label create "<name>" --color <hex> --description "<desc>"
で作成する（既存ラベルは skip）:
| ラベル | 用途 |
|---|---|
status: ready | 着手可能 |
status: blocked | 依存待ちで着手不可（別 Issue の close で自動解消） |
status: on-hold | 保留（塩漬け）— コンセプト再検討など、意図的に着手を止めている（人間が明示的に外すまで継続） |
status: designing | Design Doc 作成中 |
status: designed | 設計承認済み・実装着手可能 |
status: implementing | 実装中 |
status: in-review | レビュー中 |
色は任意（例: ready=緑、blocked=赤、on-hold=グレー、それ以外=黄系）。
docs/process.md スケルトン
選択した内容を反映した最小限の docs/process.md を生成する。含める節:
- ドキュメントのライフサイクル — アイデア（Issue）→ 設計（
docs/design/、採用時のみ） → 決定（docs/adr/、採用時のみ）の流れ。 - ブランチ・worktree ルール —
mainへの直 push 禁止、worktree は.claude/worktrees/<branch-name>、ブランチ命名（feat/fix/docs/chore/refactor/+ kebab-case）。 - 採番規約 — 選んだ ADR ファイル名規約。AT / TPL も同じ番号ベース。
- ラベル運用 — 採用した場合のみ、
status: *の遷移を記す。 - 各ドキュメント種別を採用した場合は、対応する
/hane:skill（design-doc/acceptance-test/test-perspective）で記録を作る旨を 1 行ずつ書く。
process.md は host repo がその後育てる前提のスケルトン。冒頭にその旨を明記する。
5. 結果のレポート
生成したファイル・ラベルと、既存のため skip したものを一覧で報告する。
6. 完了後の案内
次のステップを短く示す:
- host repo の
CLAUDE.mdに hane の利用を 1 節追記する（このスキルはCLAUDE.mdの内容には踏み込まない — repo 固有のため）。 /hane:start-devで最初の開発を始められる。
冪等性
このスキルは何度実行しても安全であること。2 回目以降の実行では、既に存在する ファイル・ディレクトリ・ラベルはすべて skip し、不足分だけを補う。実行のたびに created / skipped の内訳をレポートする。
スコープ外
- host repo の
CLAUDE.mdの生成・編集（repo 固有すぎる。利用者に追記を促すのみ）。 - 既に独自の慣習で運用している repo の移行・整合（このスキルは不足を埋めるだけで、 既存の構造を作り変えない）。