project-workflow

项目工作流技能

9 个集成的斜杠命令，助你自动化完整的项目生命周期：创意验证 → 规划 → 执行 → 会话管理 → 上下文保留 → 发布。

节省时间：每个项目生命周期节省 35-55 分钟

安装

市场：/plugin install project-workflow@jezweb-skills

手动安装：将 commands/*.md 复制到 ~/.claude/commands/

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）、工作会话结束或切换任务前。

执行内容：任务 Agent 分析会话 → 更新 SESSION.md（进度、Next Action、阻塞项）→ 创建 Git 检查点提交 → 生成格式化的交接摘要。

节省时间：2-3 分钟

---

5. /continue-session - 会话开始时加载上下文

适用场景：开始新会话或在 /wrap-session 创建检查点后使用。

执行内容：探索 Agent 加载 SESSION.md 和规划文档 → 显示 Git 历史记录和会话摘要（阶段、进度、Next Action、阻塞项）→ 可选择打开文件 → 询问是否可以继续。

节省时间：1-2 分钟

---

6. /workflow - 交互式工作流指南

适用场景：首次使用、不确定该使用哪个命令，或需要快速参考。

执行内容：显示全部 9 个命令 → 根据上下文提供决策树指引 → 提议执行适当的命令。

---

7. /release - 发布前安全检查

适用场景：准备推送到公开的 GitHub 仓库或创建发布版本。

8 个阶段：

1. 关键安全检查（阻塞项）：扫描密钥（gitleaks）、检查个人文件、验证 Git 远程仓库
2. 文档（必需）：LICENSE、README（>100 个单词）、CONTRIBUTING.md（>500 行代码）、CODE_OF_CONDUCT（>1000 行代码）
3. 配置：.gitignore、package.json、Git 分支警告
4. 质量（非阻塞）：构建测试、npm audit、大文件（>1MB）
5. 报告：阻塞项/警告/建议 + 是否可以安全发布的结论 6-8. 自动修复与发布：修复问题、创建发布准备提交、可选创建 Git 标签和 GitHub 发布版本

节省时间：10-15 分钟

---

8. /brief - 上下文保留文档

适用场景：清除上下文前，保留关键决策和需求，供后续会话使用。

创建内容：docs/brief-[slug].md，其中包含从当前对话中提取的信息。

执行内容：分析对话 → 提取正在构建的内容、已作出的决策和技术细节 → 创建结构清晰的 Markdown 文件 → 可选择创建 GitHub issue 以便跟踪。

节省时间：3-5 分钟

9. /reflect - 捕获操作知识

使用时机：压缩上下文之前、完成重要工作之后，或积累了有价值的经验时。

功能：回顾对话 → 识别发现的工作流、学到的模式、工具使用顺序和所做的修正 → 将每条经验归入合适的位置（规则、CLAUDE.md、技能、文档）→ 可选地建议自动化方案（脚本、命令、自定义 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（发布）

---

集成

project-planning：由 /plan-project 和 /plan-feature 调用（生成 IMPLEMENTATION_PHASES.md、DATABASE_SCHEMA.md、API_ENDPOINTS.md）

project-session-management：/wrap-session 和 /continue-session 使用 SESSION.md 协议

Claude Code agents：/wrap-session（Task agent）、/continue-session + /explore-idea（Explore agent）

---

命令关系

EXPLORATION PHASE
/explore-idea (optional)
    ↓
    Creates PROJECT_BRIEF.md
    ↓
PLANNING PHASE
/plan-project (reads PROJECT_BRIEF.md if exists)
    ↓
    Creates IMPLEMENTATION_PHASES.md + SESSION.md
    ↓
EXECUTION PHASE
Work on phases
    ↓
/wrap-session (when context full)
    ↓
    Updates SESSION.md, git checkpoint
    ↓
/continue-session (new session)
    ↓
    Loads SESSION.md, continues work
    ↓
/plan-feature (when need new features)
    ↓
    Adds phases to IMPLEMENTATION_PHASES.md
    ↓
Continue wrap → resume cycle
    ↓
CONTEXT PRESERVATION
/brief (before clearing context)
    ↓
    Creates docs/brief-[slug].md
    ↓
/reflect (capture learnings)
    ↓
    Routes knowledge to rules, docs, CLAUDE.md
    ↓
RELEASE PHASE
/release (when ready to publish)
    ↓
    Safety checks → GitHub release

HELPER
/workflow (anytime)
    ↓
    Interactive guidance

---

节省时间明细

命令	节省时间	自动化的任务
/explore-idea	10-15 分钟	调研、验证、范围管理、技术栈评估
/plan-project	5-7 分钟	生成规划文档、配置 git、划分阶段
/plan-feature	7-10 分钟	功能规划、整合阶段、更新文档
/wrap-session	2-3 分钟	更新 SESSION.md、创建 git 检查点、生成交接摘要
/continue-session	1-2 分钟	加载上下文、查看 git 历史、显示下一步操作
/workflow	即时	导航、决策树、命令选择
/release	10-15 分钟	扫描机密信息、验证文档、测试构建、创建发布版本
/brief	3-5 分钟	提取上下文、记录决策、生成 markdown
/reflect	5-10 分钟	提取经验、归纳知识、提供自动化建议

**每个项目生命周期总计：**45-70 分钟

---

前提条件

全部命令：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 “No project description”：先使用 /explore-idea，或与 Claude 讨论项目

/plan-feature “Prerequisites not met”：先运行 /plan-project（会创建 SESSION.md + IMPLEMENTATION_PHASES.md）

/wrap-session “No git repository”：运行 git init

/continue-session “SESSION.md not found”：运行 /plan-project

/release “Secrets detected”：添加到 .gitignore，并从 git 历史记录中移除

---

版本历史

1.1.0（2026-01-11）

• 新增 /brief 命令，用于保留上下文
• 新增 /reflect 命令，用于捕获操作知识
• /reflect 现在会针对需要推理的流程建议自定义 Agent
• 命令总数：9

1.0.0（2025-11-12）

• 首次发布
• 集成 7 个斜杠命令
• 通过插件市场分发
• 通过 plugin.json 打包命令

---

问题反馈：https://github.com/jezweb/claude-skills/issues | 作者：Jeremy Dawes ([email protected]) | 许可证：MIT