AgentSkillsCN

implementation-plan

通过逐步制定规格与实施计划，按步骤推进项目落地的技能。在开发新功能、进行大规模重构，或对现有功能进行大幅调整时，提前撰写规格书与实施计划，助力各阶段的渐进式实施。“制定规格书”、“实施计划”、“希望分阶段实施”、“划分阶段”、“创建设计文档”、“重构计划”、“实施步骤”、“制定计划”、“路线图”、“任务分解”、“想要设计”、“希望进行重大变更”、“implementation plan”、“spec”、“roadmap”等关键词都会触发此技能。

SKILL.md
--- frontmatter
name: implementation-plan
description: 仕様・実装計画書を作成して段階的にステップごとに実装するためのスキル。新機能の開発、大規模リファクタリング、機能の大幅な見直し時に仕様書と実装計画を事前に作成し、フェーズごとの段階的実装を支援する。「仕様書を作って」「実装計画」「段階的に実装したい」「フェーズ分けして」「設計書を作成」「リファクタリング計画」「実装ステップ」「計画を立てて」「ロードマップ」「タスク分解」「設計したい」「大きな変更をしたい」「implementation plan」「spec」「roadmap」などで発火。

Implementation Plan Skill

スキル読み込み通知

このスキルが読み込まれたら、必ず以下の通知をユーザーに表示してください：

💡 Implementation Plan スキルを読み込みました
仕様・実装計画書を作成し、段階的な実装を支援します。

When to Use

  • •新機能を実装する前に仕様と実装計画を立てたいとき
  • •大規模なリファクタリングを段階的に進めたいとき
  • •既存機能の大幅な見直しを行うとき
  • •複数フェーズに分けて安全に実装を進めたいとき
  • •AIに一度に大量のコンテキストを与えず、計画的に実装したいとき
  • •「大きな変更をしたいけどどこから手をつければいいか分からない」とき
  • •変更の影響範囲を事前に整理しておきたいとき

概要

このスキルは、本プロジェクト（Turtle Video）の spec.md を参考にした実装計画書テンプレートを提供します。段階的な実装により、以下の効果を得られます：

  • •コンテキストの最適化: AIに一度に大量の情報を与えず、フェーズごとに必要な情報だけを伝達
  • •安全な実装: 各フェーズ終了時に動作確認を行い、既存機能を壊さずに進行
  • •進捗の可視化: チェックリストで完了状況を把握
  • •手戻りの防止: 事前に設計を固めることで不要なやり取りを削減

計画書作成手順

Step 1: 現状分析

以下の情報を収集・整理する：

  1. •関連ファイルの調査: 変更対象のファイルを特定し、現在の実装を確認
  2. •影響範囲の確認: 変更が他のコンポーネント・ストア・フックに与える影響を確認
  3. •既存テストの確認: src/test/ 配下の関連テストを確認
  4. •型定義の確認: src/types/index.ts で関連する型を確認

Step 2: 仕様書セクションの作成

以下のテンプレートに沿って仕様を明文化する：

📄 assets/spec-template.md

Step 3: 実装計画の作成

フェーズ別に分割し、以下のテンプレートに従う：

📄 assets/phase-template.md

Step 4: 計画書のレビュー

作成した計画書について以下を確認する：

  • • 各フェーズが独立して動作確認可能か
  • • フェーズ間の依存関係が明確か
  • • 1フェーズの変更量が適切か（大きすぎないか）
  • • 既存機能を壊さない手順になっているか
  • • テスト計画が含まれているか

フェーズ設計のガイドライン

フェーズ分割の原則、典型的なフェーズ構成、本プロジェクト固有の注意点、レビューチェックリストは以下を参照してください：

📄 references/phase-design-guide.md

参考資料