fp-implement

FP 実装スキル

課題を見つけ、担当し、完了します。

前提条件

fp コマンドを使う前に、セットアップを確認してください。

# Check if fp is installed
fp --version

fp がインストールされていない場合は、ユーザーに次のように伝えます。

fp CLI がインストールされていません。次のコマンドでインストールしてください。

curl -fsSL https://setup.fp.dev/install.sh | sh -s

# Check if project is initialized
fp tree

プロジェクトが初期化されていない場合は、初期化するかどうかをユーザーに確認します。

このプロジェクトは fp で初期化されていません。初期化しますか？

はいの場合：

fp init

---

基本的なワークフロー

1. Find work     → fp tree, fp issue list --status todo
2. Claim work    → fp issue update --status in-progress <PREFIX>-X
3. Do work       → implement the task
4. Comment often → fp comment <PREFIX>-X "progress update"
5. Complete      → fp issue update --status done <PREFIX>-X

---

作業を探す

全体像を確認する

fp tree

階層、ステータス、依存関係とともに、すべての課題を表示します。

fp tree --status todo

未完了の項目のみを表示します（完了した作業は除外されます）。

fp tree <PREFIX>-X

特定の課題とその子課題を表示します。1つの機能やエピックに集中する際に便利です。

ステータス別に一覧表示する

fp issue list --status todo          # Available to pick up
fp issue list --status in-progress   # Currently active
fp issue list --status done          # Completed
fp issue list                        # All issues

適切なタスクを選ぶ

次の条件に合うタスクを探します。

• ステータスが todo
• 依存関係がない、またはすべての依存関係が done
• 現在の注力分野や専門知識に合っている

---

作業を担当する

進行中にする

fp issue update --status in-progress <PREFIX>-2

変更追跡の開始点として、現在の VCS の状態を記録します。

作業開始を記録する

fp comment <PREFIX>-2 "Starting work. First step: implement the User model schema"

コンテキストを読み込む

fp context <PREFIX>-2

課題の詳細、説明、関連情報を表示します。

---

作業中

こまめにコメントする

重要な節目で進捗を記録します。

fp comment <PREFIX>-2 "Completed schema design. Added User, Session, Token models to src/models/"

fp comment <PREFIX>-2 "Hit a snag: OAuth library doesn't support refresh tokens out of the box. Investigating alternatives."

fp comment <PREFIX>-2 "Resolved: using custom refresh logic. Proceeding with implementation."

コメントするタイミング：

• タスクを開始したとき
• 重要な節目を完了したとき
• 重要な情報を発見したとき
• 問題が発生したとき
• 作業を完了したとき

進捗を確認する

fp issue diff <PREFIX>-2 --stat   # Quick view of changed files
fp issue files <PREFIX>-2         # List files changed
fp issue diff <PREFIX>-2          # Full diff

---

作業を完了する

完了にする

fp issue update --status done <PREFIX>-2

終了点として、現在の VCS の状態を記録します。

完了コメントを追加する

fp comment <PREFIX>-2 "Task completed. Implemented User, Session, and Token models with Drizzle ORM. All tests passing."

---

以前の作業を続ける

進行中の作業を探す

fp issue list --status in-progress

コンテキストを読み込む

fp context <PREFIX>-5

最近のアクティビティを確認する

fp log <PREFIX>-5 --limit 5

変更内容を確認する

fp issue diff <PREFIX>-5 --stat

再開する

fp comment <PREFIX>-5 "Resuming work. Current focus: finishing the error handling logic"

---

作業を分割する

タスクが大きすぎる場合は、分割します。

# Create sub-tasks
fp issue create --title "Part 1: Setup" --parent <PREFIX>-4
fp issue create --title "Part 2: Implementation" --parent <PREFIX>-4 --depends "<PREFIX>-10"
fp issue create --title "Part 3: Tests" --parent <PREFIX>-4 --depends "<PREFIX>-11"

# Document
fp comment <PREFIX>-4 "Broke down into sub-tasks: <PREFIX>-10, <PREFIX>-11, <PREFIX>-12. Working on <PREFIX>-10 first."

# Work on sub-tasks
fp issue update --status in-progress <PREFIX>-10

---

変更を表示する

単一の課題の場合

fp issue diff <PREFIX>-2           # Full diff since task started
fp issue diff <PREFIX>-2 --stat    # Just file stats
fp issue files <PREFIX>-2          # List of changed files

親課題の場合

子課題がある親課題では、次のコマンドで、すべての子孫課題の変更を集約します。

fp issue diff <PREFIX>-1 --stat    # All changes across child tasks
fp issue files <PREFIX>-1          # All files changed by descendants

---

クイックリファレンス

必須コマンド

# Find work
fp tree                              # Full hierarchy
fp tree --status todo                # Only todo items
fp tree <PREFIX>-X                   # Focus on one issue
fp issue list --status todo          # List available tasks

# Claim work
fp issue update --status in-progress <PREFIX>-X
fp context <PREFIX>-X

# Log progress
fp comment <PREFIX>-X "message"

# View changes
fp issue diff <PREFIX>-X --stat
fp issue files <PREFIX>-X

# Complete
fp issue update --status done <PREFIX>-X

# Activity
fp log --limit 10
fp log <PREFIX>-X

ステータスの値

• todo - 未着手
• in-progress - 作業中
• done - 完了

優先度の値（任意）

• critical - 他の作業をブロックしている
• high - 重要。早めに対応する
• medium - 通常の優先度
• low - あるとよい

fp issue update --priority high <PREFIX>-X