跳到正文
cccskills
免费在 GitHub 公开

goal-setup

プロジェクトのゴール台帳(registry/goals/<owner>/<repo>.md)を人間と対話して新規作成・改訂する。

README と open Issue からゴール候補を推定して提示し、「何を目指すか」「何が起きていたら未達か」を 短く質問して条項を固め、書式検証(tools/work_discovery_goals.py validate)を通してから保存する。

「ゴール台帳を書きたい」「ゴールを設定して」「ゴール未設定と出た」「台帳エラーを直して」 「このプロジェクトの目標を決めたい」等や、/work-discovery の「ゴール未設定」「ゴール台帳エラー」案内を 受けて窓口が起動する。候補の提示そのものは /work-discovery の役目で本スキルではない。

中文简介正在准备中。当前显示原文说明。

集成工具GitHub
查看安装方法

包含的文件(1)

  • SKILL.md7.3 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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

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

起動主体は窓口。台帳はオペレーターのローカルファイル(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. 順番: 全条項が出そろったら並びを見せ、「上にある条項ほど優先して提案されます。この順で合っていますか」と確認する。

条項の本文(見出しと unmet if の間の説明)は任意。人間が話した補足があれば 1〜2 行で残す。

Step 5 — 下書き → 書式検証 → 人間の確認 → 保存

  1. README の書式どおりに下書きを作る: ## G<番号> <見出し> を 1 から欠番なしの連番で並べ、各条項に - unmet if: … を 1 行以上。下書きは $TMPDIR/goal-setup-<owner>-<repo>.md に書く。
  2. 書式検証を必ず通す:
    python3 tools/work_discovery_goals.py validate --file "$TMPDIR/goal-setup-<owner>-<repo>.md"
    
    exit 1 なら error を読んで下書きを直し、通るまで繰り返す。通らない台帳は保存しない。
  3. 下書き全文(改訂モードなら変更前との差分も)を人間に見せ、次の点を明示して保存してよいか聞く:
    • この台帳を置くと、その repo の候補 Issue のタイトル・要約・本文冒頭・ラベルとゴール条項が、提案の判定のため claude -p 経由で api.anthropic.com に送られる。台帳を置くことがその送信への同意になる(registry/goals/README.md「運用前提と送られるデータ」)。
  4. 明示の OK が出たら registry/goals/<owner>/<repo>.md に保存し(ディレクトリが無ければ作る)、保存先で再検証する:
    python3 tools/work_discovery_goals.py validate --repo <owner>/<repo>
    
    status が ok であることを確認して終える。「次の仕事候補を出すなら /work-discovery」と 1 行添える(自分では起動しない)。

やらないこと

  • 人間の答えを待たずに条項を確定・保存しない。推定した候補はあくまで叩き台。
  • 台帳を commit しない・公開リポジトリに入れない(registry/goals/ の台帳は .gitignore 済み)。
  • Issue や repo に書き込まない(gh は repo view / issue list の読み取りだけ)。
  • 候補の提案(triage)や委譲を始めない。それは /work-discovery → /org-delegate の役目。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

ディスパッチャーのコンテキストを圧迫したまま session を続けるのを避けるため、 monitoring 状態(active workers / 直近 polling cursor / pending escalations)を handover ファイルに書き出し、secretary の指示で /clear → /dispatcher-resume の 流れで新しいディスパッチャー session を開始する準備をする。 Secretary から DISPATCHER_HANDOVER peer message を受領したとき、または ディスパッチャー自身が context が長くなったと判断したときに使う。 context-handover watcher が `/dispatcher-handover auto op=<OP>` を打鍵したときも使う。

中文简介正在准备中。当前显示原文说明。

suisya-systems/claude-org-ja52026年10月19日 更新

/dispatcher-handover で書き出した handover ファイルを読み込み、 ディスパッチャーを新しい session で復帰させる。/clear 直後の最初のターンで使う。 state.db の dispatcher_pane_id / dispatcher_peer_id を atomic に更新し、 worker monitoring の /loop 3m を再開する。 secretary が /clear の後にディスパッチャーペインへ /dispatcher-resume を打鍵したときに使う。 context-handover watcher が `/dispatcher-resume auto op=<OP>` を打鍵したときも使う。 /org-start ではない(ワーカー・窓口は生きている前提。キュレーターは常駐しない)。

中文简介正在准备中。当前显示原文说明。

suisya-systems/claude-org-ja52026年10月19日 更新

組織の生きているペイン(secretary / dispatcher / worker)へ tmux で**直接入る** ための **コマンドを出力するだけ** の read-only スキル。`mcp__org-broker__list_panes`(論理ペイン) と `/usr/bin/tmux -L claude-org-broker list-panes -a`(pane_id ↔ session マッピング)を pane_id(%N)で突き合わせ、各ペインに role + name(task_id) ラベル付きの attach コマンドを 生成する(既定は読取書込 = `-r` 無し / 読取専用 `-r` はオプション / デタッチは `Ctrl-b d`)。 外側が tmux のときに今の tmux を分割してワーカー(と dispatcher)を並べる `split-window` コマンドも出す。 特定のペインの画面を直接見たい・入りたい・並べて見たい、attach コマンドを知りたいという依頼で発動。 自分で attach / split はせず・ペインも一切変更しない(コマンド文字列とペイン一覧表を表示するのみ)。 作業委譲(org-delegate)・ダッシュボードで状況一覧(org-dashboard)・watcher 停止(org-attention-stop) には発動しない。

中文简介正在准备中。当前显示原文说明。

suisya-systems/claude-org-ja52026年10月19日 更新

attention notification watcher(承認待ち / 判断待ち / CI 失敗等を OS 通知 + 音で能動通知)を dispatcher ペインの右側に split で常駐起動する。`.state/attention.json` が未配置なら ja 既定テンプレートを `tools/templates/attention.example.json` から自動コピーする。 起動後のペイン id は `.state/attention_pane.json` に記録し、`/org-attention-stop` から参照する。 「attention 起動」「通知監視を始めて」「watcher を立てて」等で発動。 `/org-start` からの auto-start はしない(明示起動推奨ポリシー)。

中文简介正在准备中。当前显示原文说明。

suisya-systems/claude-org-ja52026年10月19日 更新

`/org-attention-start` で起動した attention watcher ペインを停止する。 `.state/attention_pane.json` に記録された pane_id を `list_panes` の name/role で identity 確認し、いまも attention watcher を指している場合だけ `close_pane`(pane 破棄)で 破棄する(pane_id が別ペインへ再割当て済みなら close せず stale sidecar として削除)。 「attention 止めて」「通知監視を停止」「watcher 落として」等で発動。

中文简介正在准备中。当前显示原文说明。

suisya-systems/claude-org-ja52026年10月19日 更新

人間が承認したスコープの内側で triage → worker 派遣 → verify → push → PR 作成 → CI 監視 を完了駆動で自走し、PR ごとに merge gate で停止する窓口用のベルトコンベア。 「この範囲は自走してよい」「triage 上位の S 級バグを空き pane 分まで流して」等、 人間がスコープ承認を明示して複数候補を順に流したいときに窓口が起動する。

中文简介正在准备中。当前显示原文说明。

suisya-systems/claude-org-ja52026年10月19日 更新

查看 suisya-systems 的全部技能

报告此技能的问题