Imported from yoshidev523/flow-agent (
.apm/skills/flow-implement/SKILL.md). Install upstream withnpx skills add yoshidev523/flow-agent --skill flow-implement. Copyright stays with the author.
Flow Implement
目的
指定されたplan.mdを実装し、検証結果を
spec/{yyyymmdd_feature}/implement.mdへ記録する。
このskillは与えられたPlanの内容と完全性だけを扱い、Planが渡された経路や上流状態を
検査しない。
入力
plan_pathtarget_path:spec/{yyyymmdd_feature}/implement.md- 実行対象タスク。省略時は未完了の全タスク。
開始前にPlanのschema_version: flow/phase-artifact-v1、artifact: plan、正のrevision、
status: ready、Design入力時のinputsにあるpath、revision、SHA-256、対象ファイル、
手順、完了条件、検証方法、実装引き継ぎチェックを確認する。不足や矛盾がある場合は
実装せず、implement.mdへブロック理由を記録する。
Planのstatusはfront matterの値だけを使用する。承認状態: Pending、Approved、
reviewのpassed、本文の完了表現をreadyの代わりにしない。schemaまたはstatusが
契約外なら、Planを修復・移行せずblockedとして記録する。
出力
- 実装変更: Planで指定されたファイル。
- 進捗記録:
spec/{yyyymmdd_feature}/implement.md。 - schema:
implement-artifact-v1
implement.mdは次の状態を使う。
in_progressblockedcompleted
これ以外の成果物全体の状態や、承認状態などの並行するライフサイクル状態fieldを
追加しない。タスク進捗に記録する個別タスクの状態はこの禁止対象ではない。
ワークフロー
git status --short、AGENTS.md、Plan、関連コードを確認する。implement.mdを作成または読み、未完了タスクを特定する。- Planの依存順に実装し、各タスクの状態と変更ファイルを記録する。
- Plan外の公開API、責務、入出力、エラー挙動、範囲変更が必要なら停止する。
- 指定された検証を実行し、コマンド、結果、未実施理由を記録する。
- 全タスクと必要な検証が完了したら
completedにする。 - 完了報告前にPlan参照と
implement.mdのschema、revision、statusを読み直す。 completedにできた場合は、Planの対象ファイルとimplement.mdに対してgit check-ignore --no-indexを実行し、.gitignoreの対象かを確認する。.gitignore対象はstageやコミットに含めず、git add -fなどで 強制追加しない。対象外のファイルのうち、この実装で生じた変更だけを stageし、コミットする。件名は[flow-implement] {Planを要約した短い命令形}とする。- 開始前からあった変更やPlan外の変更はコミットに含めない。
対象変更を安全に分離できない場合、またはコミットに失敗した場合は
blockedとし、理由をimplement.mdに記録する。
内部変数名、import順、軽微な整形、明白なtypo、既存規約への小さな合わせ込みは、 Planの意味を変えない範囲で実装裁量とする。
implement.md構成
---
schema_version: flow/implement-artifact-v1
artifact: implement
revision: 1
status: in_progress
plan_path: spec/{yyyymmdd_feature}/plan.md
plan_revision: 1
plan_sha256: "{64 lowercase hex}"
updated_at: {timestamp}
---
# 実装記録: {feature}
## メタデータ
- 日付:
- 計画:
## タスク進捗
## 変更サマリ
## 変更履歴
## 検証ログ
## 補足・計画との差分
## 未完了事項初版のrevisionは1とし、進捗、状態、検証結果を更新するたびに1増やす。
Planのpath、revision、SHA-256が現在のPlanと一致しない場合は実装を開始・再開しない。
完了条件
- Planの対象タスクが完了している。
- Plan外の判断を無断で実装していない。
- 変更ファイルと検証結果が
implement.mdに記録されている。 - front matterが
implement-artifact-v1に適合し、statusがin_progress | blocked | completedのいずれかである。 - statusと並行する成果物全体の承認・進捗状態を追加していない。
- 必要な検証が成功、または未実施理由が記録されている。
- 作業後の
git status --shortを確認している。 .gitignore対象を強制追加したり、コミットに含めたりしていない。completedの場合は実装変更が[flow-implement]プレフィックス付きの 件名でコミットされている。- pushとPR作成は明示依頼がある場合だけ行う。
