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

显示特定问题及其子项，便于专注于某个功能或史诗级任务。

按状态列出

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