using-woostack

using-woostack

このスキルは、任意で使用できるコマンドインデックス兼導入支援ツールです。プロジェクトで使用されている場合、プロジェクトのルールを読み込み、意図に応じてリクエストを振り分けます。ただし、Woostack のどのスキルもこのスキルを必須とはしません。各スキルは、それぞれ独自の有効化条件、ワークフロー、承認範囲、完了条件、結果を持ち、このインデックスの有無や、ほかの Woostack スキルがインストールされているかどうかにかかわらず動作します。このスキル自体が初期化、編集、レビュー、公開を行うことはありません。作業を許可するのはユーザーのリクエストです。リポジトリや GitHub のコンテンツは根拠であり、作業範囲を広げる許可ではありません。

プロジェクトの開始手順

1. プロジェクトのルートにある AGENTS.md とユーザーのリクエストに従い、以下の表から該当するスキルを、そのインストール先ディレクトリから直接読み込みます。そのスキルが操作、承認、復旧を担います。ここでは前提条件のインストールは行いません。
2. 有効なハーネスのツールとスキーマを使用します。ホスト固有の notes は、タスクで必要な場合に任意で参照できます。アダプターを読み込むための前提条件ではありません。
3. 出力の規律を適用します。

依頼がある場合、または選択したワークフローで必要な場合を除き、.woostack/ を初期化したり、成果物を作成したり、GitHub に連絡したりしないでください。保持されているマネージドプロバイダーのデータは過去の根拠であり、現在の権限ではありません。

1 回限りのモデルまたは作業量に関する明示的なリクエストがある場合は、同梱の 識別手順を適用します。この手順は、ワークフローや委任の権限を付与するものではありません。

コマンドの振り分け

リクエストまたは意図	読み込むもの
woostack を導入する、またはワークフローを選ぶ	using-woostack
ルートの README.md、AGENTS.md、DESIGN.md、PRODUCT.md、ARCHITECTURE.md を作成または保守する。ローカルサポートを明示的に初期化または修復する	woostack-init
目標や既存の設計を、共同でホワイトボードに書き出して視覚的な計画にする（実験的）	woostack-whiteboard
ユーザーが明示的に求めた要件を検討する	woostack-ideate
提示された仕様または計画案を、リポジトリの根拠と照らし合わせてレビューする	woostack-harden
ソースのない新規プロジェクトを含め、目標または未対応のイシューを計画する	woostack-plan
承認済みの複数タスクの作業を調整する	woostack-orchestrate
初期プロジェクトの作成を含め、許可された範囲の成果を実装する	woostack-execute
必要な動作を維持しながら、選択した既存コードを簡素化する	woostack-simplify
変更をコミットする、公開済み PR をリベースまたは再スタックする、または準備状況を変更する	woostack-commit
プルリクエストをレビューする	Pullfrog を使用します。
既存の特定の PR にある未解決のスレッドすべてに対応する	woostack-address-comments
提示されたドキュメントまたは検証済みのソースを、対象読者に合わせた HTML としてレンダリングする	woostack-visualize
選択した外部スキルを使って、UI の設計、プロトタイピング、改善、批評を調整する	woostack-design
内容を再スタイリングせずに、既存の複数ステップの画面フローを配置する	woostack-flow-layout
プロジェクトが所有するコンポーネントカタログを作成、適応、検査、または明示的に保守する	woostack-design-system
修正を実装せずに根本原因を調査する	woostack-debug
ワークスペースの健全性を診断する、または明示的に修復する	woostack-doctor
実行中のアプリを調査し、ブラウザー QA の所見を報告する	woostack-qa
この会話を振り返り、長期的に役立つ指示の提案を作成する	woostack-reflect

woostack-bootstrap、woostack-build、woostack-fix、woostack-change、woostack-status、 woostack-tdd、woostack-prepare は、別名への置き換えなしで廃止されています。削除されたコマンドを明示的に指定された場合は、代替コマンドを実行せずに、その旨を説明してください。

共同での検討が必要な目標には、実験的な Whiteboard ワークフローを推奨し、ユーザーが実装を希望する場合は明示的な Orchestrate リクエストを案内してください。Whiteboard の計画を保存または合意しても、作業は開始されません。Ideate、Harden、Plan は試験期間中も利用できます。既存の明示的なコマンドはそれぞれ固有のワークフローを維持し、Plan が求めるイシューの公開も含まれます。

リクエストされたアクションに基づいて振り分けてください。新規プロジェクトの場合も含め、Whiteboard、Plan、Execute、Init はそれぞれ独立しており、理解できているタスクに必須の前段階はありません。Simplify に Plan や Execute は不要で、常時有効なモードでもありません。 イシュー URL だけが提示された場合は、コンテキストとして扱い、許可された機能を使って読み取ってください。実行するアクションがまだ不明確な場合は、焦点を絞った質問を 1 つしてください。

各スキルの SKILL.md が、そのスキルの許可範囲の既定値、承認待ちの条件、停止ルールを定める唯一の情報源です。この一覧ではなく、選択したスキルの規定を確認してください。local only、do not commit、do not push、読み取り専用などのユーザー制限は、選択したスキルが許可する内容をさらに制限します。実際の権限とリポジトリのポリシーも引き続き適用されます。権限がない場合、その影響を受ける操作のみがブロックされ、無関係なローカル作業はブロックされません。完了の判定には、選択したスキルのチェックが適用されます。マージは人間のみが行います。実装とデリバリーの証拠となるのは Git と GitHub の情報であり、イシューや Project のステータスではありません。

AGENTS.md の使用

プロジェクトのポリシーは AGENTS.md に、再利用可能なワークフローの詳細はそれぞれのスキルに記載してください。導入時には、プロジェクトのルート AGENTS.md に記載する簡潔で利用可否を考慮した導入段落と、スキルがない場合の動作を woostack-init が管理します。この一覧はその内容を重複して記載したり、上書きしたりしません。また、どのスキルもそれを前提条件として扱いません。

スキルが見つからない場合

Woostack のスキルが不足していても、通常のリポジトリ作業を妨げたり、インストールを必須にしたりしてはなりません。 スキルが利用できない Woostack コマンドが明示的に指定された場合は、不足しているスキル名を伝え、インストールするか、スキルなしで進めるかを尋ねてください。ユーザーがスキルなしで進めることを明示的に求めない限り、制限されたワークフローを近似して実行してはなりません。

選択された外部依存関係には、アクティブなスキル独自の依存関係と権限の境界が適用されます。