claude-org-ja: Skill for Claude Code

goal-setup: ゴール台帳を対話で書く

/work-discovery は、オペレーターが書いたゴール台帳の条項に当たる Issue だけを条項順に提案する。 台帳の無いプロジェクトからは候補が出ず、書式が崩れた台帳も候補ゼロになる。本スキルは、その台帳を人間との対話で作る・直す。

• 書式の正本: registry/goals/README.md（例: registry/goals/example.md）
• 設計: docs/design/work-discovery-triage.md §12.3
• 書式検証: tools/work_discovery_goals.py validate（scan と同じパーサで読む。ここを通らない台帳は保存しない）

起動主体は窓口。台帳はオペレーターのローカルファイル（git 管理外）なので、commit・PR はしない。 ゴールの中身は人間が決める。窓口は候補を推定して示すが、条項の採否・文言・順番はすべて人間の答えで確定させる。

Step 1 — 対象リポジトリを決める

引数（$ARGUMENTS）の通称を GitHub の owner/repo に解決する。owner/repo 形式ならそのまま使う。

python3 tools/work_discovery_repos.py --format json

included[] の nickname と引数を照らして repo を取る。

• 引数が無い、または一致が無い・複数あるときは、included[] の通称一覧を示して聞き返す。
• opted_out[]（triage 列で除外）にある通称なら、台帳を書いても候補は出ないことを伝え、先に registry/projects.md の triage 列を戻すかを聞く。
• skipped[]（パスが GitHub URL でない等。reason 付き）にある通称なら理由を伝え、owner/repo を直接教えてもらう。
• 台帳のパスは registry/goals/<owner>/<repo>.md（小文字）。

Step 2 — 既存台帳を確認する

python3 tools/work_discovery_goals.py validate --repo <owner>/<repo>

出力は 1 行の JSON（status が ok なら exit 0、それ以外は exit 1）。

• unset → 新規作成モード。
• ok → 改訂モード。台帳ファイルを Read し、今の条項（G1 から順に見出しと unmet if）を人間に見せて、何を変えたいか（追加・削除・順番・文言）を聞く。
• error → 修復モード。error の内容（例: G2: no 'unmet if:' line）をそのまま伝え、台帳を Read して直し方を提案する。case mismatch はファイル名を小文字に直す話なので、その旨を伝える。

Step 3 — ゴール候補を推定して提示する

新規作成モードと、改訂で条項を足すときに行う。材料は 2 つだけ（読み取りのみ）:

gh repo view <owner>/<repo>
gh issue list --repo <owner>/<repo> --state open --limit 100 --json number,title,labels

README の目的と、open Issue のまとまり（同じ困りごとを指す Issue 群）から、ゴール候補を 3〜5 個に絞って示す。 各候補は「目指す状態 1 行 + 根拠になった Issue 番号 2〜3 個」。 Issue をそのまま条項にしない。条項は「状態」であり、Issue はその未達を解消する仕事である。

Step 4 — 質問して条項を固める

候補を叩き台に、1 条項ずつ短く聞く（まとめて 5 問を並べない）:

1. 何を目指すか: 見出しになる 1 行（例「利用者がセットアップで詰まらない」）。
2. 何が起きていたら未達か: unmet if を 1 行以上。Issue が 1 件出れば当たるくらい具体的に（例「README の手順どおりに進めて失敗する報告が open のまま残っている」）。「品質が低い」のような判定できない文は、どんな報告・状態を指すかを聞き返して具体化する。
3. 順番: 全条項が出そろったら並びを見せ、「上にある条項ほど優先して提案されます。この順で合っていますか」と確認する。