Gitea ワークフロー オーケストレーター

チェックポイントベースのフロー制御を使用して、Gitea リポジトリの構造化された agile 開発ワークフローをエージェントに案内し、コマンドを順序立てて実行するスキル。キーの決定ポイントで一時停止しながら、ステップ間で自動的に進行します。

このスキルを使用する場合

以下の場合にこのスキルを使用してください:

• Gitea でホストされているリポジトリで作業している
• その日の作業を開始する場合 (「朝のスタンドアップを実行」「仕事を開始」)
• タスクで作業する場合 (「次のタスクを実装」「作業を続行」)
• 開発サイクルを完了する場合 (「このタスクを終了」「PR を準備」)
• スプリント儀式を実施する場合 (「スプリントを開始」「スプリントを終了」「レトロスペクティブ」)
• 中断された作業を再開する場合 (「次は何か」「どこまで進んだか」)

このスキルを使用しないでください:

• GitHub リポジトリで作業している場合 (代わりに agile-workflow を使用)
• 単一の特定のコマンドを実行する場合 (そのコマンドを直接使用)
• ステータスを確認するだけの場合 (/status を直接使用)
• 全サイクルなしでコードレビューのみを行う場合 (/review-code を直接使用)
• 実装なしで調査または計画している場合

前提条件

このスキルを使用する前に:

• Git リポジトリ ワークツリーサポートで初期化
• Gitea Tea CLI インストール済みで認証済み (tea login)
• コンテキストネットワーク context-network/backlog/ にバックログ構造あり
• タスクステータスファイル context-network/backlog/by-status/*.md
• GITEA_URL 環境変数設定済み (または tea で設定)
• GITEA_TOKEN 環境変数設定済み (API スクリプト用)

ワークフロータイプ概要

WORKFLOW TYPES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TASK CYCLE (Primary)     DAILY                SPRINT
──────────────────────   ──────────────────   ──────────────────
sync                     Morning:             Start:
  ↓                        sync --last 1d       sync --all
next → [CHECKPOINT]        status --brief       groom --all
  ↓                        groom --ready        plan sprint-goals
implement                                       status
  ↓                      Evening:
[CHECKPOINT]               checklist          End:
  ↓                        discovery            sync --sprint
review-code                sync --last 1d       retrospective
review-tests                                    audit --sprint
  ↓                                             status --metrics
[CHECKPOINT]                                    maintenance --deep
  ↓
apply-recommendations (if issues)
  ↓
pr-prep → [CHECKPOINT]
  ↓
pr-complete
  ↓
update-backlog & status
  ↓
END
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

状態検出

スキルは現在のワークフロー状態を自動的に判定します。手動追跡は不要です。

検出信号

信号	確認方法	意味
ワークツリー存在	git worktree list	進行中のタスク
タスクブランチアクティブ	git branch --show-current が task/* に一致	アクティブな実装
コミット前の変更	git status --porcelain	進行中のコーディング
PR 存在	tea pulls list --state open	レビュー中
PR マージ済み	tea pulls + 状態確認	クリーンアップ準備完了

状態マトリックス

STATE DETECTION LOGIC
─────────────────────────────────────────────────────────────
確認項目                        → 状態           → 次のステップ
─────────────────────────────────────────────────────────────
ワークツリーなし、進行中タスクなし  → IDLE            → sync, next
ワークツリー存在、コミット前変更   → IMPLEMENTING    → 実装を続行
ワークツリー存在、すべてコミット済み → READY_REVIEW    → review-code
PR オープン、CI 保留中           → AWAITING_CI     → 待機または対応
PR オープン、CI パス             → READY_MERGE     → pr-complete
PR マージ済み、ワークツリー存在   → CLEANUP         → pr-complete
─────────────────────────────────────────────────────────────

詳細な検出アルゴリズムについては、references/state-detection.md を参照してください。

呼び出しパターン

# 現在の状態を自動検出して続行
/gitea-workflow

# 特定のワークフローフェーズを開始
/gitea-workflow --phase task-cycle
/gitea-workflow --phase daily-morning
/gitea-workflow --phase daily-evening
/gitea-workflow --phase sprint-start
/gitea-workflow --phase sprint-end

# 特定のタスクで作業を再開
/gitea-workflow --task TASK-123

# 実行せずに何が起こるかをプレビュー
/gitea-workflow --dry-run

タスクサイクルフェーズ

選択からマージまでの単一タスク完了のための主要なワークフロー。

ステップ 1: 現実を同期

コンテキストネットワークが実際のプロジェクト状態と一致していることを確認します。

実行: sync --last 1d --dry-run
目的: 文書化と実際の状態の間のズレを検出
出力: 完了、部分的な作業、相違点を示す同期レポート

ステップ 2: タスクを選択

次に作業するタスクを特定します。

実行: next
目的: 最高優先度の準備完了タスクを検索
出力: タスク ID、タイトル、推奨ブランチ名

チェックポイント: TASK_SELECTED

• タスク選択を確認するために一時停止
• ユーザーは承認または別のタスクを選択可能
• 承認時: 実装に進行

ステップ 3: 実装

分離されたワークツリーでテスト駆動開発を行います。

実行: implement [TASK-ID]
目的: ワークツリーを作成、最初にテストを記述、実装、検証
出力: テスト合格の動作する実装

チェックポイント: IMPL_COMPLETE

• 実装完了後に一時停止
• テスト結果とカバレッジを表示
• 成功時: レビューに進行

ステップ 4: レビュー

実装の品質検証。

実行: review-code --uncommitted
実行: review-tests --uncommitted
目的: 品質問題、セキュリティの問題、テストギャップを特定
出力: 問題と推奨事項を含むレビューレポート

チェックポイント: REVIEWS_DONE

• 統合レビュー結果を表示
• 重大な問題がある場合: 続行前に対応が必須
• 問題がない場合: PR 準備に自動進行
• ユーザーが決定: 推奨事項をすぐに適用するか後回しにするか

ステップ 5: 推奨事項を適用 (条件付き)

レビュー検出事項に知的に対応します。

実行: apply-recommendations [review-output]
目的: クイックフィックスをすぐに適用、複雑な変更はタスクに延期
出力: 適用された修正 + 作成されたフォローアップタスク

ステップ 6: PR を準備

完全なドキュメント付きプルリクエストを作成します。

実行: pr-prep
目的: 検証、ドキュメント化、PR を作成
出力: 説明付きで作成された PR、テスト検証済み

チェックポイント: PR_CREATED

• PR URL と CI ステータスを表示
• CI チェック完了を待機 (手動またはAPI スクリプトで確認)
• CI パス + 承認時: マージに進行
• CI 失敗時: 停止、問題に対応

ステップ 7: PR を完了

マージとクリーンアップ。

実行: pr-complete [PR-NUMBER]
目的: PR をマージ、ブランチ削除、ワークツリー削除、ステータス更新
出力: タスクは完了とマーク、クリーンアップ完了

ステップ 8: バックログとプロジェクトステータスを更新

進捗を信頼できるドキュメント化に永続化します。

実行: pr-complete の一部 (フェーズ 6)
目的: エピックファイルを更新 (タスク → 完了)、依存関係を解除、プロジェクトステータスを更新
出力: バックログとプロジェクトステータスは実際の進捗を反映

このステップが重要な理由: これなしでは、完了したタスクはバックログファイルで「準備完了」のままマークされ、プロジェクトステータスは古いままです。内部追跡ファイルはセッションスコープ; バックログとステータスファイルは永続的な信頼できる情報源です。

詳細なタスクサイクル指示については、references/phases/task-cycle.md を参照してください。

日次フェーズ

営業日の開始と終了のための簡潔なシーケンス。

朝のスタンドアップ (~5 分)

実行シーケンス:
1. sync --last 1d --dry-run   # 昨日実際に起こったこと
2. status --brief --sprint    # 現在のスプリント状態
3. groom --ready-only         # 今日作業準備完了なもの

出力: 今日の優先度が明確

夕方の片付け (~10 分)

実行シーケンス:
1. checklist                  # 何も失われていないことを確認
2. discovery                  # 学習を記録
3. sync --last 1d            # タスクステータスを更新

出力: 知識保存、状態同期

詳細な日次指示については、references/phases/daily.md を参照してください。

スプリントフェーズ

スプリント境界の儀式。

スプリント開始 (~60 分)

実行シーケンス:
1. sync --all                 # 完全な現実調整
2. groom --all               # 包括的なグルーミング
3. plan sprint-goals         # アーキテクチャとゴール
4. status --detailed         # ベースラインメトリクス

出力: グルーミングされた準備完了バックログを持つスプリント計画

スプリント終了 (~90 分)

実行シーケンス:
1. sync --sprint             # 最終スプリント同期
2. retrospective             # 学習を記録
3. audit --scope sprint      # 品質レビュー
4. status --metrics          # スプリントメトリクス
5. maintenance --deep        # コンテキストネットワーククリーンアップ

出力: スプリント終了、学習記録、次への準備完了

詳細なスプリント指示については、references/phases/sprint.md を参照してください。

チェックポイント処理

チェックポイントは人間の意思決定のための一時停止です。

チェックポイント動作

各チェックポイントで:

1. 要約 完了したばかりのこと
2. 表示 重要な結果と問題
3. 提示 次のステップ
4. 待機 ユーザー入力

チェックポイントレスポンス

レスポンス	アクション
「continue」/ 「proceed」/ 「yes」	次のステップに移動
「stop」/ 「pause」	状態を保存、ワークフロー終了
「back」	前のステップを再実行
「skip」	現在のステップをスキップ (慎重に使用)
カスタム入力	次のステップのパラメータを調整する場合あり

自動進行条件

条件が満たされている場合、一部のチェックポイントは自動進行可能:

チェックポイント	自動進行条件
IMPL_COMPLETE	すべてのテスト合格、ビルド成功
REVIEWS_DONE	重大または高い重要度の問題なし
PR_CREATED	CI パス (API で検証)、必要な承認取得

詳細なチェックポイント処理については、references/checkpoint-handling.md を参照してください。

コマンドリファレンス

各ワークフローステップは埋め込みコマンド指示を使用:

コマンド	リファレンス	目的
sync	references/commands/sync.md	現実同期
groom	references/commands/groom.md	タスク洗練
next	references/commands/next.md	タスク選択
implement	references/commands/implement.md	TDD 実装
review-code	references/commands/review-code.md	コード品質レビュー
review-tests	references/commands/review-tests.md	テスト品質レビュー
apply-recommendations	references/commands/apply-recommendations.md	トリアージと修正適用
pr-prep	references/commands/pr-prep.md	PR 作成
pr-complete	references/commands/pr-complete.md	PR マージとクリーンアップ
discovery	references/commands/discovery.md	学習記録
retrospective	references/commands/retrospective.md	事後分析
maintenance	references/commands/maintenance.md	コンテキストネットワーククリーンアップ

例: 完全なタスクサイクル

シナリオ: 営業日開始、次の利用可能なタスクを実装

呼び出し:

/gitea-workflow --phase task-cycle

フロー:

Agent: 現在の状態を検出中...
       ワークツリーなし、準備完了タスクを確認中...

Agent: sync --last 1d --dry-run を実行
       [同期出力: 0 タスク完了だが文書化なし]

Agent: next を実行
       検出: TASK-042 - ユーザー設定エンドポイントを追加
       優先度: High | サイズ: Small | ブランチ: task/TASK-042-preferences

       ╔═══════════════════════════════════════════╗
       ║  チェックポイント: タスク選択               ║
       ╠═══════════════════════════════════════════╣
       ║  選択: TASK-042                          ║
       ║  実装を続行しますか?                       ║
       ║                                           ║
       ║  [continue] [stop] [other task]           ║
       ╚═══════════════════════════════════════════╝

User: continue

Agent: .worktrees/TASK-042/ にワークツリーを作成
       implement TASK-042 を実行
       [TDD で実装を進行...]

       テスト: 12 合格
       カバレッジ: 87%
       ビルド: Success

       ╔═══════════════════════════════════════════╗
       ║  チェックポイント: 実装完了               ║
       ╠═══════════════════════════════════════════╣
       ║  すべてのテスト合格、レビュー準備完了     ║
       ║  コードレビューに進みますか?              ║
       ║                                           ║
       ║  [continue] [stop]                        ║
       ╚═══════════════════════════════════════════╝

[フロー: レビュー、PR、マージを経て続行...]

Gitea 固有のノート

CI ステータス確認

Gitea は外部 CI システム (Drone、Woodpecker、Jenkins など) を使用します。CI ステータスを確認するには:

1. API スクリプト経由: scripts/gitea-ci-status.sh を使用してコミットステータスをクエリ
2. 手動確認: CI ダッシュボードから直接確認
3. PR マージ可能性: Gitea UI で PR がマージ可能と表示されるかを確認

Tea CLI コマンドリファレンス

操作	Tea CLI コマンド
オープン PR を一覧表示	tea pulls list --state open
PR を作成	tea pulls create --title "..." --description "..." --base main --head branch
PR を表示	tea pulls
PR をマージ (squash)	tea pulls merge --style squash
PR をマージ (merge)	tea pulls merge --style merge
PR をマージ (rebase)	tea pulls merge --style rebase
PR を承認	tea pulls approve
課題を一覧表示	tea issues list

API スクリプト

tea CLI で利用できない操作には、提供されている API スクリプトを使用:

• scripts/gitea-ci-status.sh - Gitea API 経由で CI ステータスを確認
• scripts/gitea-pr-checks.sh - PR レビュー/承認ステータスを取得

制限事項

• 特定のバックログ構造を持つコンテキストネットワークが必要
• Gitea 中心 (PR 操作に tea CLI を使用)
• 単一タスクフォーカス (並列タスク作業はオーケストレーション対象外)
• 手動 CI 検証が必要な場合あり (Gitea は外部 CI を使用)
• 一部機能は Gitea バージョンと設定に依存

関連スキル

• skill-maker - agentskills.io 仕様に従って新しいスキルを作成
• research-workflow - 実装前の調査タスク用
• gitea-coordinator - Gitea での複数タスクオーケストレーション用