project-workflow

Project Workflow 是面向 Claude Code 的项目全生命周期自动化技能，通过 9 个集成的斜杠命令串联从创意验证到发布的全过程，官方说明其可节省每个项目生命周期约 45–70 分钟。

一、用途 该技能的核心用途是把项目从想法到发布的各个阶段标准化：创意探索与验证、项目规划、新功能规划、会话收尾与恢复、上下文保存、经验沉淀以及发布前安全检查。

二、9 个命令

1. /explore-idea：规划前探索。当想法较粗略、需要验证技术栈、管理范围或先做调研时使用。会创建 PROJECT_BRIEF.md 并移交给 /plan-project，官方称节省 10–15 分钟。
2. /plan-project：生成项目规划文档。适用于需求明确的新项目，或 /explore-idea 之后。创建 IMPLEMENTATION_PHASES.md、SESSION.md，必要时创建 DATABASE_SCHEMA.md、API_ENDPOINTS.md，以及 ARCHITECTURE.md；会调用 project-planning 技能，官方称节省 5–7 分钟。
3. /plan-feature：为已有项目添加功能。适用于已有 SESSION.md 和 IMPLEMENTATION_PHASES.md 的项目；通过 project-planning 技能生成新阶段，重编号后整合进 IMPLEMENTATION_PHASES.md，并更新 SESSION.md，官方称节省 7–10 分钟。
4. /wrap-session：会话结束检查点。当上下文接近上限（超过 150k tokens）、工作会话结束或准备切换任务时使用。由 Task agent 分析会话，更新 SESSION.md（进度、Next Action、阻塞项），执行 git checkpoint 提交，并输出格式化交接摘要，官方称节省 2–3 分钟。
5. /continue-session：会话开始时的上下文加载。开始新会话或 /wrap-session 之后使用。由 Explore agent 加载 SESSION.md 与规划文档，显示 git 历史与会话摘要（阶段、进度、Next Action、阻塞项），可选打开文件，并询问是否继续，官方称节省 1–2 分钟。
6. /workflow：交互式工作流指南。适用于首次使用者、不确定用哪个命令或需要快速参考时；展示全部 9 个命令，提供带决策树的上下文感知引导，并主动提出执行合适命令。
7. /release：发布前安全检查，适用于准备推送到公开 GitHub 或创建发布时。包含 8 个阶段：关键安全（阻断项）如密钥扫描（gitleaks）、个人文件检查、git 远程验证；文档（必需）如 LICENSE、README（>100 词）、CONTRIBUTING.md（>500 行）、CODE_OF_CONDUCT（>1000 行）；配置如 .gitignore、package.json、git 分支警告；质量（非阻断）如构建测试、npm audit、大于 1MB 的大文件检查；报告输出阻断项/警告/建议及是否可安全发布的结论；随后自动修复与发布，包括修复问题、发布准备提交、可选的 git tag 与 GitHub release。官方称节省 10–15 分钟。
8. /brief：上下文保存文档。在清空上下文前使用，为后续会话保留关键决策与需求。会创建 docs/brief-[slug].md，从当前对话提取信息，分析对话内容、提取正在构建的内容、已做决策与技术细节，生成整理好的 markdown 文件，并可选创建 GitHub issue 进行跟踪，官方称节省 3–5 分钟。
9. /reflect：捕获操作知识。适用于上下文压缩前、完成重要工作后或积累到有价值经验时。会回顾对话，识别发现的工作流、学到的模式、工具序列、所做的纠正，将每条学习内容路由到合适位置（rules、CLAUDE.md、skills、docs），并可选建议自动化（脚本、命令、自定义 agent）。关键特性：当某个过程需要推理/决策、受益于并行执行或涉及研究探索时，会考虑将其转为自定义 agent，官方称节省 5–10 分钟。

三、使用方式与典型流程 完整流程：/explore-idea → /plan-project → 执行工作 → /wrap-session → /continue-session → /plan-feature（如需）→ 重复 → /reflect → /release。 快速流程（需求明确）：/plan-project → 执行工作 → /wrap-session → /continue-session → /release。 上下文保存：/brief（清空上下文前）、/reflect（捕获经验）。 辅助命令：/workflow（随时提供引导）、/plan-feature、/release。 安装：插件市场执行 /plugin install project-workflow@jezweb-skills；或手动把 commands/*.md 复制到 ~/.claude/commands/。

四、前置条件与故障排查 所有命令需要 Claude Code CLI，建议有 git 仓库。/plan-feature 需要已有 SESSION.md 与 IMPLEMENTATION_PHASES.md；/wrap-session 与 /continue-session 需要 SESSION.md（由 /plan-project 创建）；/release 需要含提交的 git 仓库、package.json（Node.js）以及远程 URL（用于发布）。常见问题：/plan-project 提示无项目描述时先用 /explore-idea 或先与 Claude 讨论；/plan-feature 提示前置条件未满足时先运行 /plan-project；/wrap-session 提示无 git 仓库时运行 git init；/continue-session 找不到 SESSION.md 时运行 /plan-project；/release 检测到密钥时加入 .gitignore 并从 git 历史中移除。

五、版本信息 1.1.0（2026-01-11）新增 /brief 与 /reflect，/reflect 开始针对需要推理的过程建议自定义 agent，命令总数 9 个。1.0.0（2025-11-12）首次发布，含 7 个集成命令，通过插件市场分发，使用 plugin.json 打包命令。作者 Jeremy Dawes（jeremy@jezweb.net），MIT 许可。

六、限制 该技能主要面向 Claude Code 环境并依赖 git 仓库；上文的“节省时间”均为官方说明，非独立验证。具体命令行为以实际版本为准，本介绍未提供之处（例如确切价格、平台兼容范围等）暂未提供。