用途:fp-review 用于确保提交正确关联到 issue,并提供代码评审反馈。使用前需检查环境:运行 fp --version 确认 fp CLI 已安装,未安装则执行 curl -fsSL https://setup.fp.dev/install.sh | sh -s;运行 fp tree 检查项目是否初始化,未初始化可执行 fp init。
主要能力:查看某 issue 已关联的提交(fp issue files <PREFIX>-X);用 jj log --limit 20 或 git log --oneline -20 查找提交,用 jj show 或 git show 查看详情;将提交关联到 issue(fp issue assign <PREFIX>-X --rev abc123,def456,或 --reset 重置);查看差异(fp issue diff <PREFIX>-X --stat);留下评论(fp comment <PREFIX>-X "src/api/handler.ts:45-60: ..."),支持 [blocker]、[suggestion]、[nit] 严重级别前缀;在桌面应用中交互式评审(fp review,需安装桌面应用);创建 story 文档(需先执行 fp feature enable experimental_story,再用 fp story create <PREFIX>-X --file story.md)。
使用方式:评审工作流为先检查关联、补全缺失提交、查看差异、再留评论。story 为 markdown 文档,可用 :::diff、:::file、:::chat 指令嵌入代码片段,标题用过去式动词,先讲用户问题再展示差异。
限制:关联提交前需与用户确认;基于 issue 的评审要求该 issue 已关联提交,否则改用 fp review 评审工作副本;桌面应用目前仅完整渲染 :::diff,:::file 的 collapsed 属性与 :::diff 的 hunks 属性会被忽略;每个 issue 仅一个 story,新建会替换旧的。具体收费与平台支持暂未提供。