plan
調査や合意を、レビューできる実装計画へ変えるときに使います。作業手順だけでなく、人間が変更しそうな判断を先頭に置きます。
渡す情報
目的、確定仕様、調査結果、制約、受け入れ条件、未決定事項を渡します。
依頼例
planを使って、依頼一覧の担当者フィルターを追加する計画を作ってください。条件はURLに保存し、未割り当ても選択できます。重要判断、作業順、検証方法を先に確認したいです。
進め方
- 目的と完了条件、データ構造・UX・既存仕様への影響を整理します。
- 実装手順を依存順に並べ、機械的変更を分けます。
- 未決定事項、仮定、レビュー観点を示します。
成果物の例
実際の修正要件と調査結果から作成した計画です。
到達点:実装計画の作成。
移行時の確認:既存の実行記録を移行しました。本文の一致は確認しましたが、過去の実行時の同梱資料全体は特定できていません。
このハッシュは移行時の変更検出用の基準です。同梱資料全体をこの版で再実行した証拠ではありません。
実行した依頼
全スキルの実入力と実出力を保存し、画像と原本をMarkdownから取得できるようにする修正の計画を作ってください。重要判断、UX、既存仕様への影響を先に示してください。
実出力の抜粋
以下は保存した原本の冒頭です。全文は原本から取得できます。
# Implementation Plan
## 1. 重要判断
### 1.1 データモデル・構造
- スキルごとに入力、実出力、検証記録、必要な画面画像を保存する。
- 保存先はdocs/artifacts/examples/<skill-name>。Markdown原本を文書探索から除外する。
### 1.2 型・インターフェース
- 実行記録にはskill、skill_sha256、input、stage、artifacts、checksを持たせる。
- artifactsはファイル名、形式、SHA-256を記録する。実行していない検証をpassにしない。
### 1.3 UX・処理フロー
成果物を取得する
確認した結果
- SKILL.mdを読み、今回の実要件と参照対象へ適用して出力を保存。内容の人間確認は未実施。
確認するポイント
重要判断と作業順のつながり、検証が受け入れ条件を満たすか、未決定事項が残っているかを確認します。
関連するスキル
正本を読む
詳細な手順と制約はplanのSKILL.mdを参照してください。