开发工具CLIAI 应用【免费下载链接】zcfZero-Config Code Flow for Claude code Codex项目地址https://gitcode.com/gh_mirrors/zc/zcf点击查看免费下载ZCFZero-Config Code Flow通过MCP 服务 工作流模板Skill的组合为 Claude Code 与 Codex 提供了一套可落地的标准化开发流程。本文以 docs/zh-CN/workflows/index.md 为主线系统梳理 ZCF 预置的六阶段工作流、功能开发工作流、BMad 敏捷流程、Spec 工作流集成与 Git 智能命令的定位、调用方式与底层实现帮助读者快速上手并理解这些工作流在仓库中的真实装配方式。工作流全景五套预置流程一览ZCF 将工作流以「配置项」的形式集中声明在 src/config/workflows.ts 的WORKFLOW_CONFIG_BASE中每套工作流都由skillsSkill 指令文件与可选的agents代理文件组合而成。以下为五套预置工作流的定位总览工作流适用场景关键特性底层配置 IDZCF 六阶段工作流通用开发任务六阶段闭环、自动质量把关、交互式确认sixStepsWorkflow功能开发工作流新功能设计与实现规划 UI/UX 代理联动featPlanUxBMad 敏捷流程大型项目敏捷迭代多阶段仪式管理bmadWorkflowSpec 工作流集成需求文档与规范生成Spec MCP 联动MCP 服务spec-workflowGit 智能命令Git 操作自动化提交、回滚、清理、worktreegitWorkflow从源码结构看src/types/workflow.ts 定义了WorkflowTypecommonTools/sixStepsWorkflow/featPlanUx/bmadWorkflow/gitWorkflow与WorkflowConfig接口其中autoInstallAgents字段控制是否自动复制配套代理。除上述五套流程外还有一套默认开启的commonTools项目初始化init-project其随附的init-architect与get-current-datetime两个代理见 templates/claude-code/zh-CN/workflow/common/agents为六阶段工作流的时间戳与文档生成提供基础能力。测试用例 tests/config/workflows.test.ts 验证了各工作流的order、skills与agents配置可作为理解装配关系的权威参考。不同工具下的 Skill 调用方式工作流模板的调用格式因宿主工具而异这是最容易踩坑的环节Claude Code/skill-name在 Claude Code 中直接以/前缀触发/workflow—— 六阶段工作流/feat—— 功能开发工作流/git-commit—— Git 提交命令/init-project—— 项目初始化Codex/prompts:前缀在 Codex 中必须使用/prompts:前缀这是 Codex 的调用格式规范/prompts:workflow—— 六阶段工作流/prompts:git-commit—— Git 提交命令/prompts:git-rollback—— Git 回滚命令/prompts:git-cleanBranches—— 清理已合并分支/prompts:git-worktree—— Git 工作树管理⚠️注意Codex 目前仅支持六阶段工作流和 Git 工作流。功能开发工作流feat、项目初始化init-project和 BMad 工作流暂未在 Codex 中提供。这一点在 docs/zh-CN/features/workflows.md 中同样有明确标注sixStepsWorkflow与gitWorkflow在 Claude Code、Codex 两栏均为 ✅其余为 ❌。调用格式差异的根源在于工作流被实现为 Skill 而非普通命令Skill 文件如 templates/skills/zh-CN/workflow/SKILL.md以namedescription的 front-matter 声明安装时由 src/utils/workflow-installer.ts 将templates/skills/lang/skillName/SKILL.md复制到全局技能目录Claude Code 与 Codex 各自按自己的前缀约定读取。ZCF 六阶段工作流核心六阶段工作流是 ZCF 的核心开发流程覆盖完整软件开发生命周期研究 → 构思 → 计划 → 执行 → 优化 → 评审。其完整定义位于 templates/skills/zh-CN/workflow/SKILL.md文档层介绍见 docs/zh-CN/workflows/zcf-workflow.md。功能特点结构化流程每个阶段都有明确的输入/输出与 AI 行为规范强制确认机制每个阶段完成后需要用户确认避免遗漏用户反馈自动文档生成自动生成计划文档并要求保存在项目目录迭代支持支持多轮迭代和持续改进六阶段详解阶段目标AI 核心行为主要输出1. 研究Research深入理解任务需求和背景分析任务上下文、收集技术资料、识别风险需求分析报告、技术调研、风险评估2. 构思Ideate生成多个可行解决方案提出多个设计方案、评估优缺点、推荐最佳方案方案对比分析、推荐方案及理由3. 计划Plan制定详细实施计划任务拆解、技术选型、时间估算、识别依赖任务分解、技术方案、开发计划4. 执行Execute按计划实施开发逐步实现功能、编写代码与测试、保持代码质量实现代码、测试用例、相关文档5. 优化Optimize提升代码质量与性能代码重构、性能建议、安全检查、规范审查优化后代码、改进建议、安全审查报告6. 评审Review最终评估和总结全面审查结果、生成测试报告、总结教训实现总结、测试报告、改进建议从 Skill 模板的细节看工作流在运行时由 AI 以[模式X]标签标记当前阶段且研究阶段会对需求做0-10 分的完整性评分目标明确性 0-3、预期结果 0-3、边界范围 0-2、约束条件 0-29-10 分直接进入下一阶段7-8 分建议补充细节低于 7 分必须主动提出补充问题见 templates/skills/zh-CN/workflow/SKILL.md。这是文档层面未展开的「质量把关」机制属于工作流内置的硬性行为规范。使用方法与执行流程# Claude Code /workflow 实现用户登录功能支持邮箱和手机号登录 # Codex /prompts:workflow 实现用户登录功能支持邮箱和手机号登录基本执行流程为触发 skill 并描述任务 → AI 按顺序执行六个阶段 → 每个阶段完成后等待用户确认 → 确认后进入下一阶段 → 计划文档自动保存到项目目录。计划文档的保存与归档工作流会自动生成计划文档并要求保存到统一的.zcf/plan/目录无论使用 Claude Code 还是 Codex 都相同项目根目录/ └── .zcf/ └── plan/ ├── current/ # 当前进行中的任务 │ └── 任务名.md # 执行计划和上下文 └── history/ # 已完成的历史任务 └── [完成时间]任务名.md # 归档的任务记录命名规则进行中任务名.md例如用户登录功能.md归档后[完成时间]任务名.md例如2024-01-15_143052用户登录功能.md时间格式为YYYY-MM-DD_HHMMSS。Skill 模板明确要求任何需要当前时间戳的场景必须通过 bash 命令如date %Y-%m-%d %H:%M:%S获取禁止猜测或编造时间。任务完全结束后计划文件从current/自动移动到history/并重命名归档。建议将.zcf/plan/纳入 Git 版本控制。组合使用建议# 1. 使用功能开发工作流规划功能 /feat 用户评论功能 # 2. 使用六阶段工作流实现细节 /workflow 实现评论的 CRUD 操作和权限控制 # 3. 使用 Git 工作流提交代码 /git-commit对于复杂任务建议先拆分再分别执行例如「构建用户管理系统」拆分为注册、登录、信息管理三个子任务在开始工作流前可先运行/init-projectClaude Code生成项目上下文文档——Claude Code 会生成CLAUDE.mdCodex 会生成AGENTS.md这些文档为工作流提供项目上下文。功能开发工作流/feat功能开发工作流面向新功能设计与实现预置了专业的Planner规划师与UI/UX DesignerUI/UX 设计师代理代理模板见 templates/claude-code/zh-CN/workflow/plan/agents帮助系统化完成从需求分析到实施计划的完整流程。目前仅在 Claude Code 中提供/feat 实现用户评论功能支持点赞、回复和删除核心特点需求驱动从需求分析开始确保功能符合用户期望多方案设计生成多个可行方案并评估优劣UI/UX 支持提供专业的 UI/UX 设计建议详细计划输出可执行的任务分解和实施计划专业代理内置规划师和 UI/UX 设计师代理四个核心阶段需求确认分析功能描述与业务场景识别功能范围与边界输出功能需求文档、用户故事、验收标准、成功指标方案规划提出 2-3 个不同技术方案评估复杂度、可扩展性、维护性推荐最适合方案UI/UX 支撑设计用户界面布局、交互流程生成线框图描述、界面文案与响应式设计考虑实施计划拆解具体开发任务确定技术实现细节、开发顺序与依赖关系估算工作量提供测试策略在实施计划阶段AI 会输出带时间估算的任务列表例如创建数据模型 2 小时、实现 API 接口 4 小时、开发前端组件 3 小时、编写测试用例 2 小时等。Skill 模板的三类输入处理机制从 templates/skills/zh-CN/feat/SKILL.md 可以还原出比文档更细的运行机制每次收到输入AI 必须首先判断并明确告知类型——需求规划类型新功能需求 → 启用 Planner Agent生成 markdown 规划文档存储至./.claude/plan目录按plan/xxx.md命名讨论迭代类型要求修改规划 → 检索上次规划文件新建迭代文档如plan/xxx-1.md、plan/xxx-2.md依次递增执行实施类型确认规划完成 → 按规划文档顺序启动任务执行前端任务若无 UI 设计方案必须调用 UI-UX-Designer Agent完成设计后再开发最佳实践需求描述要清晰如「实现用户评论功能支持文本、图片、点赞、回复、删除管理员可以审核和删除任何评论」明显优于「评论功能」结合项目上下文先/init-project再/feat 功能描述确保设计与整体架构一致规划完成后执行用/feat规划用/workflow实施用/git-commit提交形成完整闭环持续迭代第一轮整体规划 → 第二轮细化子功能 → 第三轮优化增强三套规划类工作流的定位差异可对照下表/feat侧重「规划」/workflow侧重「实施」/bmad-init侧重「企业级团队协作」。BMad 敏捷流程/bmad-initBMadBuild-Measure-Analyze-Decision工作流适合大型项目的结构化迭代其 Method 是一个企业级 AI 驱动的敏捷开发框架通过结构化的 Build → Measure → Analyze → Decision 循环将复杂开发任务分解为可管理的迭代周期。使用方式# Claude CodeCodex 暂不支持 /bmad-init核心能力一次性导入完整工作流执行/bmad-init后导入所有 BMad 指令集和文档模板、创建完整项目结构、生成初始配置文件、设置 AI 代理团队迭代生命周期管理覆盖迭代计划 → 执行开发 → 验收测试 → 复盘总结专业 AI 代理团队PO产品负责人、PM项目经理、架构师、开发工程师、QA 测试等角色项目类型支持Greenfield全新项目引导创建 PRD、设计架构、生成用户故事与 Brownfield现有项目分析现有代码、生成架构文档、创建功能增强计划文档模板系统自动生成 PRD、架构文档、用户故事、技术规范、测试计划底层实现基于 bmad-method 的安装器从 templates/skills/zh-CN/bmad-init/SKILL.md 的完整实现脚本可以看出/bmad-init实际封装了npx bmad-method install新安装npx bmad-method install --directory . --modules bmm --tools claude-code --communication-language Chinese --document-output-language Chinese --yes已安装V6npx bmad-method install --directory . --action quick-update --yes旧版迁移检测.bmad-core/或.bmad-method/V4 旧版目录由 V6 安装器自动处理Bug 修复将安装器产生的{output_folder}重命名为_bmad-outputv6.0.0-Beta.8 已知问题自动更新.gitignore移除 V4 旧条目.bmad-core、.bmad-method等添加 V6 新条目_bmad/、_bmad-output/安装完成后需重启 AI IDE 以加载 BMad 扩展随后可通过/bmad-help、/bmad-bmm-create-prd、/bmad-bmm-create-architecture、/bmad-bmm-sprint-planning、/bmad-bmm-dev-story等命令驱动完整流程。BMad 初始化后的项目结构V6以_bmad/agents、workflows、tasks 与配置和_bmad-output/生成的工件输出目录为核心而非旧版文档描述的.bmad-core/布局读者应以当前仓库实现为准。故障排查参考初始化失败确认在项目根目录pwd、检查~/.claude/skills/bmad/是否存在、可尝试npx zcf update -w bmadWorkflow重新安装文档未生成检查项目写入权限、查看生成的PRD.md/ARCHITECTURE.md重新执行/bmad-init会合并更新而不覆盖已有内容代理团队异常检查~/.claude/skills/bmad/bmad-init.md与~/.claude/settings.json中的mcpServers配置Spec 工作流集成Spec Workflow MCPSpec 工作流是一个基于 Model Context Protocol (MCP) 的服务提供从需求到实现的结构化特性开发流程涵盖需求分析、设计阶段、任务管理、实施工作流、交互式仪表板与审批系统。安装与配置Spec 工作流作为 MCP 服务集成在 ZCF 中可通过npx zcf init完整初始化时选择安装或在已有环境中通过npx zcf→ 选择「配置 MCP」添加spec-workflow。该服务已在 src/config/mcp-services.ts 中预置id: spec-workflow无需 API Key其配置与文档描述一致// ~/.claude/settings.jsonClaude Code { mcpServers: { spec-workflow: { command: npx, args: [-y, pimzino/spec-workflow-mcplatest] } } }# ~/.codex/config.tomlCodex [mcp_server.spec-workflow] command npx args [-y, pimzino/spec-workflow-mcplatest]也可手动安装npm install -g pimzino/spec-workflow-mcplatest或npx -y pimzino/spec-workflow-mcplatest。核心功能需求分析结构化需求收集、自动生成标准化的需求规格说明文档、检查需求完整性/一致性/可测试性设计阶段技术方案设计、架构设计、API 接口与数据模型定义、数据库表结构设计任务管理自动任务拆解、优先级评估、实时进度跟踪、依赖关系管理实施工作流基于设计文档生成初始代码、自动生成测试用例、文档同步、代码质量检查仪表板与 VS Code 扩展启动仪表板npx -y pimzino/spec-workflow-mcplatest --dashboard在默认浏览器打开提供工作流可视化、任务列表、进度统计、搜索筛选端口冲突时可用--dashboard --port 3001指定端口VS Code 扩展在扩展市场搜索 Spec Workflow MCP 安装提供侧边栏集成、任务状态通知、编辑器内快速操作典型八阶段与使用示例Spec 工作流通常包含需求收集 → 需求验证 → 方案设计 → 任务拆解 → 实施开发 → 测试验证 → 文档更新 → 评审验收。以「用户评论」功能为例请使用 Spec 工作流分析用户评论功能的需求 基于刚才的需求请设计评论功能的技术方案包括数据模型和 API 接口 将评论功能拆解为具体的开发任务并列出任务依赖关系 请按照任务列表开始实现评论功能的第一个任务注意在 Codex 中 Spec 工作流虽可作为 MCP 服务使用但没有对应的/prompts:命令需要直接在对话中使用。Spec 工作流生成的文档建议统一存放于.spec-workflow/{requirements,design,tasks}目录并纳入 Git 版本控制。Git 智能命令Git 工作流提供一系列智能 Git 操作命令简化版本控制流程四个命令在 Claude Code 与 Codex 中均可使用命令Claude CodeCodex说明智能提交/git-commit/prompts:git-commit智能生成提交信息并拆分提交安全回滚/git-rollback/prompts:git-rollback安全回滚到指定提交清理分支/git-cleanBranches/prompts:git-cleanBranches清理已合并分支工作树管理/git-worktree/prompts:git-worktree管理 Git Worktree支持创建、迁移、删除/git-commit智能提交仅依赖 Git不调用任何包管理器/构建工具自动分析 staged/unstaged 改动、按关注点/文件模式/改动类型聚类判断是否拆分提交、生成符合 Conventional Commits 规范的提交信息。支持可选 emoji默认运行本地 Git 钩子可用--no-verify跳过。主要选项详见 templates/skills/zh-CN/git-commit/SKILL.md--no-verify跳过本地 Git 钩子pre-commit/commit-msg等--all暂存区为空时自动git add -A--amend修补上一次提交保持作者与时间--signoff附加Signed-off-by行DCO 流程--emoji提交信息包含 emoji 前缀--scope scope指定提交作用域如ui、docs、api--type type强制提交类型feat、fix、docs等覆盖自动判断提交信息规范首行[emoji] type(scope)?: subject≤72 字符祈使语气正文必须使用动词开头的祈使句并以-列表呈现破坏性变更需包含BREAKING CHANGE:脚注或feat!:感叹号。diff 规模超过约 300 行或跨多个顶级目录时会建议拆分提交。/git-rollback安全回滚交互式回滚流程同步远端git fetch --all --prune→ 列出分支git branch -a过滤保护分支→ 列出版本git loggit taggit reflog→ 选择reset或revert→ 二次确认 → 执行回滚。安全特性详见 templates/skills/zh-CN/git-rollback/SKILL.md默认--dry-run只预览即将执行的命令防止误操作备份机制执行前在 reflog 中记录当前 HEAD可用git switch -c backup/timestamp恢复保护分支检测到main/master/production等保护分支且使用reset模式时要求额外确认不提供--force强推需手动git push --force-with-lease参数--branch branch、--target revcommit hash / tag / reflog 引用、--mode reset|revert、--depth n默认列出最近 20 个版本、--yes跳过确认适合 CI/CDreset vs revertreset会改变历史、需要强推且可能影响协作者谨慎使用revert生成反向提交保留历史更安全但会增加一次提交记录。/git-cleanBranches清理分支安全识别并清理已合并或长期未更新的分支默认只读预览--base branch指定基准分支默认自动识别main/master--stale days清理超过指定天数未提交的分支--remote同时清理远程分支--dry-run默认行为仅预览不执行--yes跳过逐一确认直接删除适合 CI/CD--force使用-D强制删除未合并分支保护分支配置一次配置永久生效命令自动读取git config --add branch.cleanup.protected develop git config --add branch.cleanup.protected release/* git config --get-all branch.cleanup.protected/git-worktree工作树管理在项目平级的../.zcf/项目名/目录下创建 worktree支持智能默认、IDE 集成和内容迁移。从 templates/skills/zh-CN/git-worktree/SKILL.md 可以看出其核心路径计算逻辑通过git rev-parse --git-common-dir判断是否在现有 worktree 中从主仓库路径推导项目名与WORKTREE_BASE$MAIN_REPO_PATH/../.zcf/$PROJECT_NAME始终使用绝对路径防止在 worktree 内创建嵌套的.zcf/project/.zcf/project/path路径问题环境文件处理扫描主仓库.gitignore自动复制.env、.env.*文件到新 worktree跳过.env.example等模板文件保持权限与时间戳常用操作/git-worktree add feature-ui # 从 main/master 创建新分支 /git-worktree add feature-ui -b my-feature # 指定新分支名 /git-worktree add feature-ui -o # 创建并直接用 IDE 打开 /git-worktree migrate feature-ui --from main # 迁移未提交改动 /git-worktree migrate feature-ui --stash # 迁移 stash 内容 /git-worktree list # 查看所有 worktree /git-worktree remove feature-ui # 删除 worktree /git-worktree prune # 清理无效引用IDE 集成自动检测 VS Code → Cursor → WebStorm → Sublime Text → Vim可通过 git config 自定义git config worktree.ide.custom.sublime subl %s git config worktree.ide.preferred sublime git config worktree.ide.autodetect true # 默认Worktree 共享.git目录节省磁盘空间内容迁移仅限未提交改动已提交内容需使用git cherry-pick。工作流的安装与更新机制了解工作流如何进入你的环境有助于排查与自定义初始化导入zcf init默认导入全部工作流也可通过--workflows参数选择性安装见 docs/zh-CN/cli/init.md更新同步zcf update在模板更新后会再次执行工作流导入确保内容同步安装位置工作流 skills 安装至~/.claude/skills/Claude Code或~/.agents/skills/Codex代理自动安装对于要求代理的工作流如featPlanUxZCF 会同步复制planner.md、ui-ux-designer.md等代理文件到~/.claude/agents/zcf/category/由autoInstallAgents字段控制实现见 src/utils/workflow-installer.ts旧文件清理安装前会自动清理旧版本遗留文件如~/.claude/commands/workflow.md、~/.claude/agents/planner.md等工作流搭配与跨对话衔接来自 docs/zh-CN/workflows/index.md 的使用建议首次使用工作流时可让 AI 输出任务进度文档方便后续在新对话继续完成关键里程碑后请求 AI 生成进度总结方便跨对话衔接搭配 docs/zh-CN/best-practices/worktree.md提升多工作区协作效率与 Git 工作流搭配使用可快速完成「需求拆解 → 编码 → 提交」的闭环常见注意事项小结Codex 支持范围六阶段工作流与 Git 工作流已支持feat、init-project、BMad 暂不支持需用/prompts:workflow六阶段工作流替代前缀规范Claude Code 用/skill-nameCodex 用/prompts:skill-name两者不可混用统一目录.zcf/plan/与.zcf/worktree 管理在不同工具间路径一致确认机制六阶段工作流不建议跳过阶段确认用户反馈可帮助 AI 调整方向跳过可能导致遗漏重要步骤时间戳准确性计划文档命名与归档时间必须通过 bashdate命令获取禁止编造六阶段工作流适合大多数通用开发任务建议先从小的任务开始熟悉流程再逐步应用到复杂项目功能开发与 BMad 流程侧重规划与企业级协作Spec 工作流负责需求规格化Git 工作流补齐提交、回滚、清理与并行工作区管理。五套流程互为补充共同构成 ZCF 的完整开发闭环。赞分享开发工具CLIAI 应用【免费下载链接】zcfZero-Config Code Flow for Claude code Codex项目地址https://gitcode.com/gh_mirrors/zc/zcf点击查看免费下载相关推荐autojump开发工作流模板issue到PR的标准化流程autojump开发工作流模板issue到PR的标准化流程 你是否在参与autojump开源项目时遇到过协作混乱、代码提交不规范、PR审核反复修改的问题本文CLI开发工具DeeplabV3 for PyTorch在自动驾驶中的应用道路与场景分割实战DeeplabV3 for PyTorch在自动驾驶中的应用道路与场景分割实战 DeeplabV3 for PyTorch是一款基于深度学习的图像分割工具特Gumroad 开源仓库 Issue 起草指南基于 create-issue Skill 的标准化工作流Gumroad 开源仓库 Issue 起草指南基于 create issue Skill 的标准化工作流 导读 本指南围绕 Gumroad 开源仓库中面向 A后端前端电商创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考