Proflow 项目标准化全流程
概述
执行团队标准项目流程,覆盖脑暴、计划、执行、标准化文档四个阶段。强制统一目录规范、自动生成唯一需求ID、标准化文件名格式。
可用命令
proflow full — 一键全自动完整流程(脑暴→计划→执行→文档)
proflow brainstorm — 阶段1:需求脑暴发散
proflow plan — 阶段2:生成执行计划
proflow execute — 阶段3:自动化落地执行
proflow spec — 阶段4:生成全量标准化规格文档
proflow status — 查看当前项目执行状态
proflow reset [stage] — 重置指定阶段状态(支持回退重跑)
前置准备
前置依赖检查(强制)
使用本技能前必须确保已安装:
openspec 技能
superpowers 技能
任一缺失将直接提示并退出,不执行后续逻辑。
初始化步骤(强制)
执行任何阶段命令前,运行以下初始化步骤:
解析需求ID:
优先读取用户传入的 --id 参数
其次尝试从提示词中提取需求编号(如 2345、25 等格式)
若以上均未获取到,使用当前时间的 hhmmss(6位数字,如 143052)作为唯一编号
使用 scripts/id_manager.py 扫描 docs/ 目录校验全局唯一性,自动去重(不再限制数值大小)
功能规模判断:
根据用户提示词智能判断功能规模,分为四类:fix、小功能、中等功能、大功能
判断规则(优先级从高到低):
提示词中明确出现 "fix"、"bugfix"、"修复" → 判定为 fix
提示词中涉及 "字段修改"、"表结构变更"、"数据库迁移"、"接口协议变更"、"核心架构调整" → 无论描述长短,强制判定为 大功能,必须按完整步骤执行
仅涉及单点改动、文案替换、简单样式调整、单一配置项变更 → 判定为 小功能
涉及 2~3 个模块联动、新增中等复杂度页面或接口 → 判定为 中等功能
涉及系统级重构、多模块大规模改造、全新功能模块 → 判定为 大功能
若判定为 fix 或 小功能,跳过后续所有阶段流程,直接定位代码并进行修改
若判定为 中等功能 或 大功能,继续执行以下步骤
使用 scripts/file_naming.py 确认文件名格式:cr-{id}-{slug}-{YYYYMMDD}
使用 scripts/log_manager.py 初始化日志文件到 docs/logs/
全流程(full)
按顺序执行以下阶段,每个阶段前检查状态标记,已完成的阶段自动跳过:
检查状态 .opencode/status/proflow/brainstorm.done,如果判断文件夹不存在,请创建并添加gitignore忽略文件.opencode/status/ 目录,并创建 .gitignore 文件忽略该文件夹
若未完成:调用 superpowers brainstorming skill 梳理项目核心需求与业务边界
将结果保存到 docs/brainstorm/cr-{id}-brainstorm-{YYYYMMDD}.md
标记状态完成,并记录日志
检查状态 .opencode/status/proflow/plan.done
若未完成:确保脑暴阶段已完成;调用 superpowers writing-plans skill 生成执行计划
将结果保存到 docs/plans/cr-{id}-execution-plan-{YYYYMMDD}.md
标记状态完成,并记录日志
检查状态 .opencode/status/proflow/execute.done
若未完成:确保计划阶段已完成;调用 superpowers executing-plans skill 或 superpowers subagent-driven-development skill 按步骤执行
将执行记录保存到 docs/execute/cr-{id}-execute-record-{YYYYMMDD}.md
标记状态完成,并记录日志
检查状态 .opencode/status/proflow/spec.done
若未完成:确保执行阶段已完成
调用 openspec skill 按需生成项目规格文档:
依次生成以下文档并保存:
PRD: docs/spec/prd/cr-{id}-prd-{YYYYMMDD}.md
架构设计: docs/spec/architecture/cr-{id}-architecture-{YYYYMMDD}.md
API 规范: docs/spec/api/cr-{id}-api-spec-{YYYYMMDD}.md(如果是前端功能,不需要生成这个文件)
数据库设计: docs/spec/database/cr-{id}-database-design-{YYYYMMDD}.md(如果是前端功能,不需要生成这个文件)
标记状态完成,并记录日志
单阶段执行
brainstorm 执行脑暴阶段并保存结果。流程同上阶段1。
plan 依赖脑暴阶段已完成,生成执行计划并保存。流程同上阶段2。
execute 依赖计划阶段已完成,按步骤执行并记录。流程同上阶段3。
spec 依赖执行阶段已完成,生成全量规格文档。流程同上阶段4。
辅助命令
status 运行 scripts/status_manager.py list 查看各阶段完成状态,并显示最新日志摘要。
reset [stage] 运行 scripts/status_manager.py reset [stage] 清除指定阶段的状态标记,记录回退日志。支持的 stage 值:brainstorm、plan、execute、spec。
输出规范(强制)
所有输出自动归档到 docs/brainstorm/、docs/plans/、docs/execute/、docs/spec/、docs/logs/
禁止生成 docs/superpowers/ 目录,禁止非标文件名
需求ID全局唯一,自动扫描去重,支持 --id 自定义;未指定时默认按 hhmmss 生成
文件名强制格式:cr-{id}-{slug}-{YYYYMMDD}.md
状态文件禁止手动删除,异常自动触发回退提示与日志记录
Scripts
scripts/id_manager.py — 文档扫描、ID 生成与去重
scripts/status_manager.py — 状态标记管理
scripts/log_manager.py — 日志记录与查询
scripts/file_naming.py — 标准化文件名生成