mcpField
F
feature-workflow

feature-workflow

github.com/arraydude開発2133 回インストール16 週間前に更新
リポジトリ

feature-workflow について

開発者と AI エージェント向けに、仕様作成、フェーズ分割、進捗管理、PR 戦略、アーカイブを扱う機能開発ワークフローのガイドです。19 のルールで、初期分析から完了までの協業を支援します。

主な機能

  1. 01仕様書の構成と内容の定義
  2. 02実装作業のフェーズ分割
  3. 03フェーズの進捗と完了状況の追跡
  4. 04PR の範囲とブランチ戦略の設定
  5. 05仕様書と知見のアーカイブ

活用シーン

  1. 01機能や移行の仕様書作成
  2. 02レビュー可能なフェーズへの開発計画分割
  3. 03フェーズごとの実装進捗管理
  4. 04マージ後の仕様書と知見のアーカイブ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/arraydude/agent-skills --skill feature-workflow

インストール後、Claude Code で/feature-workflowを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

AGENTS.md
rules/
archive-preservation-format.md
archive-when-to-archive.md
phase-decomposition.md
phase-dependency-ordering.md
phase-zero-foundation.md
pr-branch-naming.md
pr-per-phase-strategy.md
pr-scope-and-review.md
pr-target-develop-branch.md
spec-content-sections.md
spec-current-state-analysis.md
spec-living-document.md
spec-structure.md
tracking-completion-reports.md
tracking-metrics-tables.md
tracking-status-indicators.md
workflow-collaboration-loop.md
workflow-iteration-patterns.md
workflow-spec-placement.md

詳細

機能ワークフロー

機能の計画、仕様策定、実装、アーカイブに関する包括的なガイドです。完了した18件以上の機能仕様をもとに、6つのカテゴリーにわたる19のルールをまとめています。

適用するタイミング

次の場合に、これらのガイドラインを参照してください。

  • 新しい機能や移行に着手するとき
  • 仕様書を作成または更新するとき
  • 作業を実装フェーズに分割するとき
  • 仕様書内の進捗を追跡するとき
  • PR の範囲やブランチ戦略を決めるとき
  • 機能を完成させ、仕様書をアーカイブするとき

優先度別のルールカテゴリー

優先度カテゴリー影響度プレフィックス
1仕様の構造と内容重大spec-
2フェーズ設計重大phase-
3進捗管理高tracking-
4PR 戦略高pr-
5アーカイブ中archive-
6ワークフローでの協業中workflow-

クイックリファレンス

1. 仕様の構造と内容（重大）
  • spec-structure - 必須の仕様書構成（タイトル、メタデータ、目次、セクション）
  • spec-content-sections - 各セクションに記載すべき内容（エグゼクティブサマリー、目標、アーキテクチャ、計画、テスト、基準）
  • spec-current-state-analysis - 必ず現状分析から始める：コードの一覧、根拠を示した問題点
  • spec-living-document - 実装中も仕様書を更新し、履歴を削除しない
2. フェーズ設計（重大）
  • phase-zero-foundation - フェーズ 0 は必ず基盤／インフラストラクチャの作業とする
  • phase-decomposition - 個別にレビュー、リリースできるフェーズに作業を分割する
  • phase-dependency-ordering - 依存関係に沿ってフェーズを並べる
3. 進捗管理（高）
  • tracking-status-indicators - 一貫したステータス表示と進捗トラッカーを使用する
  • tracking-completion-reports - フェーズごとに完了レポートを作成する
  • tracking-metrics-tables - 変更前後の指標を表にまとめる
4. PR 戦略（高）
  • pr-target-develop-branch - 重大：機能 PR の宛先は常に develop とし、main は指定しない
  • pr-per-phase-strategy - レビューしやすいよう、フェーズごとに PR を1つ作成する
  • pr-branch-naming - GitFlow の規則に沿ってブランチ名を付ける
  • pr-scope-and-review - PR の範囲を絞り、範囲を明確に文書化する
5. アーカイブ（中）
  • archive-when-to-archive - すべてのフェーズが完了し、PR がマージされた後にアーカイブする
  • archive-preservation-format - 完了時のメモ、学び、指標を保存する
6. ワークフローでの協業（中）
  • workflow-collaboration-loop - AI と開発者が反復的に計画を進める
  • workflow-spec-placement - 関連するパッケージの .claude/ ディレクトリに仕様書を配置する
  • workflow-iteration-patterns - 要件が変更された場合の反復方法

ワークフローの基本

  1. 発見 - 開発者が機能や問題を説明する
  2. 分析 - コードベースを調査し、現状を文書化する
  3. 提案 - アーキテクチャとフェーズを含む仕様書の草案を作成する
  4. レビュー - 開発者がレビューし、フィードバックを提供する
  5. 改善 - フィードバックに基づいて仕様書を更新する
  6. 承認 - 開発者が計画を承認する
  7. 実装 - フェーズごとに進め、各フェーズで PR を作成する
  8. アーカイブ - 完了した仕様書を移動し、学びを記録する

使用方法

詳しい説明とコード例については、個別のルールファイルを読んでください。

rules/spec-structure.md
rules/phase-decomposition.md
rules/tracking-status-indicators.md
rules/pr-per-phase-strategy.md
rules/archive-when-to-archive.md
rules/workflow-collaboration-loop.md

各ルールファイルには、次の内容が含まれています。

  • 重要である理由の簡単な説明
  • 誤った例（アンチパターン）
  • 正しい例（ベストプラクティス）

コンパイル済みの全ドキュメント

すべてのルールを詳しく展開した完全なガイドについては、AGENTS.md を参照してください。

コメント

Markdown 対応