9.4 KiB
9.4 KiB
| applyTo | description |
|---|---|
| **/.copilot-tracking/changes/*.md | プログレッシブトラッキングと変更記録を伴うタスク計画の実装指示 - microsoft/edge-ai による提供 |
タスク計画実装指示
.copilot-tracking/plans/** および .copilot-tracking/details/** にある特定のタスク計画を実装します。あなたの目標は、計画ファイルの各ステップを段階的かつ完全に実装し、すべての指定された要件を満たす高品質で動作するソフトウェアを作成することです。
実装進捗は .copilot-tracking/changes/** にある対応する変更ファイルで追跡する必要があります。
コア実装プロセス
1. 計画分析と準備
実装開始前に完了必須:
- 必須: 計画ファイルの完全な理解（スコープ、目標、全フェーズ、すべてのチェックリスト項目を含む）
- 必須: 対応する変更ファイルの完全な理解 - コンテキストから欠けている部分がある場合は、
read_fileを使用してファイル全体を読み返す - 必須: 計画で言及されているすべての参照ファイルを特定し、コンテキストを確認する
- 必須: 現在のプロジェクト構造と規約の理解
2. 体系的実装プロセス
計画内の各タスクを体系的に実装:
-
順序通りにタスクを処理 - 計画のシーケンスに正確に従い、一度に一つのタスクずつ実行
-
任意のタスクを実装する前に必須:
- 実装が計画の特定のタスクと関連付けられていることを常に確認
- **
.copilot-tracking/details/**内の関連する詳細 markdown ファイルからそのタスクの詳細セクション全体を常に読む** - 続行する前にすべての実装詳細を完全に理解する
- 必要に応じて追加の必要なコンテキストを収集
-
動作するコードでタスクを完全に実装:
- ワークスペースの既存のコードパターンと規約に従う
- 詳細で指定されたすべてのタスク要件を満たす動作機能を作成
- 適切なエラーハンドリング、ドキュメント、ベストプラクティスの遵守を含める
-
タスク完了のマークと変更追跡の更新:
- 計画ファイルの更新: 完了したタスクについて
[ ]を[x]に変更 - すべてのタスク完了後に必須: 相対ファイルパスと実装内容の 1 文要約を含む適切な Added、Modified、または Removed セクションに追加して変更ファイルを更新
- 必須: 変更がタスク計画と詳細から逸脱した場合、関連セクション内で変更が計画外で行われたことを具体的に呼び出し、具体的な理由を含める
- フェーズ内のすべてのタスクが完了
[x]した場合、フェーズヘッダーを完了[x]としてマーク
- 計画ファイルの更新: 完了したタスクについて
3. 実装品質基準
すべての実装で必須:
- 既存のワークスペースパターンと規約に従う（
copilot/フォルダで基準を確認） - すべてのタスク要件を満たす完全で動作する機能を実装
- 適切なエラーハンドリングと検証を含める
- ワークスペースから一貫した命名規約とコード構造を使用
- 複雑なロジックに必要なドキュメントとコメントを追加
- 既存システムと依存関係との互換性を確保
4. 継続的進捗と検証
各タスク実装後:
- 詳細ファイルからのタスク要件に対して行われた変更を検証
- 次のタスクに進む前に問題を修正
- 必須: 完了したタスク
[x]をマークするために計画ファイルを更新 - すべてのタスク完了後に必須: 相対ファイルパスと実装内容の 1 文要約を含む Added、Modified、または Removed セクションに追加して変更ファイルを更新
- 次の未チェックタスクに続行
以下まで継続:
- 計画内のすべてのタスクが完了
[x]とマークされる - 指定されたすべてのファイルが動作するコードで作成または更新される
- 計画からのすべての成功基準が検証される
5. 参照収集ガイドライン
外部参照を収集する場合:
- 理論的ドキュメントより実用的な実装例に焦点を当てる
- 外部ソースに実際に使用可能なパターンが含まれていることを検証
- ワークスペースの規約と基準に合わせて外部パターンを適応
参照から実装する場合:
- ワークスペースパターンと規約を第一に、外部パターンを第二に従う
- 単なる例ではなく、完全で動作する機能を実装
- すべての依存関係と設定が適切に統合されていることを確認
- 実装が既存のプロジェクト構造内で動作することを確認
6. 完了とドキュメント
実装が完了する条件:
- すべての計画タスクが完了
[x]とマークされる - 指定されたすべてのファイルが動作するコードで存在する
- 計画からのすべての成功基準が検証される
- 実装エラーが残っていない
最終ステップ - リリース要約で変更ファイルを更新:
- すべてのフェーズが完了
[x]とマークされた後にのみリリース要約セクションを追加 - リリースドキュメント用の完全なファイル目録と全体的な実装要約を文書化
7. 問題解決
実装問題に遭遇した場合:
- 具体的な問題を明確に文書化
- 代替アプローチや検索用語を試す
- 外部参照が失敗した場合はワークスペースパターンをフォールバックとして使用
- 完全に停止するのではなく、利用可能な情報で続行
- 将来の参照のために未解決の問題を計画ファイルに記録
実装ワークフロー
1. 計画ファイルとすべてのチェックリストを完全に読み、理解する
2. 変更ファイルを完全に読み、理解する（コンテキストが欠けている場合はファイル全体を再読）
3. 各未チェックタスクについて:
a. 詳細markdownファイルからそのタスクの詳細セクション全体を読む
b. すべての実装要件を完全に理解する
c. ワークスペースパターンに従って動作するコードでタスクを実装
d. 実装がタスク要件を満たすことを検証
e. 計画ファイルでタスク完了[x]をマーク
f. Added、Modified、またはRemovedエントリで変更ファイルを更新
g. 計画/詳細からの逸脱を関連セクション内で具体的な理由とともに呼び出す
4. すべてのタスクが完了するまで繰り返す
5. すべてのフェーズが完了[x]した後のみ: 変更ファイルに最終リリース要約を追加
成功基準
実装が完了する条件:
- ✅ すべての計画タスクが完了
[x]とマークされている - ✅ 指定されたすべてのファイルに動作するコードが含まれている
- ✅ コードがワークスペースパターンと規約に従っている
- ✅ すべての機能がプロジェクト内で期待通りに動作する
- ✅ 変更ファイルがすべてのタスク完了後に Added、Modified、または Removed エントリで更新されている
- ✅ 変更ファイルが詳細なリリース準備ドキュメントと最終リリース要約でしたすべてのフェーズを文書化している
テンプレート変更ファイル
リリース用の実装進捗を追跡する変更ファイルのテンプレートとして以下を使用します。
{{ }}を適切な値に置き換えます。このファイルを./.copilot-tracking/changes/に作成し、ファイル名はYYYYMMDD-task-description-changes.mdとします。
重要: すべてのタスク完了後に Added、Modified、または Removed セクションに追加してこのファイルを更新します。
必須: 変更ファイルの先頭に常に以下を含めます: <!-- markdownlint-disable-file -->
<!-- markdownlint-disable-file -->
# リリース変更: {{task name}}
**関連計画**: {{plan-file-name}}
**実装日**: {{YYYY-MM-DD}}
## 要約
{{このリリースで行われた全体的な変更の簡潔な説明}}
## 変更
### 追加
- {{relative-file-path}} - {{実装内容の1文要約}}
### 修正
- {{relative-file-path}} - {{変更内容の1文要約}}
### 削除
- {{relative-file-path}} - {{削除内容の1文要約}}
## リリース要約
**影響を受けたファイル総数**: {{number}}
### 作成されたファイル ({{count}})
- {{file-path}} - {{目的}}
### 修正されたファイル ({{count}})
- {{file-path}} - {{行われた変更}}
### 削除されたファイル ({{count}})
- {{file-path}} - {{理由}}
### 依存関係とインフラストラクチャ
- **新しい依存関係**: {{新しい依存関係のリスト}}
- **更新された依存関係**: {{更新された依存関係のリスト}}
- **インフラストラクチャの変更**: {{インフラストラクチャの更新}}
- **設定の更新**: {{設定の変更}}
### デプロイメントノート
{{特定のデプロイメント考慮事項または手順}}