\r \r

Proflow 项目标准化全流程\r

\r

概述\r

\r 执行团队标准项目流程，覆盖脑暴、计划、执行、标准化文档四个阶段。强制统一目录规范、自动生成唯一需求ID、标准化文件名格式。\r \r

可用命令\r

\r

• proflow full — 一键全自动完整流程（脑暴→计划→执行→文档）\r
• proflow brainstorm — 阶段1：需求脑暴发散\r
• proflow plan — 阶段2：生成执行计划\r
• proflow execute — 阶段3：自动化落地执行\r
• proflow spec — 阶段4：生成全量标准化规格文档\r
• proflow status — 查看当前项目执行状态\r
• proflow reset [stage] — 重置指定阶段状态（支持回退重跑）\r \r

前置准备\r

\r

前置依赖检查（强制）\r

使用本技能前必须确保已安装：\r

1. openspec 技能\r
2. superpowers 技能\r 任一缺失将直接提示并退出，不执行后续逻辑。\r \r

初始化步骤（强制）\r

执行任何阶段命令前，运行以下初始化步骤：\r \r

1. 解析需求ID：\r
   • 优先读取用户传入的 --id 参数\r
   • 其次尝试从提示词中提取需求编号（如 2345、25 等格式）\r
   • 若以上均未获取到，使用当前时间的 hhmmss（6位数字，如 143052）作为唯一编号\r
   • 使用 scripts/id_manager.py 扫描 docs/ 目录校验全局唯一性，自动去重（不再限制数值大小）\r
2. 功能规模判断：\r
   • 根据用户提示词智能判断功能规模，分为四类：fix、小功能、中等功能、大功能\r
   • 判断规则（优先级从高到低）：\r
     • 提示词中明确出现 "fix"、"bugfix"、"修复" → 判定为 fix\r
     • 提示词中涉及 "字段修改"、"表结构变更"、"数据库迁移"、"接口协议变更"、"核心架构调整" → 无论描述长短，强制判定为 大功能，必须按完整步骤执行\r
     • 仅涉及单点改动、文案替换、简单样式调整、单一配置项变更 → 判定为 小功能\r
     • 涉及 2~3 个模块联动、新增中等复杂度页面或接口 → 判定为 中等功能\r
     • 涉及系统级重构、多模块大规模改造、全新功能模块 → 判定为 大功能\r
   • 若判定为 fix 或 小功能，跳过后续所有阶段流程，直接定位代码并进行修改\r
   • 若判定为 中等功能 或 大功能，继续执行以下步骤\r
3. 使用 scripts/file_naming.py 确认文件名格式：cr-{id}-{slug}-{YYYYMMDD}\r
4. 使用 scripts/log_manager.py 初始化日志文件到 docs/logs/\r \r

全流程（full）\r

\r 按顺序执行以下阶段，每个阶段前检查状态标记，已完成的阶段自动跳过：\r \r

1. 脑暴阶段\r

• 检查状态 .opencode/status/proflow/brainstorm.done，如果判断文件夹不存在，请创建并添加gitignore忽略文件.opencode/status/ 目录，并创建 .gitignore 文件忽略该文件夹\r
• 若未完成：调用 superpowers brainstorming skill 梳理项目核心需求与业务边界\r
• 将结果保存到 docs/brainstorm/cr-{id}-brainstorm-{YYYYMMDD}.md\r
• 标记状态完成，并记录日志\r \r

2. 计划阶段\r

• 检查状态 .opencode/status/proflow/plan.done\r
• 若未完成：确保脑暴阶段已完成；调用 superpowers writing-plans skill 生成执行计划\r
• 将结果保存到 docs/plans/cr-{id}-execution-plan-{YYYYMMDD}.md\r
• 标记状态完成，并记录日志\r \r

3. 执行阶段\r

• 检查状态 .opencode/status/proflow/execute.done\r
• 若未完成：确保计划阶段已完成；调用 superpowers executing-plans skill 或 superpowers subagent-driven-development skill 按步骤执行\r
• 将执行记录保存到 docs/execute/cr-{id}-execute-record-{YYYYMMDD}.md\r
• 标记状态完成，并记录日志\r \r

4. 文档阶段\r

• 检查状态 .opencode/status/proflow/spec.done\r
• 若未完成：确保执行阶段已完成\r
• 调用 openspec skill 按需生成项目规格文档：\r
• 依次生成以下文档并保存：\r
  • PRD: docs/spec/prd/cr-{id}-prd-{YYYYMMDD}.md\r
  • 架构设计: docs/spec/architecture/cr-{id}-architecture-{YYYYMMDD}.md\r
  • API 规范: docs/spec/api/cr-{id}-api-spec-{YYYYMMDD}.md（如果是前端功能，不需要生成这个文件）\r
  • 数据库设计: docs/spec/database/cr-{id}-database-design-{YYYYMMDD}.md（如果是前端功能，不需要生成这个文件）\r
• 标记状态完成，并记录日志\r \r

单阶段执行\r

\r

brainstorm\r

执行脑暴阶段并保存结果。流程同上阶段1。\r \r

plan\r

依赖脑暴阶段已完成，生成执行计划并保存。流程同上阶段2。\r \r

execute\r

依赖计划阶段已完成，按步骤执行并记录。流程同上阶段3。\r \r

spec\r

依赖执行阶段已完成，生成全量规格文档。流程同上阶段4。\r \r

辅助命令\r

\r

status\r

运行 scripts/status_manager.py list 查看各阶段完成状态，并显示最新日志摘要。\r \r

reset [stage]\r

运行 scripts/status_manager.py reset [stage] 清除指定阶段的状态标记，记录回退日志。支持的 stage 值：brainstorm、plan、execute、spec。\r \r

输出规范（强制）\r

\r

1. 所有输出自动归档到 docs/brainstorm/、docs/plans/、docs/execute/、docs/spec/、docs/logs/\r
2. 禁止生成 docs/superpowers/ 目录，禁止非标文件名\r
3. 需求ID全局唯一，自动扫描去重，支持 --id 自定义；未指定时默认按 hhmmss 生成\r
4. 文件名强制格式：cr-{id}-{slug}-{YYYYMMDD}.md\r
5. 状态文件禁止手动删除，异常自动触发回退提示与日志记录\r \r

Scripts\r

\r

• scripts/id_manager.py — 文档扫描、ID 生成与去重\r
• scripts/status_manager.py — 状态标记管理\r
• scripts/log_manager.py — 日志记录与查询\r
• scripts/file_naming.py — 标准化文件名生成