sparc-refine

SPARC の改善と完了

SPARC 手法のフェーズ 4 と 5 を実行します。コードレビューとテストを通じて反復的に改善し、検証、ドキュメント作成、デプロイ準備を行って仕上げます。

使用するタイミング

アーキテクチャフェーズが完了し、そのゲートを通過した後に使用します。このスキルでは、機能を実装済みの状態から本番環境に対応できる状態にする、最後の 2 つのフェーズを扱います。

手順

フェーズ 4 — 改善

1. これまでの成果物をすべて取得する — namespace sparc-phases を指定し、機能のスラッグをクエリとして mcp__plugin_ruflo-core_ruflo__memory_search を呼び出します。仕様（受け入れ基準）、疑似コード、アーキテクチャを読み込みます。

2. フェーズの状態を取得する — namespace sparc-state を指定して mcp__plugin_ruflo-core_ruflo__memory_search を呼び出し、現在フェーズ 4 であることを確認します。

3. コードレビュー — 以下の観点から実装をレビューします。 a. 仕様への準拠：各受け入れ基準に対応するコードパスがありますか？ b. アーキテクチャへの準拠：モジュールは定義された境界と依存関係のルールに従っていますか？ c. 疑似コードへの忠実性：実装は設計されたアルゴリズムに沿っていますか？ d. コード品質：命名規則、単一責任、エラー処理、不要なコードがないこと e. 指摘事項をレビューコメントとして記録します。

4. テストカバレッジの分析： a. 既存のテストを実行し、カバレッジを測定します。 b. カバーされていない受け入れ基準を特定します。 c. 不足しているテストを作成します。

   • 各公開関数のユニットテスト
   • モジュール間の連携を対象とする統合テスト
   • 仕様で特定された各エッジケースのテスト d. 新規コードのカバレッジ 80% 以上を目指します。

5. パフォーマンス検証 — 仕様にパフォーマンス制約が含まれている場合： a. 疑似コードで特定されたクリティカルパスをプロファイリングします。 b. 測定したパフォーマンスを制約のしきい値と比較します。 c. しきい値を満たしていない場合は最適化します。

6. 反復する — 以下をすべて満たすまで、手順 3〜5 を繰り返します。

   • すべての受け入れ基準をテストで検証できている
   • コードレビューで重大または高重要度の問題がない
   • カバレッジがしきい値を満たしている
   • パフォーマンス制約を満たしている

7. 改善の成果物を保存する — namespace sparc-phases、key refine-{feature-slug}、value { status: "complete", reviewFindings: [...], coveragePercent: N, performanceResults: {...}, iterations: N } を指定して mcp__plugin_ruflo-core_ruflo__memory_store を呼び出します。

8. 軌跡のステップを記録する — 改善の概要を指定して mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-step を呼び出します。

フェーズ 5 — 完了

9. 全体的な回帰テスト — 完全なテストスイートを実行し、改善による変更でリグレッションが発生していないことを確認します

10. トレーサビリティマトリックス — 各受け入れ基準を以下に対応付けるマトリックスを作成します：

    • 検証するテスト
    • 実装するコードファイル
    • 現在の合否状況

11. ドキュメント： a. コードコメントと型定義から API ドキュメントを生成します b. 主要な公開インターフェースの使用例を作成します c. 変更の影響を受ける既存のドキュメントを更新します

12. デプロイ準備チェックリスト：

    • すべてのテストに合格している
    • ドキュメントが完成している
    • データベースのマイグレーションを準備している（該当する場合）
    • 設定変更を文書化している
    • フィーチャーフラグを設定している（該当する場合）
    • ロールバック計画を定義している
    • セキュリティレビューが完了している（シークレットがなく、入力が検証済み）

13. 完了アーティファクトを保存 — namespace sparc-phases、key complete-{feature-slug}、value { status: "complete", traceabilityMatrix: [...], documentationFiles: [...], deploymentChecklist: {...}, regressionResult: "pass" } を指定して mcp__plugin_ruflo-core_ruflo__memory_store を呼び出します

14. トラジェクトリーを終了 — SPARC サイクルの全体サマリーを指定して mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end を呼び出します

15. ニューラルパターンをトレーニング — 成功した SPARC サイクルのデータを指定して mcp__plugin_ruflo-core_ruflo__neural_train を呼び出し、今後の予測を改善します

16. 学習したパターンを保存 — namespace patterns、key sparc-{feature-slug}、うまくいったこと、各フェーズにかかった時間、よく発生した障害を要約した value を指定して mcp__plugin_ruflo-core_ruflo__memory_store を呼び出します

17. 完了レポートを提示 — トレーサビリティマトリックス、デプロイチェックリスト、最終ステータスを表示します。最終ゲートを通過するには /sparc advance、手法に関する完全なレポートを確認するには /sparc report の実行を提案します

出力形式

# Refinement: {Feature Name}

## Code Review Summary
- Critical issues: {N} (must be 0 to pass gate)
- High issues: {N}
- Medium issues: {N}
- Resolved: {N}/{total}

## Test Coverage
- Overall: {N}%
- New code: {N}%
- Acceptance criteria covered: {N}/{total}

## Performance
| Constraint | Target | Measured | Status |
|-----------|--------|----------|--------|
| Response time | <200ms | 145ms | Pass |

---

# Completion: {Feature Name}

## Traceability Matrix
| AC | Test | Code | Status |
|----|------|------|--------|
| AC-1 | test_xxx | service.ts:42 | Pass |
| AC-2 | test_yyy | controller.ts:18 | Pass |
| AC-3 | test_zzz | repository.ts:31 | Pass |

## Deployment Checklist
- [x] All tests passing
- [x] Documentation complete
- [x] Migrations prepared
- [x] Config documented
- [x] Rollback plan defined
- [x] Security reviewed

---
SPARC workflow complete. Run `/sparc report` for the full methodology report.