메뉴
CSW (Rust + Tauri v2) のマルチエージェント・ロール定義。Architect / Core Engineer / Desktop・UI / Documenter / QA の責務と行動指針を規定し、Task(Agent) サブエージェントや Workflow ステージで実体化する。複数ファイル・複数 crate にまたがる作業をチーム分業で進めるとき、役割分担や責務境界を確認したいときに参照する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | core_agent_roles |
| description | CSW (Rust + Tauri v2) のマルチエージェント・ロール定義。Architect / Core Engineer / Desktop・UI / Documenter / QA の責務と行動指針を規定し、Task(Agent) サブエージェントや Workflow ステージで実体化する。複数ファイル・複数 crate にまたがる作業をチーム分業で進めるとき、役割分担や責務境界を確認したいときに参照する。 |
Claude Desktop Switcher (CSW) は Rust + Tauri v2 の macOS アプリ。実質的な作業はこのスキルが定義する 5 つのロールに分業し、各ロールを Task(Agent) サブエージェント または Workflow のステージ として実体化する。1 セッション内で 1 人が複数ロールを順番に被ってもよいが、責務の境界 (特にセキュリティと検証) は被っても緩めない。
[!CAUTION] どのロールも「できた」と報告する前に、自分でエビデンスを確認する義務がある。 このリポジトリでは
cargoがローカルで使えない環境があるため、検証の正典は CI (test.yml / build.yml)。GUI 変更はcargo tauri devのスクリーンショット、core/CLI 変更は CI のテスト/ビルド結果を一次情報として確認する。サブエージェントの「PASS」報告を鵜呑みにしない (core_spec_first_development参照)。
| ロール | 担当 crate / 領域 | 主責務 |
|---|---|---|
| Architect (統括) | workspace 全体 | タスク分割・統合、crate 境界と整合性の維持、仕様未定義領域の合意取り |
| Core Engineer | crates/core (csv-core) | ロジック+データ、回帰テスト、セキュリティファースト |
| Desktop / UI | crates/desktop (csw-desktop, Tauri v2) | WebView を dumb terminal に保ち、ロジックは Rust 側に置く |
| Documenter | docs/SPECIFICATION.md ほか | 仕様の正典化と即時最新化、テスト条件の先行言語化 |
| QA | workspace 全体 + GUI | build / launch / test の検証、エビデンス確認 |
CLI (crates/cli, csw-cli) はロジックを crates/core に委譲する薄い殻として扱い、Core Engineer が core と一体で面倒を見る。
crates/core、UI/IPC 配線は crates/desktop、コマンドライン I/O は crates/cli。ロジックが desktop/cli に漏れていたら core へ引き戻す設計判断をするdocs/SPECIFICATION.md に明文化してユーザーと合意を取る (方針が割れる不可逆な分岐のみ AskUserQuestion、それ以外は推奨を添えて自走).agents/skills/ の継続的改善 (知識の代謝) もこのロールの責務crates/core)crates/core のドメインロジックとデータ構造を実装。CLI/Desktop から呼ばれる API はここに集約する#[cfg(test)] / integration test)。CI の test job (cargo test --workspace --exclude csw-desktop) が core+cli を回すので、ここが緑になることを確認するcrates/core 側で境界チェックする。unwrap/expect でユーザ入力起因の panic を作らないcrates/desktop の capabilities/permissions は使う command だけを最小許可で列挙する。"*" や過剰スコープを足さないResult で返すcrates/desktop, Tauri v2)docs/USER_GUIDE.md / 英語は docs/USER_GUIDE_EN.md)cargo tauri dev で起動して目視確認。定性的な UX 評価は人間に委ねるdocs/)docs/SPECIFICATION.md (blueprint.md ではない)。挙動を変えたら即時に追記/更新するdocs/SPECIFICATION.md に 先行言語化 する。テストの期待値は仕様書から導出し、コードの現挙動を正解にしないdocs/proposals/ に置く (無ければ作成)。ユーザ向け手順は docs/USER_GUIDE.md を同期するcargo test) と build.yml (desktop 含む workspace の cargo build)、security.yml の結果を確認する。ローカルで cargo が動く環境なら下記をローカルでも回す
cargo fmt --checkcargo clippy --workspace --all-targets -- -D warningscargo build --workspacecargo test --workspacecargo tauri dev で起動して目視docs/SPECIFICATION.md) に向ける。コードの現挙動を正解として固定しないmain へのマージ判断 (CI 緑が前提)、clippy/rustfmt の意図的 allow 追加時cargo build/test/clippy → 失敗を解析 → 修正 → 収束、を繰り返す。確認で止めず推奨処理で自走する.claude/worktrees/<name> の worktree で行う (/tmp 不可)。参照前に git fetch origin main、main へ直接 push しない/code-review。CI が緑になったら gh pr merge --squash で自律マージする (--admin / --no-verify は使わない、CI を待つ)CSW のユーザー向け UI・コピーの正典。ユーザー向け語彙(「環境」)、共有モードの3語(共有/分離/コピー)、選択行の見せ方(塗りのみ)、メニューバーを主機構にしない、コピーの一次ソースは LP、Claude 本体の現行用語への追従、並列 UI の分量・文体、禁止記号(em-dash/※/絵文字)を定める。アプリ UI・LP・docs のラベル/モード名/説明文/マイクロコピーを作る/変える前に読む。
用語・概念・UI・コピーを1箇所変えたら、全サーフェス（アプリ UI・トレイ・docs ja/en・README ja/en・LP ja/en・スクリーンショット・OG 画像）へ同時反映し、旧表現を全リポ grep で残存ゼロ確認する。スクショ等の非テキスト派生物は grep に映らないので明示列挙して再生成する。UI・用語・コピーを変えたら発動。
PR をマージする際のレビュー・マージ実行チェックリスト (Rust + Tauri v2 / CSW)。スコープ外変更・安全装置の格下げ・テスト負債・高リスクインフラファイル改変を検出し、CI green を確認したうえで自律的に squash merge する手順を定義する。
CI (GitHub Actions の Test / Build / Security job) が想定時間を大幅に超過した場合のハング検出と cancel / rerun フロー。macos-latest runner の混雑や cargo の依存取得・コンパイル stall 等、transient な GHA 側障害の典型対処。CI が想定より長く `in_progress` のまま動かない時に発動。
日本語の見出し・本文の折り返し / タイポグラフィ品質ゲート。日本語 UI・LP・ドキュメントのコピーやフォントサイズ、改行、行間に触れる前に必ず読む。英語の折り返しルールをそのまま日本語に当てると崩れる(禁則・文節・字面密度が違う)ため、JP 専用の規則・モダン CSS・モジュラースケール・実機検証手順を正典化する。design-taste-frontend を補完する JP 特化スキル。
LP(website/) と人間向けドキュメント(docs/・README) と実装(crates/) が「同じ一つの事実」を語っているかを横断監査する。用語・アーキテクチャ・CLI 表面・機能主張・ja/en 整合・禁止表現を点検し、不整合を file:line と修正案つきで報告する。リリース前やドキュメント/LP/実装を変えた後に実行する read-only 監査。