命令速查

OpenFlow 的命令负责推进正式工作流，Skill 负责在合适时机增强 AI 的协作能力。命令通常以 / 开头，在 OpenCode 中直接输入；Skill 可以由 AI 自动调用，也可以在支持的客户端中按名称调用。

工作流概览

命令列表

命令	类型	说明	用法
/openflow-init	命令	初始化项目，生成 AGENTS.md	/openflow-init
/openflow-feature	命令	创建需求设计	/openflow-feature 添加用户资料页
/openflow-writing-plan	命令	生成开发计划	/openflow-writing-plan 用户资料页
/openflow-implement	命令	执行开发计划	/openflow-implement 用户资料页
/openflow-archive	命令	归档完成的需求	/openflow-archive 用户资料页
/openflow-change	命令	需求中途变更	/openflow-change 用户资料页 "把头像改成方形裁剪"
/openflow-status	命令	查看活跃需求状态	/openflow-status
/openflow-config	命令	查看/更新配置	/openflow-config
/openflow-migrate-docs	命令	迁移已有文档	/openflow-migrate-docs
openflow-brainstorm	Skill	头脑风暴（自然语言或按名调用）	openflow-brainstorm
openflow-quality-gate	Skill	质量门（AI 自动调用）	AI 在实现后自动调用
openflow-tdd	Skill	TDD 指导（AI 自动调用）	AI 在计划或实现阶段自动调用
openflow-harden	Skill	代码加固审查	openflow-harden

详细说明

/openflow-init

初始化项目，让 AI 知道如何读取 OpenFlow 文档结构。

/openflow-init

它通常会生成或刷新 AGENTS.md，写入 docs/current/、docs/decisions/、docs/changes/、docs/archive/ 等目录的使用规则。

/openflow-feature

创建一个需求设计，用于把模糊想法变成可实施的正式文档。

/openflow-feature 添加用户资料页

AI 会先读取当前有效事实和架构决策，再通过对话澄清目标、非目标、约束、验收标准和设计边界。输出通常位于 docs/changes/YYYY-MM-DD-{feature}/，用于承接后续计划与实现。

/openflow-writing-plan

根据已确认的需求文档生成开发计划。

/openflow-writing-plan 用户资料页

计划会把工作拆成可执行任务，标明目标文件、依赖关系、验证方式和执行约束。启用 TDD 时，计划阶段会加入测试优先或测试补强要求。更多测试相关能力可参考 TDD。

/openflow-implement

执行开发计划，并把计划中的任务交给合适的实现流程。

/openflow-implement 用户资料页

OpenFlow 会创建实现运行记录，传递约束包，并在实现完成后触发质量验证。若项目集成 OMO，执行流程可路由到对应的构建代理；否则使用 OpenCode 原生能力完成实现。

/openflow-archive

归档已完成并通过验证的需求。

/openflow-archive 用户资料页

归档会把变更工作区中的文档冻结到 docs/archive/，并根据配置把仍然有效的事实提升到 docs/current/。归档时还会合并 Git Worktree 中的代码变更到主分支。

/openflow-change

需求中途变更，在不丢失已有上下文的情况下调整范围。

/openflow-change 用户资料页 "把头像改成方形裁剪，同时增加昵称字段"

要求先更新设计文档，再改代码。已归档的需求不能变更。详情见需求变更。

/openflow-status

查看当前活跃需求、计划、实现运行和可能存在的待处理事项。

/openflow-status

当你不确定项目中有哪些未归档工作，或需要接手他人未完成的需求时，优先使用这个命令。

/openflow-config

查看或更新 OpenFlow 配置。

/openflow-config

配置来源包括项目根目录的 openflow.json、openflow.jsonc，以及 opencode.json 中的 openflow 键。完整字段请查看配置项参考。

/openflow-migrate-docs

迁移已有文档，把旧资料重组为 OpenFlow 文档结构。

/openflow-migrate-docs

AI 会读取现有文档，将当前有效事实放入 docs/current/，将长期决策放入 docs/decisions/，将历史资料放入 docs/archive/。迁移只处理文档结构，不修改业务代码。详情见迁移已有文档。

openflow-brainstorm

用于正式需求之前的头脑风暴。

/openflow-brainstorm 我觉得用户反馈系统不太好，但不确定是改流程、改界面、还是加个新功能。

它适合需求还不清晰、方案需要比较、范围需要拆分的阶段。头脑风暴不直接写入正式需求文档，而是帮助整理问题、约束、备选方案和非目标。讨论成熟后，可进入 /openflow-feature。

openflow-quality-gate

质量门 Skill，通常由 AI 在实现完成后自动调用。

它会检查变更是否需要验证、验证证据是否充分、文档是否需要同步、风险是否需要升级审查，并输出是否可以交付。用户通常不需要手动调用它。

openflow-tdd

TDD 指导 Skill，通常由 AI 在计划或核心逻辑实现阶段自动调用。

它会根据任务复杂度决定是否在关键节点要求先写测试。OpenFlow 不做全量 TDD，只在算法、数据模型、业务规则、状态机等核心节点注入测试要求。详情见TDD。

openflow-harden

代码加固审查 Skill，用严格审查者视角检查方案与实现。

openflow-harden

它适合高风险变更、安全敏感代码、复杂边界条件或质量门要求升级审查的场景。审查会围绕行为违规、规格违规、意图偏差、契约分歧、回归风险、证据缺失六个维度展开。详情见代码加固。