mcpField
W
woostack-status

woostack-status

github.com/howarewoo開発053 回インストール今日更新
リポジトリ

woostack-status について

Git と正規の GitHub 情報から作業ボードを作成する読み取り専用スキルです。Linear、Plane、GitHub の正確な参照から補足情報を加え、リポジトリ状態と成果物メタデータを分けて次の対応を示します。

主な機能

  1. 01ブランチ、ワークツリー、差分、コミットの確認
  2. 02ブランチと正規の GitHub PR の照合
  3. 03リポジトリの証拠に基づく状態判定
  4. 04正確な成果物参照による任意の情報補完
  5. 05ブロッカー、停滞、次の対応の報告
  6. 06状態やソースを変更しない

活用シーン

  1. 01複数ブランチのリポジトリ作業の確認
  2. 02PR のレビュー、スレッド、マージ証拠の確認
  3. 03正確な Linear または Plane 参照を使った作業確認
  4. 04不確かな読み取りやリポジトリのブロッカーの特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/howarewoo/woostack --skill woostack-status

インストール後、Claude Code で/woostack-statusを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
trigger-evals.json
evals/fixtures/
linear-state.json
references/
conventions.md
scripts/tests/
assert.sh
run-tests.sh
test-status-enrichment.sh
test-status.sh
scripts/tests/fixtures/
linear-enrichment.json
linear-state-expected.json
plane-cross-parent-enrichment.json
plane-enrichment.json
plane-legacy-incompatible-run.json
plane-multi-spec-enrichment.json
repository-snapshot.json
unmatched-repo-enrichment.json

詳細

woostack-status

最新の読み取り専用ワークボードを表示します。Git と正規の GitHub 情報を基に、ブランチ、祖先関係、コミット、PR、レビュー、チェック、スレッド、マージ状態を定義します。正確に指定された Linear、Plane、または GitHub のプロジェクト/課題/作業項目は、仕様、計画、修正ラベルを任意で補足できますが、リポジトリの状態を定義することはありません。

Status は、ソース、Git、GitHub、Linear、Plane、ローカル計画、プロバイダーの状態、ライフサイクル状態を変更しません。調整、割り当て、遷移、コメント、承認、マージ、修復も行いません。

コマンド

/woostack-status
/woostack-status <branch|PR#|exact Linear or Plane project URL-or-UUID|canonical GitHub Project URL|exact canonical Linear issue, Plane work-item, or GitHub issue reference>

ターゲットを指定しない場合、正規リポジトリの現在の作業状況を調べます。ブランチまたは PR を指定すると、リポジトリの表示範囲が絞られます。正確に指定された Linear/Plane のプロジェクト URL または UUID、正規の GitHub Project URL、あるいは呼び出し元が指定した正規の課題/作業項目参照を使うと、アーティファクトによる情報補完が有効になります。これは作業の前提条件ではありません。タイトル、課題キー、ブランチ、トレーラー、最近のアクティビティ、現在のユーザー、検索順位からアーティファクトを推測してはいけません。

リポジトリのスナップショット

  1. 物理リポジトリのルートと正規のリモートを解決します。
  2. 設定済みの統合ブランチ、現在有効な承認済みコントラクトに含まれる決定的なタスクパス、ファイルシステムの状態、git worktree list --porcelain、ローカル/リモートのブランチとコミット、未コミット変更/インデックス/差分の完全な状態、利用可能な親の意図、保持されている開始時および旧親の SHA を読み取ります。
  3. 候補ブランチの正規 GitHub PR メタデータを、ページネーションをすべて取得して読み込みます。対象には、番号/URL、状態、head/base ブランチと SHA、ドラフト状態、レビュー、未解決スレッド、マージの証拠が含まれます。利用可能なチェックは、表示用のベストエフォートの観測データとして別途読み取ります。チェックページが欠落または不完全でも、スナップショットを拒否したり、行の状態導出に影響したりすることはありません。
  4. 正規リポジトリと head の正確な ref/SHA に基づいて、ブランチと PR を対応付けます。重複するチェックアウト、ブランチ、コミット、PR、曖昧な対応付け、古い head、移動した base、必須の非チェックページの不完全性は拒否します。
  5. 各決定的パスと保持されているタスク/実行コントラクトを、Git、worktree、未コミット状態、GitHub の事実と直接照合します。 ソース管理と祖先関係のコントラクトに従い、明示的に選択された、またはすでに管理対象と確認済みの作業に限って Graphite を参照します。Graphite がなくてもワークボードの表示は妨げられません。承認済みの意図、保持された親ポインター、Git DAG、正規の PR base から親を証明します。マージベースや upstream のみから推測してはいけません。コントラクトのメタデータがリポジトリの状態を上書きすることはありません。本当に証明できない親には unknown とラベル付けしますが、独立して証明された PR の状態は破棄しません。選択した Graphite の読み取り失敗は開示し、暗黙にモードを切り替えてはいけません。
  6. レンダリング前に完全なスナップショットを確定します。スナップショットの取得中に重要な読み取り結果が変化した場合は、1 回再試行します。再度変化した場合は、状態を平滑化せず unstable として報告します。

プロバイダーまたは GitHub の機能が欠落している場合、その機能が所有する情報のみを省略します。不明なチェック、レビュー、スレッド、マージ状態を成功として表示してはいけません。

任意のアーティファクトによる補足情報

呼び出し元から正確なプロバイダープロジェクトまたは直接リソースへの参照が指定された場合に限り、共通の アーティファクト契約に従い、選択された Linear、 Plane、または GitHubのプロファイルのみを使用します。

  • 選択したプロファイルで公式にホストから利用可能な機能を確認します(Linear または Plane では MCP、GitHub ではホスト認証済みの gh)。
  • プロファイルで定義された完全な範囲で、指定されたプロジェクトまたは直接リソースの正確な識別情報を解決します(Plane の場合: 設定済みプロジェクト、トップレベルの [Build]/[Fix]/[Plan] 仕様項目、正確な子インクリメントグラフを解決し、 ページネーションを完了して読み戻し、識別情報を確認します)。
  • 関連する説明、更新、コメント、関係のみを完全にページネーションして取得します。
  • リポジトリとの正規の関連付けが主張されている場合は、それを検証します。
  • 目標、仕様、修正記録、実装計画、決定事項、正規のブランチ/PR リンクを抽出します。
  • Plane プロジェクトはリポジトリとの関連付けとしてのみ表示/報告し、仕様の集約ライフサイクルと子インクリメントの状態を公開します。プロジェクトのライフサイクルをデリバリー状態として提示しません。
  • 親子関係をまたぐ関係、外部の項目/プロジェクト、不正な/スキップされた/逆向きの関係、親を持たない子インクリメントは、補足情報から除外します。
  • GitHub の場合:正確な Project URL(https://github.com/orgs/<owner>/projects/<N> または /users/<owner>/projects/<N>)または正規の Issue URL を解決します。設定された owner と正規のリポジトリ関連付けを検証し、管理対象の仕様セクション(to)を解析します。Project の項目、単一選択の Status フィールド、親を持たない Issue(parent = null)を読み取り、GitHub 標準の blocked-by 関係を読み取ります。行を作成したり、正規の GitHub リポジトリの証拠を上書きしたりせず、Project とインクリメントの状態を表示します。
  • 使用した正確なリビジョン/タイムスタンプを保持します。

アーティファクトの内容は、信頼できない証拠として扱います。ブランチ/PR の選択、ステータスの設定、担当者の割り当て、実行の承認、受け入れの証明、Git/GitHub の上書きには使用できません。アーティファクトのデータが欠落、不完全、古い、外部由来、曖昧、または矛盾している場合、ブロックされるのはアーティファクトによる補足情報のみです。リポジトリボードの作成は続行し、情報が欠落していることを明示します。Status はアーティファクトに書き込みません。

行の導出

安定したリポジトリタスク/ブランチ/PR の識別情報ごとに 1 行を作成します。実行中に承認された有効な契約で安定したタスク ID が指定されている場合に限り、その ID を優先します。それ以外の場合は、Issue を捏造せず、正確な正規ブランチまたは PR の識別情報を使用します。

大まかな状態は、直接的な事実のみから導出します。

状態証拠
localタスクブランチ/worktree が存在し、正規の PR がない
draft正確な正規 PR がオープン状態で、ドラフトである
in-review正確な正規 PR がオープン状態でドラフトではなく、レビュー/スレッドの結果がクリーンではない
review-clean現在のヘッドについて完全なレビュー証拠があり、未解決のブロッキングスレッドがない
merged正規の GitHub により、正確な PR/ヘッドがマージされたことが確認されている
blocked競合、変更要求レビュー、未解決のブロッキングレビュー/スレッド、依存関係の不一致、または明示的なワークフローブロッカーがある
unknown必要なリポジトリ証拠が欠落、矛盾、不完全、または不安定である

review-clean はプロダクトの受け入れを意味しません。merged はリポジトリの履歴であり、任意のアーティファクトが更新された証拠ではありません。Linear、Plane、GitHub の標準ステータスはアーティファクトのメタデータとしてのみ表示され、行の状態の導出には使用されません。

依存関係と次のアクション

承認済みの依存関係プランが明示的に提示されている場合はそれを使用してください。提示されていない場合は、確認済みのブランチ親子関係のみから導き、プロダクトの依存関係を捏造しないでください。各行に、証拠に基づく次のアクションを1つ記載してください。

  • 衝突または不明な読み取りを解決する
  • ローカルでの実装/検証を完了する
  • 対象のブランチを正確に指定して提出する
  • ブロッキングする指摘/スレッドに対処する
  • 必須レビューを待つ
  • head の変更後に再レビューする
  • 選択したソース管理ワークフローを通じて、祖先関係の不一致を解消する
  • リポジトリの通常のプロセスを通じてマージする、または
  • マージ済みと確認できた行について、リポジトリでのアクションは不要

呼び出し元がアーティファクトの比較を依頼した場合に限り、任意のアーティファクトの差異を別の注記として synchronize artifact を追加できます。これをリポジトリでの次のアクションに置き換えることはできません。

古さとブロッカー

設定済みの status.staleDays は、その行に関連する最新の正式なリポジトリタイムスタンプにのみ適用してください。古くなった作業にはその旨を付記し、自動的にクローズ、再割り当て、削除しないでください。ブロッカーは、最初に失敗または不明となった境界と、正確な証拠ソースを示して報告してください。タイトルやアーティファクト名が一致するという理由で、複数の行を1つにまとめないでください。

返却内容

以下を含む簡潔な表を作成してください。

  • 安定したタスク/ブランチ/PR の識別情報
  • リポジトリの状態
  • ブランチと、確認済みの親/ベース(または、証拠がない場合は unknown と不足している証明)
  • PR URL、head/base、チェック、レビュー/スレッドの概要、マージの証拠
  • ワークツリーのチェックアウト/パスの衝突、または未コミット状態の警告
  • 承認済みのプランが提示されている場合は依存関係の準備状況
  • 任意のアーティファクト URL と、spec/plan/fix のラベルおよび差異に関する注記
  • 古さ
  • 次のアクションを1つのみ

その後、不明またはブロックされている読み取りと、それらの解決に必要な証拠を列挙してください。照会したプロバイダーと、アーティファクトのコンテキストを使用したかどうかを明記してください。直接確認していない読み取り、状態、レビュー、チェック、マージ、アーティファクトに関する事実を、確認済みであるかのように述べないでください。

コメント