| name | flowpilot-verify |
| description | 对照验收标准逐条判定与收尾报告。Verify acceptance criteria (subagent judgment) and produce the finish report. |
Lite 模式(无 flowpilot MCP server 时)
本技能优先通过 MCP 工具(goal_card/plan/skills_inventory/session_log/verify/flow_config)操作状态;当会话中这些工具不可用时,进入以下 Lite 规程:
- 读状态:直接读目标项目
.flow/config.json、.flow/goal.json、.flow/plan.json(JSON 信封 {format_version:1, data:...},data 字段结构与 MCP 工具返回一致)。session 日志 Lite 下省略(无滚动/LATEST 视图),进度记录在会话内维护。
- 写状态:按同名文件模板全量重写(保持信封与字段结构不变;先读后写;三个文件 Lite 自己创建与维护)。
- 自我约束(无服务端强制,违反即状态损坏):任务流转表 pending→doing、doing→done/failed/cancelled、failed→doing/cancelled、done/cancelled 终态;任务置 done 前其 acceptance_ids 对应标准必须全部 status=passed;已 passed 的判定不可重判。
- 完整版状态检测:
.flow/skills-index.json 存在即完整版管理 → 只读展示,不写入,提示用户安装完整版插件。
- 角色路径:Lite 下角色文件位于本技能目录
roles/<slug>.md。
- 能力差距:无并发锁/原子写/强制校验——同一项目单会话推进,勿多会话同时写 .flow/。
本节优先于正文「降级(MCP 不可用)」节:Lite 下按本节直读直写三文件,正文降级节不适用。
flowpilot-verify:判定与收尾
判定(llm 类标准)
- 以子代理(无执行历史、干净上下文)逐条判定 llm 标准:结论 + 引用具体证据(文件/输出片段),不得凭印象。
- 登记结果:verify op=check(judged_by=subagent)。
- 已 passed 的标准不重判(server 拒绝);确需重判先向用户说明,经 goal_card op=update 修订标准后重新判定。
收尾(/flow:finish)
- verify op=report:
- all_passed=true → goal_card op=achieve;输出完成报告(目标、每条 AC 判定与证据、任务清单、关键决策摘自 session_log);附
.flow/backlog.json 条目提醒(存在时)——报告末尾列出各条目请用户决定转新目标或丢弃
- all_passed=false → 列出未过项与 warnings(未覆盖标准),回到 flowpilot-plan 补任务或修订标准
- session_log op=append(kind=decision,收尾结论)。
- 经验沉淀(仅在 all_passed=true 完成收尾时执行;未过收尾不写入,防重复追加):从本项目提炼 3-5 条可跨项目复用的经验,追加写入用户级
~/.flowpilot/learnings.md(每条一行,格式 - [YYYY-MM-DD] 项目类型: 经验一句,日期取当天;只写可泛化结论,不含敏感路径/密钥/项目机密;目录不存在则创建)。文件超 200 条或 64KB 时,先提示用户归档裁剪(保留最近条目+手动精选)再继续追加。
环境失败
机械项命令跑不起来(依赖缺失等)→ verify op=check result=env_failed,不计任务失败;修复环境后重跑。