用途:flow-next 的一个技能,将 flow-next 中已收集的规格、任务摘要与证据提交、记忆条目、术语表变更、策略对齐、延后审查发现和 git diff 等输入,拼装为结构化的 PR 正文,再通过 gh 创建 PR。其理念是“PR 正文即认知辅助”,让评审者先决定关注点,再看 diff。
主要能力:宿主代理(Claude Code / Codex / Droid)读取 flowctl spec export-cognitive-aid 输出的结构化 JSON 载荷,合成正文。正文包含 TL;DR、R-ID 覆盖表、关键变更、决策、遗留记忆、术语表/策略说明、开放项、查看位置和页脚。正文中每条陈述都必须可追溯到结构化字段;禁止编造文件路径、提交 SHA、R-ID 归属或“为什么”理由,数据缺失时如实说明。--no-mermaid 可跳过图示生成;--memory 在 PR 创建后写入 knowledge/architecture-patterns/ 记忆条目(幂等);--dry-run 只将正文输出到 stdout,不推送;--base 覆盖基线分支检测。Ralph 模式下跳过交互预览、强制草稿并输出 PR URL。
使用方式:以 /flow-next:make-pr 触发,可带可选 spec id 与标志。流程按 pre-flight、收集输入、渲染正文、mermaid 生成、推送并创建 PR、输出页脚等阶段执行。Phase 4 预览是交互模式下唯一强制用户确认点,需用户选择 create / dry-run / edit-body / abort。
限制:flowctl 为随附脚本而非全局安装,需使用 FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"。正文不得引用原始 diff 内容;不调用 gh pr merge;gh 缺失或未认证时提示安装/登录后退出,不采用手动推送回退。--dry-run 下不推送、不创建 PR。详细阶段执行见 workflow.md,检查清单见 phases.md,mermaid 规则见 mermaid-rules.md。
备注:资料未提供收费、价格、平台或效果等信息。