442 lines
15 KiB
YAML
442 lines
15 KiB
YAML
# Expert Review Workflow
|
||
# CQRS+ES、フロントエンド、セキュリティ、QAの専門家によるレビューワークフロー
|
||
#
|
||
# フロー:
|
||
# implement -> cqrs_es_review -> frontend_review -> security_review -> qa_review -> supervise -> COMPLETE
|
||
# ↓ ↓ ↓ ↓ ↓
|
||
# fix_cqrs_es fix_frontend fix_security fix_qa fix_supervisor
|
||
#
|
||
# 修正時の戻り先はCoderが判断:
|
||
# - fix_security: MINOR→security_review, MAJOR→cqrs_es_review
|
||
# - fix_qa: MINOR→qa_review, SECURITY→security_review, MAJOR→cqrs_es_review
|
||
|
||
name: expert-review
|
||
description: CQRS+ES・フロントエンド・セキュリティ・QA専門家レビュー
|
||
|
||
max_iterations: 20
|
||
|
||
steps:
|
||
- name: implement
|
||
agent: ~/.takt/agents/default/coder.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: implement
|
||
|
||
## Original User Request (これは最新の指示ではなく、ワークフロー開始時の元の要求です)
|
||
{task}
|
||
|
||
## Additional User Inputs (ワークフロー中に追加された情報)
|
||
{user_inputs}
|
||
|
||
## Instructions
|
||
**重要**: 上記の「Original User Request」はワークフロー開始時の元の要求です。
|
||
イテレーション2回目以降の場合、すでにリサーチや調査は完了しているはずです。
|
||
セッションの会話履歴を確認し、前回の作業の続きから進めてください。
|
||
|
||
- イテレーション1: 要求を理解し、必要ならリサーチを行う
|
||
- イテレーション2以降: 前回の作業結果を踏まえて実装を進める
|
||
|
||
完了時は [CODER:DONE] を含めてください。
|
||
進行できない場合は [CODER:BLOCKED] を含めてください。
|
||
transitions:
|
||
- condition: done
|
||
next_step: cqrs_es_review
|
||
- condition: blocked
|
||
next_step: implement
|
||
|
||
# ===========================================
|
||
# Phase 1: CQRS+ES Review
|
||
# ===========================================
|
||
- name: cqrs_es_review
|
||
agent: ~/.takt/agents/expert-review/cqrs-es-reviewer.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: cqrs_es_review (CQRS+ES専門レビュー)
|
||
|
||
## Original User Request
|
||
{task}
|
||
|
||
## Git Diff
|
||
```diff
|
||
{git_diff}
|
||
```
|
||
|
||
## Instructions
|
||
CQRS（コマンドクエリ責務分離）とEvent Sourcing（イベントソーシング）の観点から
|
||
上記の変更をレビューしてください。
|
||
|
||
**レビュー観点:**
|
||
- Aggregate設計の妥当性
|
||
- イベント設計（粒度、命名、スキーマ）
|
||
- Command/Queryの分離
|
||
- プロジェクション設計
|
||
- 結果整合性の考慮
|
||
|
||
**注意**: このプロジェクトがCQRS+ESパターンを使用していない場合は、
|
||
一般的なドメイン設計の観点からレビューしてください。
|
||
|
||
Include:
|
||
- [CQRS-ES:APPROVE] if CQRS+ES design is sound
|
||
- [CQRS-ES:REJECT] if design issues found (list specific issues)
|
||
transitions:
|
||
- condition: approved
|
||
next_step: frontend_review
|
||
- condition: rejected
|
||
next_step: fix_cqrs_es
|
||
|
||
- name: fix_cqrs_es
|
||
agent: ~/.takt/agents/default/coder.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: fix_cqrs_es
|
||
|
||
## CQRS+ES Review Feedback (これが最新の指示です - 優先して対応してください)
|
||
{previous_response}
|
||
|
||
## Original User Request (ワークフロー開始時の元の要求 - 参考情報)
|
||
{task}
|
||
|
||
## Additional User Inputs
|
||
{user_inputs}
|
||
|
||
## Instructions
|
||
**重要**: CQRS+ES専門家からの指摘を修正してください。
|
||
|
||
指摘されたポイント:
|
||
- Aggregate設計
|
||
- イベント設計
|
||
- Command/Query分離
|
||
- プロジェクション
|
||
- 結果整合性
|
||
|
||
完了時は [CODER:DONE] を含めてください。
|
||
進行できない場合は [CODER:BLOCKED] を含めてください。
|
||
pass_previous_response: true
|
||
transitions:
|
||
- condition: done
|
||
next_step: cqrs_es_review
|
||
- condition: blocked
|
||
next_step: fix_cqrs_es
|
||
|
||
# ===========================================
|
||
# Phase 2: Frontend Review
|
||
# ===========================================
|
||
- name: frontend_review
|
||
agent: ~/.takt/agents/expert-review/frontend-reviewer.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: frontend_review (フロントエンド専門レビュー)
|
||
|
||
## Original User Request
|
||
{task}
|
||
|
||
## Git Diff
|
||
```diff
|
||
{git_diff}
|
||
```
|
||
|
||
## Instructions
|
||
フロントエンド開発の観点から上記の変更をレビューしてください。
|
||
|
||
**レビュー観点:**
|
||
- コンポーネント設計（責務分離、粒度）
|
||
- 状態管理（ローカル/グローバルの判断）
|
||
- パフォーマンス（再レンダリング、メモ化）
|
||
- アクセシビリティ（キーボード操作、ARIA）
|
||
- データフェッチパターン
|
||
- TypeScript型安全性
|
||
|
||
**注意**: このプロジェクトがフロントエンドを含まない場合は、
|
||
[FRONTEND:APPROVE] として次に進んでください。
|
||
|
||
Include:
|
||
- [FRONTEND:APPROVE] if frontend design is sound
|
||
- [FRONTEND:REJECT] if design issues found (list specific issues)
|
||
transitions:
|
||
- condition: approved
|
||
next_step: security_review
|
||
- condition: rejected
|
||
next_step: fix_frontend
|
||
|
||
- name: fix_frontend
|
||
agent: ~/.takt/agents/default/coder.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: fix_frontend
|
||
|
||
## Frontend Review Feedback (これが最新の指示です - 優先して対応してください)
|
||
{previous_response}
|
||
|
||
## Original User Request (ワークフロー開始時の元の要求 - 参考情報)
|
||
{task}
|
||
|
||
## Additional User Inputs
|
||
{user_inputs}
|
||
|
||
## Instructions
|
||
**重要**: フロントエンド専門家からの指摘を修正してください。
|
||
|
||
指摘されたポイント:
|
||
- コンポーネント設計
|
||
- 状態管理
|
||
- パフォーマンス
|
||
- アクセシビリティ
|
||
- 型安全性
|
||
|
||
完了時は [CODER:DONE] を含めてください。
|
||
進行できない場合は [CODER:BLOCKED] を含めてください。
|
||
pass_previous_response: true
|
||
transitions:
|
||
- condition: done
|
||
next_step: frontend_review
|
||
- condition: blocked
|
||
next_step: fix_frontend
|
||
|
||
# ===========================================
|
||
# Phase 3: Security Review
|
||
# ===========================================
|
||
- name: security_review
|
||
agent: ~/.takt/agents/expert-review/security-reviewer.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: security_review (セキュリティ専門レビュー)
|
||
|
||
## Original User Request
|
||
{task}
|
||
|
||
## Git Diff
|
||
```diff
|
||
{git_diff}
|
||
```
|
||
|
||
## Instructions
|
||
セキュリティの観点から上記の変更をレビューしてください。
|
||
|
||
**レビュー観点:**
|
||
- インジェクション攻撃（SQL, コマンド, XSS）
|
||
- 認証・認可の不備
|
||
- 機密情報の取り扱い
|
||
- 暗号化の適切性
|
||
- OWASP Top 10
|
||
|
||
Include:
|
||
- [SECURITY:APPROVE] if no security issues found
|
||
- [SECURITY:REJECT] if vulnerabilities found (list specific issues with severity)
|
||
transitions:
|
||
- condition: approved
|
||
next_step: qa_review
|
||
- condition: rejected
|
||
next_step: fix_security
|
||
|
||
- name: fix_security
|
||
agent: ~/.takt/agents/default/coder.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: fix_security
|
||
|
||
## Security Review Feedback (これが最新の指示です - 優先して対応してください)
|
||
{previous_response}
|
||
|
||
## Original User Request (ワークフロー開始時の元の要求 - 参考情報)
|
||
{task}
|
||
|
||
## Additional User Inputs
|
||
{user_inputs}
|
||
|
||
## Instructions
|
||
**重要**: セキュリティ専門家からの指摘を修正してください。
|
||
セキュリティ問題は最優先で対応してください。
|
||
|
||
指摘されたポイント:
|
||
- インジェクション脆弱性
|
||
- 認証・認可の不備
|
||
- 機密情報の露出
|
||
- 暗号化の問題
|
||
|
||
## 修正完了時の判断
|
||
修正が完了したら、**変更の影響範囲**を判断して適切なタグを出力してください：
|
||
|
||
- `[CODER:MINOR]` - 軽微な修正（セキュリティレビューのみ再実施）
|
||
- 例: バリデーション追加、エスケープ処理追加、設定変更
|
||
- `[CODER:MAJOR]` - 大きな修正（CQRS+ESレビューからやり直し）
|
||
- 例: データフロー変更、API設計変更、認証方式変更、ドメインモデル変更
|
||
|
||
進行できない場合は [CODER:BLOCKED] を含めてください。
|
||
pass_previous_response: true
|
||
transitions:
|
||
- condition: minor
|
||
next_step: security_review
|
||
- condition: major
|
||
next_step: cqrs_es_review
|
||
- condition: blocked
|
||
next_step: fix_security
|
||
|
||
# ===========================================
|
||
# Phase 4: QA Review
|
||
# ===========================================
|
||
- name: qa_review
|
||
agent: ~/.takt/agents/expert-review/qa-reviewer.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: qa_review (QA専門レビュー)
|
||
|
||
## Original User Request
|
||
{task}
|
||
|
||
## Git Diff
|
||
```diff
|
||
{git_diff}
|
||
```
|
||
|
||
## Instructions
|
||
品質保証の観点から上記の変更をレビューしてください。
|
||
|
||
**レビュー観点:**
|
||
- テストカバレッジと品質
|
||
- テスト戦略（単体/統合/E2E）
|
||
- ドキュメント（コード内・外部）
|
||
- エラーハンドリング
|
||
- ログとモニタリング
|
||
- 保守性
|
||
|
||
Include:
|
||
- [QA:APPROVE] if quality standards are met
|
||
- [QA:REJECT] if quality issues found (list specific issues)
|
||
transitions:
|
||
- condition: approved
|
||
next_step: supervise
|
||
- condition: rejected
|
||
next_step: fix_qa
|
||
|
||
- name: fix_qa
|
||
agent: ~/.takt/agents/default/coder.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: fix_qa
|
||
|
||
## QA Review Feedback (これが最新の指示です - 優先して対応してください)
|
||
{previous_response}
|
||
|
||
## Original User Request (ワークフロー開始時の元の要求 - 参考情報)
|
||
{task}
|
||
|
||
## Additional User Inputs
|
||
{user_inputs}
|
||
|
||
## Instructions
|
||
**重要**: QA専門家からの指摘を修正してください。
|
||
|
||
指摘されたポイント:
|
||
- テストの追加・改善
|
||
- ドキュメントの追加・修正
|
||
- エラーハンドリング
|
||
- ログ出力
|
||
- コード品質
|
||
|
||
## 修正完了時の判断
|
||
修正が完了したら、**変更の影響範囲**を判断して適切なタグを出力してください：
|
||
|
||
- `[CODER:MINOR]` - 軽微な修正（QAレビューのみ再実施）
|
||
- 例: テスト追加、ドキュメント追加、ログ追加、コメント追加
|
||
- `[CODER:SECURITY]` - セキュリティに影響する修正（セキュリティレビューからやり直し）
|
||
- 例: エラーハンドリング変更（エラーメッセージの内容変更）、入力検証の変更
|
||
- `[CODER:MAJOR]` - 大きな修正（CQRS+ESレビューからやり直し）
|
||
- 例: ビジネスロジック変更、データモデル変更、API変更
|
||
|
||
進行できない場合は [CODER:BLOCKED] を含めてください。
|
||
pass_previous_response: true
|
||
transitions:
|
||
- condition: minor
|
||
next_step: qa_review
|
||
- condition: security
|
||
next_step: security_review
|
||
- condition: major
|
||
next_step: cqrs_es_review
|
||
- condition: blocked
|
||
next_step: fix_qa
|
||
|
||
# ===========================================
|
||
# Phase 5: Supervision
|
||
# ===========================================
|
||
- name: supervise
|
||
agent: ~/.takt/agents/expert-review/supervisor.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: supervise (最終確認)
|
||
|
||
## Original User Request
|
||
{task}
|
||
|
||
## Git Diff
|
||
```diff
|
||
{git_diff}
|
||
```
|
||
|
||
## Previous Reviews Summary
|
||
このステップに到達したということは、以下のレビューがすべてAPPROVEされています：
|
||
- CQRS+ES Review: APPROVED
|
||
- Frontend Review: APPROVED
|
||
- Security Review: APPROVED
|
||
- QA Review: APPROVED
|
||
|
||
## Instructions
|
||
監督者として、すべてのレビュー結果を統括し、最終判断を下してください。
|
||
|
||
**確認観点:**
|
||
- 各レビュー結果に矛盾がないか
|
||
- 元の要求が満たされているか
|
||
- 全体として整合性が取れているか
|
||
- リリースに値する品質か
|
||
|
||
Include:
|
||
- [SUPERVISOR:APPROVE] if ready for release
|
||
- [SUPERVISOR:REJECT] if additional work needed (list specific items)
|
||
transitions:
|
||
- condition: approved
|
||
next_step: COMPLETE
|
||
- condition: rejected
|
||
next_step: fix_supervisor
|
||
|
||
- name: fix_supervisor
|
||
agent: ~/.takt/agents/default/coder.md
|
||
instruction_template: |
|
||
## Workflow Context
|
||
- Iteration: {iteration}/{max_iterations}
|
||
- Step: fix_supervisor
|
||
|
||
## Supervisor Feedback (これが最新の指示です - 優先して対応してください)
|
||
{previous_response}
|
||
|
||
## Original User Request (ワークフロー開始時の元の要求 - 参考情報)
|
||
{task}
|
||
|
||
## Additional User Inputs
|
||
{user_inputs}
|
||
|
||
## Instructions
|
||
**重要**: 監督者からの指摘を修正してください。
|
||
|
||
監督者は全体を俯瞰した視点から問題を指摘しています。
|
||
優先度の高い項目から順に対応してください。
|
||
|
||
完了時は [CODER:DONE] を含めてください。
|
||
進行できない場合は [CODER:BLOCKED] を含めてください。
|
||
pass_previous_response: true
|
||
transitions:
|
||
- condition: done
|
||
next_step: supervise
|
||
- condition: blocked
|
||
next_step: fix_supervisor
|
||
|
||
initial_step: implement
|