メニュー
マイクロサービスの設計ガイドを提供する。サービス定義・API 設計・ 境界コンテキストとの対応・デプロイ単位の決定手順を定義する。 USE FOR: microservice design, service definition, API design. DO NOT USE FOR: microservice implementation. WHEN: マイクロサービスを設計する、サービス定義書を作成する。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
全 Custom Agent が作業開始時に参照する共通プリアンブル。 USE FOR: agent start, common rules, preamble. DO NOT USE FOR: implementation. WHEN: Custom Agent が作業を開始したとき、共通ルールを確認したいとき。
GitHub Actions CI/CD ワークフローの共通仕様。OIDC 認証・workflow_dispatch トリガー・ Copilot push 制約対応・シークレット管理・デプロイ保護の原則を提供する。 USE FOR: GitHub Actions, CI/CD workflow, OIDC authentication. DO NOT USE FOR: application code deployment (use appropriate azure-skills/ deployment skill). WHEN: GitHub Actions ワークフローを作成する、CI/CD パイプラインを設計する。
破壊的操作を事前に検出・阫止する安全ガードの詳細パターンリストと判定フロー。 PHASE: 実行前（コマンド・スクリプト実行前に使用）。 USE FOR: destructive operation detection, rm -rf detection, DROP TABLE detection. DO NOT USE FOR: error recovery after failure (use harness-error-recovery), post-execution verification (use harness-verification-loop). WHEN: コマンドを実行する前の安全確認、破壊的操作の検出。
コード変更後の5段階検証パイプライン（Build/Lint/Test/Security/Diff）の詳細手順。 PHASE: 実行後（コード変更・生成・デプロイを行った**後**に使用）。 USE FOR: build check, lint, test execution. DO NOT USE FOR: error recovery (use harness-error-recovery), pre-execution safety check (use harness-safety-guard). WHEN: コードを変更した後の検証、ビルド確認。
knowledge/ 配下のファイル管理ルールを提供する。業務要件・判定表・連携契約等の ドメイン知識ドキュメントの分類・命名・更新手順を定義する。 USE FOR: knowledge/ file management, D01-D21 classification, domain knowledge organization. DO NOT USE FOR: qa/ file creation (use work-artifacts-layout). WHEN: knowledge/ 配下にファイルを作成・更新する、ドメイン知識を整理する。
初見のリポジトリで最小限の読解により入口・境界・標準コマンドを確定し、 onboarding.md に固定するスキル。"全部読む"を避け、作業に必要な最小限だけ確定する。 USE FOR: repository onboarding, first assignment, entry point discovery. DO NOT USE FOR: full code analysis. WHEN: リポジトリに初めてアサインされた、入口が不明。
| name | microservice-design-guide |
| description | マイクロサービスの設計ガイドを提供する。サービス定義・API 設計・ 境界コンテキストとの対応・デプロイ単位の決定手順を定義する。 USE FOR: microservice design, service definition, API design. DO NOT USE FOR: microservice implementation. WHEN: マイクロサービスを設計する、サービス定義書を作成する。 |
| metadata | {"origin":"user","version":"1.0.0"} |
マイクロサービス設計書（SVC-*.md）の作成ガイドとテンプレートを提供する。
dataflow-design-guide が担当| ファイル | 内容 |
|---|---|
references/microservice-definition.md | マイクロサービス定義書テンプレ（サービスメタ情報・API・イベント・データ・セキュリティ） |
Arch-Microservice-ServiceDetail など Microservice 系 Agent は
references/microservice-definition.md を参照してサービス定義書を作成する。
サービスごとの成果物: docs/usecase/<usecaseId>/services/<serviceId>-<serviceNameSlug>-description.md
TBD を置き、根拠のパスを記すdocs/**/SVC-*.md, docs/services/** に applyTo で適用される| Skill | 関係 | 説明 |
|---|---|---|
dataflow-design-guide | 代替 | データフロー処理設計が必要な場合 |
work-artifacts-layout | 出力先 | サービス定義書の docs/usecase/... 配下への保存先 |
task-dag-planning | 先行 | マイクロサービス設計作業の計画 |
architecture-questionnaire | 先行 | アーキテクチャ選定後にサービス設計へ遷移 |
※ 以下は説明用の架空例です。
入力: ポイント還元サービス（SVC-03）のマイクロサービス設計書を作成してほしい。UC-05（ポイント付与）を担当する。
出力:
references/microservice-definition.md を参照docs/usecase/UC-05/services/SVC-03-point-royalty-service-description.md入力: 会員サービス（SVC-01）に新しいエンドポイント GET /members/{id}/points を追加したい。
出力:
docs/usecase/UC-01/services/SVC-01-membership-service-description.mdTBD（要確認: SVC-01 担当者） と明記