ziw-setup

セットアップ

ワークフローの検索テーブルである docs/agents/workflow/config.md を作成または更新します。 検証済みのマッピングと動作するアダプターを整え、影響を受けるワークフローだけを妨げる不足項目を残します。

入力

リポジトリのパス、既存の設定／ルール、依頼されたセットアップまたは更新の範囲。

手順

1. 既存の設定を読みます。最初はフィールド索引として project-config.md を使用し、 該当するセクションを読み込みます。更新時は既存の設定にパッチを適用します。
2. 依頼内容とドリフトの兆候に基づいて、検証範囲を設定します。
3. リポジトリのファイルと読み取り専用のプロバイダークエリを通じて、値を検証します。
4. 慣例と決定事項を維持しながら、安定した設定を書き込みます。
5. アダプターを更新し、確認結果、変更内容、不足項目を報告します。

検証範囲を設定

• 最初に実行し、その後はワークフローの変更時または検証依頼時に更新します。
• 初期セットアップまたは明示的な全件検証では、該当するすべてのフィールドを対象にします。
• 範囲を限定した更新では、変更箇所、疑わしい箇所、およびその依存関係を対象にします。再検証を主張せず、無関係で安定しているマッピングは維持します。任意の無関係な連携はブロック要因になりません。
• 古くなったコマンド、名前が変更されたラベル、移動されたプロジェクト、CI、委任、または環境の変更は、影響を受ける範囲だけを拡大します。
• 対象範囲内のトラッカーのマッピングについては、設定済みの ID またはクエリで安全に使える名前を使用して、読み取り専用クエリを実行します。古い名前は、同じ範囲に対応することが検証済みの同等名に限り置き換えます。
• 欠落、古い、誤り、または新たに検証されたフィールドを変更します。ユーザーまたは最新の証拠に反しない限り、明示的な人間の決定を維持します。

作業内容に該当する参照のみを読み込みます。

• トラッカーの状態、ラベル、準備状況、本文、見積もり： issue-tracker-contract.md。
• ワーカー、無人フック、継続処理、ループ上限、容量、マージの安全性： operating-profile.md。
• Linear + Cursor：linear-cursor-example.md。
• 役割／アダプター：agent-workflow.md。
• 引き継ぎ：handoff.md。
• 未マッピングの用語集：glossary-discovery.md。

摩擦： 設定済みの苦情ツールで発生した問題を、問題の種類ごとに一度、秘密情報を含めずに記録します。ライターが存在しない、失敗する、または曖昧な応答を返す場合、トラッカーベースの受付を行う場合、またはオーケストレーターのイベントカテゴリや実行の集計を扱う場合は、friction-log.md を読み込みます。

値を検証する

適用範囲内の最新の根拠を使用します。

• リポジトリのルール、パッケージスクリプト／ロックファイル、Make／Just／Turbo、Git、CI により、 識別情報、コマンド、生成アーティファクト、ブランチ／PR の規約、ゲートを確認します。 必要に応じて、コードホスティングの保護設定、関連するチェック、PR クエリの形式を照会します。
• 仕様、用語集／コンテキストマップ、ADR、ランブック、ユーザーの指示により、 計画の権限、パス、ステータスの規約、ドキュメントのチェックを確認します。
• 読み取り専用のトラッカー呼び出しにより、場所、プロジェクト／ボード／チーム、ステータス、 ラベル、優先度、見積もり、関連付け、テンプレート、クエリの契約を確認します。 クエリで安全に使える正確な名前、安定した ID、受け入れられるフィールドを記録します。
• トラッカーのメタデータ、検証済みの設定、またはユーザーの指示により、委任、 環境ラベル、継続ハンドル、リモートの仕組みを確認します。担当者の全一覧ではなく、 対応しているパスを記録します。
• 対象リポジトリの Claude／Codex／エディター用ファイル、インポート、シンボリックリンク、生成メタデータを クリーンなパスから解決します。配布元／方式、ロックファイル、更新コマンド、プロジェクトのパス、 シンボリックリンクの構成、マーケットプレイスを検証します。
• デプロイ設定、CI、ランブック、サービス一覧、ユーザーの指示により、 プレビュー／ホスト型チェックのルール、認証情報、本番環境の承認を確認します。
• プロバイダーの設定／ドキュメント／設定画面で、有効なホスト型レビューを検証します。 CodeRabbit のルート .coderabbit.yaml は reviews.auto_review に対応します。

十分な場合は定義からコマンドを検証し、未実行のコマンドは報告します。 読み取り専用のメタデータクエリには、既存の認可済みアクセスを使用します。検証できない値は省略し、 根拠が不足していることを明記します。認可された、実行可能なフォローアップを記録します。 それ以外の場合は、担当者と対応内容を報告します。必須の不足項目により停止するのは、影響を受けるワークフローのみです。

ゲートの整合性

• フック、ローカルチェック、必須 CI ジョブをコマンドに対応付けます。ローカルタスクの不足を指摘し、 しきい値、環境要件、シークレットスキャンの範囲を維持します。
• 設定済みのタスクキャッシュを信頼し、入力が不足しているキーを持つ特定のタスクのみを列挙します。
• 運用プロファイルを通じて、無人実行時の適用と本番環境の承認を検証します。
• 設定済みの MCP 苦情記録ツールを優先します。架空のイベントを作らずにスキーマを確認します。 トラッカーへのフォールバックには、明示的な設定が必要です。

安定した設定を記述する

• 再利用可能な値、パス、コマンド、ID、ルーティング、制限、ポリシーは簡潔に記述します。 該当する計画、トラッカー／準備状況、委任、アクセス、レビュー／マージ、 環境の安全性、苦情、引き継ぎの対応付けを含めます。
• トラッカーの分類体系は既定値の参考であり、ラベルの存在を示す根拠ではありません。 検証済みの規約を維持し、別途管理されているラベルのドキュメントを設定と整合させます。
• 準備状況、リスク、レビューの根拠、タイプ、領域、所有権のポリシーに一貫性を持たせます。
• 用語集のパスを維持します。新しい既定値は GLOSSARY.md、コンテキスト間では GLOSSARY-MAP.md です。
• プロジェクト、プラグイン／マーケットプレイス、管理対象、ユーザー／グローバル、または混在する スキルの配布形態を記録します。
• 生成された ziw-* のコピーを、コミット済み依存関係、シンボリックリンクによる展開、 無視対象のキャッシュ、不在、またはリポジトリ作成のいずれかに分類します。コミット済みの 生成依存関係については、ソース／ロックファイルを保持し、機械的に更新します。
• 進捗、ブロッカー、ベースラインの失敗、検証のフォローアップをトラッカーに記録します。 CI／PR／レビュー／デプロイの状態とプロバイダーの利用可否は実行時に読み取ります。名前／IDはスキーマを示すものです。
• 状態メモを削除する前に、範囲を限定したトラッカーの場所／リポジトリの経路に関するクエリを使って、 過去のセットアップのタイトル／説明を検索します。認可されている場合は、重複しない情報を 準備状況ラベルを付けずに、設定済みの受付先へ移します。それ以外の場合はメモを保持し、対応を報告します。

アダプターを更新する

• 既存の AGENTS.md、CLAUDE.md、エディタールール、利用ドキュメントから、ワークフロースキルより先に 設定を参照するようにします。役割リファレンスを使ってアダプターを簡潔に保ちます。
• 対象リポジトリの Claude 登録ルールに従い、そのエージェント用 Markdown をインポートします。 通常は 1 行の @AGENTS.md です。
• 必要な正確なパスのみをシンボリックリンクし、クリーンなチェックアウトからリンク先を検証します。 拒否されたパスを報告し、推測せずに修復を記録します。

禁止事項

• 矛盾する値を作り出したり、そのまま残したり、無効化されている任意の連携機能を有効化したりしないでください。
• 状態スナップショット、実行の証跡、タスク、トランスクリプト、または Unknowns を設定ファイルに保存しないでください。
• 移管待ちの状態を破棄したり、トラッカーへの書き込み権限がない状態で、ローカルのバックログに置き換えたりしないでください。
• 実際の実装課題をプローブワーカーに割り当てたり、架空の苦情を起票したりしないでください。
• 生成された下流のスキルを手動で編集しないでください。
• シークレット、トークン、署名付き URL、顧客のペイロード、または非公開のログを設定ファイルに含めないでください。
• 明示的な承認なしに、セットアップ検証のみを目的として、インストール、デプロイ、高コストなホスト型サービスの利用、または認証情報を使うプロバイダーの操作を実行しないでください。許可された読み取り専用のメタデータ照会は実行できます。
• セットアップ中に本番環境へデプロイしたり、本番環境を変更したりしないでください。

完了時の報告

設定ファイルのパス、初期／全体／対象範囲を絞った各モード、検証・変更・保持したフィールド、アダプター、コマンド、実施したチェック、未解決事項、許可された後続対応、影響を受けるワークフローの準備状況を報告してください。対象範囲を絞った更新では、設定全体の検証は完了しません。