ワークスペースの設定
/refine-story、/qa-plan、/requirements-discovery、/meeting-minutesが前提とするワークスペースレベルの設定を記述します。これは自動スクリプトではなく、対話ガイド型のスキルです。調査、結果の提示、確認を行い、その後でファイルを書き込みます。
手順
-
調査する。 既存ファイルを確認してから仮定を立てます。ルートの
AGENTS.mdとCLAUDE.md、CONTEXT.md、docs/agents/refinement.mdとdocs/agents/issue-tracker.md（このスキルの以前の出力）、.scratch/、およびソースコードの存在を示すpackage.json、pyproject.toml、src/、go.mod、またはチームがコンパイル・実行するものを探します。docs/agents/issue-tracker.mdが別の規約ですでに存在する場合は、それを保持し、公開先が指定されていることだけを確認します。CLAUDE.mdが単に@AGENTS.mdを参照するブリッジである場合、プライマリ指示ファイルはAGENTS.mdです。 完了条件：ワークスペースがすでに設定されているかどうか、推定されるモード、推定される言語（en-USまたはpt-BR）、用語集の有無、トラッカーの有無、編集すべき指示ファイルがわかっていること。 -
セクションごとに質問する。推奨回答を先に提示すること。
モード。 調査結果に基づいて推奨します。コードが存在する場合は
com-codigo（コードあり）、存在しない場合はsem-codigo（コードなし）。一行で説明します。コードありの場合、エージェントは質問前にソースコードを調査します。コードなしの場合、POが事実の源泉となり、アーキテクチャに関する質問はチームへの質問票となります。言語。 既存ファイルまたはデフォルトの
en-USに基づいて推奨します。en-USまたはpt-BR。一行で説明します。調査、質疑応答、ナラティブ、Gherkin基準、判定の言語を定義します。作業項目。 ユーザーストーリーは外部トラッカーから発生していますか？ はいの場合、ベースURLとフィールド規約は何ですか（例：Azure DevOpsの作業項目に対して
Azure: <ID>）。すべてのUSはそこで発生し、各成果物はこのID行を持ちます。製品用語集。
CONTEXT.mdはすでに存在しますか？ 存在しない場合、今はアクション不要です。ドメイン用語を解決する最初の調査がこれを作成します。この点を明確に伝えます。完了条件：モード、言語、作業項目規約、ベースURLが確認されていること。
-
確認して書き込む。 refinement.mdに基づく
docs/agents/refinement.md、issue-tracker.mdに基づくdocs/agents/issue-tracker.md（存在しない場合のみ）、およびエージェント指示ファイル用の## Refinementブロックのドラフトを提示します。調整を許可します。その後、ファイルを書き込みます。指示ファイルについて：CLAUDE.mdが存在し、AGENTS.mdをインポートしている場合（@AGENTS.md）、AGENTS.mdを編集します。そうでなければ、CLAUDE.mdが存在すればそれを編集し、AGENTS.mdが存在すればそれを編集します。どちらも存在しない場合は、どちらを作成するか質問します。## Refinementブロックがすでに存在する場合は、ファイルの残りの部分を変更せずにその場で更新します。ブロック：
## Refinement Socratic refinement workflows: run `/which-flow` to select a workflow. Mode and conventions live in `docs/agents/refinement.md`; tracker conventions in `docs/agents/issue-tracker.md`. Artifacts live in `.scratch/<slug>/` with `Status:` and work item ID.完了条件：
refinement.md、トラッカーファイル（新規または保持）、および指示ブロックが確認された内容で存在すること。 -
結論。 ワークスペースが設定されたことを確認し、
docs/agents/refinement.mdを読み取るワークフローを一覧表示し、ファイルは後で手動編集可能であること、モード、言語、またはトラッカー規約を切り替える場合にのみこのスキルを再実行する必要があることを伝えます。