project-workflow
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseProject Workflow Skill
项目工作流Skill
9 integrated slash commands for complete project lifecycle automation: idea validation → planning → execution → session management → context preservation → release.
Time savings: 35-55 minutes per project lifecycle
9个集成斜杠命令，实现完整项目生命周期自动化：创意验证 → 规划 → 执行 → 会话管理 → 上下文保留 → 发布。
时间节省：每个项目生命周期可节省35-55分钟
Installation
安装
Marketplace:
/plugin install project-workflow@jezweb-skillsManual: Copy to
commands/*.md~/.claude/commands/应用市场：
/plugin install project-workflow@jezweb-skills手动安装：将复制到
commands/*.md~/.claude/commands/The 9 Commands
9个命令
1. /explore-idea
- Pre-Planning Exploration
/explore-idea1. /explore-idea
- 预规划探索
/explore-ideaUse when: Rough idea that needs tech stack validation, scope management, or research before planning.
Creates: PROJECT_BRIEF.md with validated decisions → hands off to /plan-project
Time savings: 10-15 min
适用场景：需要在规划前验证技术栈、管理范围或开展调研的初步创意。
生成文件：PROJECT_BRIEF.md（包含已验证的决策）→ 移交至/plan-project
时间节省：10-15分钟
2. /plan-project
- Generate Project Planning Docs
/plan-project2. /plan-project
- 生成项目规划文档
/plan-projectUse when: Starting new project with clear requirements, or after /explore-idea.
Creates: IMPLEMENTATION_PHASES.md, SESSION.md, DATABASE_SCHEMA.md (if needed), API_ENDPOINTS.md (if needed), ARCHITECTURE.md
Invokes: project-planning skill
Time savings: 5-7 min
适用场景：启动需求明确的新项目，或在/explore-idea之后使用。
生成文件：IMPLEMENTATION_PHASES.md、SESSION.md、DATABASE_SCHEMA.md（按需生成）、API_ENDPOINTS.md（按需生成）、ARCHITECTURE.md
调用：project-planning skill
时间节省：5-7分钟
3. /plan-feature
- Add Features to Existing Projects
/plan-feature3. /plan-feature
- 为现有项目添加功能
/plan-featureUse when: Adding feature to existing project with SESSION.md + IMPLEMENTATION_PHASES.md.
Does: Generates new phases via project-planning skill, integrates into IMPLEMENTATION_PHASES.md with renumbering, updates SESSION.md.
Time savings: 7-10 min
适用场景：为已有SESSION.md和IMPLEMENTATION_PHASES.md的项目添加功能。
功能：通过project-planning skill生成新的阶段，将其整合到IMPLEMENTATION_PHASES.md并重新编号，更新SESSION.md。
时间节省：7-10分钟
4. /wrap-session
- End-of-Session Checkpoint
/wrap-session4. /wrap-session
- 会话结束 Checkpoint
/wrap-sessionUse when: Context full (>150k tokens), end of work session, or before task switch.
Does: Task agent analyzes session → updates SESSION.md (progress, Next Action, blockers) → git checkpoint commit → formatted handoff summary.
Time savings: 2-3 min
适用场景：上下文已满（>150k tokens）、工作会话结束或切换任务前。
功能：任务代理分析会话 → 更新SESSION.md（进度、下一步行动、阻塞问题）→ git checkpoint提交 → 生成格式化的移交摘要。
时间节省：2-3分钟
5. /continue-session
- Start-of-Session Context Loading
/continue-session5. /continue-session
- 会话启动上下文加载
/continue-sessionUse when: Starting new session or after /wrap-session checkpoint.
Does: Explore agent loads SESSION.md + planning docs → shows git history + session summary (phase, progress, Next Action, blockers) → optionally opens file → asks permission to continue.
Time savings: 1-2 min
适用场景：启动新会话或在/wrap-session checkpoint之后使用。
功能：探索代理加载SESSION.md和规划文档 → 展示git历史和会话摘要（阶段、进度、下一步行动、阻塞问题）→ 可选择打开文件 → 请求继续权限。
时间节省：1-2分钟
6. /workflow
- Interactive Workflow Guide
/workflow6. /workflow
- 交互式工作流指南
/workflowUse when: First time user, unsure which command to use, or need quick reference.
Does: Shows all 9 commands → context-aware guidance with decision trees → offers to execute appropriate command.
适用场景：首次使用、不确定应使用哪个命令或需要快速参考时。
功能：展示全部9个命令 → 提供上下文感知的决策树指引 → 可选择执行合适的命令。
7. /release
- Pre-Release Safety Checks
/release7. /release
- 发布前安全检查
/releaseUse when: Ready to push to public GitHub or create release.
8 Phases:
- Critical Safety (BLOCKERS): Secrets scan (gitleaks), personal artifacts check, git remote verification
- Documentation (REQUIRED): LICENSE, README (>100 words), CONTRIBUTING.md (>500 LOC), CODE_OF_CONDUCT (>1000 LOC)
- Configuration: .gitignore, package.json, git branch warning
- Quality (NON-BLOCKING): Build test, npm audit, large files (>1MB)
- Report: Blockers/warnings/recommendations + safe to release verdict 6-8. Auto-Fix & Publish: Fix issues, release prep commit, optional git tag + GitHub release
Time savings: 10-15 min
适用场景：准备推送到公开GitHub或创建发布版本时。
8个阶段:
- 关键安全检查（阻塞项）：密钥扫描（gitleaks）、个人工件检查、git远程仓库验证
- 文档检查（必填项）：LICENSE、README（>100词）、CONTRIBUTING.md（>500 LOC）、CODE_OF_CONDUCT（>1000 LOC）
- 配置检查：.gitignore、package.json、git分支警告
- 质量检查（非阻塞项）：构建测试、npm audit、大文件检查（>1MB）
- 报告：阻塞项/警告/建议 + 发布安全 verdict 6-8. 自动修复与发布：修复问题、发布准备提交、可选git标签 + GitHub发布
时间节省：10-15分钟
8. /brief
- Context Preservation Document
/brief8. /brief
- 上下文保留文档
/briefUse when: Before clearing context, to preserve key decisions and requirements for future sessions.
Creates: with extracted information from current conversation.
docs/brief-[slug].mdDoes: Analyzes conversation → extracts what's being built, decisions made, technical details → creates organized markdown file → optionally creates GitHub issue for tracking.
Time savings: 3-5 min
适用场景：清除上下文前，为未来会话保留关键决策和需求。
生成文件：，包含从当前对话中提取的信息。
docs/brief-[slug].md功能：分析对话 → 提取正在构建的内容、已做决策、技术细节 → 生成结构化markdown文件 → 可选择创建GitHub issue进行跟踪。
时间节省：3-5分钟
9. /reflect
- Capture Operational Knowledge
/reflect9. /reflect
- 捕获操作经验
/reflectUse when: Before context compaction, after completing significant work, or when valuable learnings accumulated.
Does: Reviews conversation → identifies workflows discovered, patterns learned, tool sequences, corrections made → routes each learning to appropriate destination (rules, CLAUDE.md, skills, docs) → optionally suggests automation (scripts, commands, custom agents).
Key Feature: Considers whether processes should become custom agents when they require reasoning/decisions, benefit from parallel execution, or involve research/exploration.
Time savings: 5-10 min
适用场景：上下文压缩前、完成重要工作后或积累了有价值的经验时。
功能：回顾对话 → 识别发现的工作流、学到的模式、工具序列、做出的修正 → 将每条经验路由到合适的目标（规则、CLAUDE.md、技能、文档）→ 可选择建议自动化（脚本、命令、自定义代理）。
核心特性：当流程需要推理/决策、可从并行执行中获益或涉及调研/探索时，会考虑将其转化为自定义代理。
时间节省：5-10分钟
Workflow Examples
工作流示例
Full: /explore-idea → /plan-project → work → /wrap-session → /continue-session → /plan-feature (if needed) → repeat → /reflect → /release
Quick (clear requirements): /plan-project → work → /wrap-session → /continue-session → /release
Context Preservation: /brief (before clearing context), /reflect (capture learnings)
Helpers: /workflow (guidance), /plan-feature (add feature), /release (publish)
完整流程：/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（发布）
Integration
集成
project-planning: Invoked by /plan-project and /plan-feature (generates IMPLEMENTATION_PHASES.md, DATABASE_SCHEMA.md, API_ENDPOINTS.md)
project-session-management: SESSION.md protocol for /wrap-session and /continue-session
Claude Code agents: /wrap-session (Task agent), /continue-session + /explore-idea (Explore agent)
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（任务代理）、/continue-session + /explore-idea（探索代理）
Command Relationships
命令关系
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 guidanceEXPLORATION 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 guidanceTime Savings Breakdown
时间节省明细
| Command | Time Saved | Tasks Automated |
|---|---|---|
| 10-15 min | Research, validation, scope management, tech stack evaluation |
| 5-7 min | Planning doc generation, git setup, phase structuring |
| 7-10 min | Feature planning, phase integration, doc updates |
| 2-3 min | SESSION.md updates, git checkpoint, handoff summary |
| 1-2 min | Context loading, git history review, next action display |
| Instant | Navigation, decision trees, command selection |
| 10-15 min | Secret scanning, doc validation, build testing, release creation |
| 3-5 min | Context extraction, decisions capture, markdown generation |
| 5-10 min | Learning extraction, knowledge routing, automation suggestions |
Total per project lifecycle: 45-70 minutes
| 命令 | 节省时间 | 自动化任务 |
|---|---|---|
| 10-15分钟 | 调研、验证、范围管理、技术栈评估 |
| 5-7分钟 | 规划文档生成、git设置、阶段结构化 |
| 7-10分钟 | 功能规划、阶段整合、文档更新 |
| 2-3分钟 | SESSION.md更新、git checkpoint、移交摘要 |
| 1-2分钟 | 上下文加载、git历史回顾、下一步行动展示 |
| 即时 | 导航、决策树、命令选择 |
| 10-15分钟 | 密钥扫描、文档验证、构建测试、发布创建 |
| 3-5分钟 | 上下文提取、决策捕获、markdown生成 |
| 5-10分钟 | 经验提取、知识路由、自动化建议 |
每个项目生命周期总计：45-70分钟
Prerequisites
前置条件
All: Claude Code CLI, git repo (recommended)
/plan-feature: Existing SESSION.md + IMPLEMENTATION_PHASES.md
/wrap-session, /continue-session: SESSION.md (created by /plan-project)
/release: Git repo with commits, package.json (Node.js), remote URL (for publishing)
通用：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（用于发布）
Troubleshooting
故障排除
/plan-project "No project description": Use /explore-idea first or discuss project with Claude
/plan-feature "Prerequisites not met": Run /plan-project first (creates SESSION.md + IMPLEMENTATION_PHASES.md)
/wrap-session "No git repository": Run
git init/continue-session "SESSION.md not found": Run /plan-project
/release "Secrets detected": Add to .gitignore, remove from git history
/plan-project提示“无项目描述”：先使用/explore-idea或与Claude讨论项目
/plan-feature提示“未满足前置条件”：先运行/plan-project（生成SESSION.md + IMPLEMENTATION_PHASES.md）
/wrap-session提示“无git仓库”：运行
git init/continue-session提示“未找到SESSION.md”：运行/plan-project
/release提示“检测到密钥”：添加到.gitignore，从git历史中移除
Version History
版本历史
1.1.0 (2026-01-11)
- Added command for context preservation
/brief - Added command for capturing operational knowledge
/reflect - now suggests custom agents for processes requiring reasoning
/reflect - Total commands: 9
1.0.0 (2025-11-12)
- Initial release
- 7 integrated slash commands
- Plugin marketplace distribution
- Command bundling via plugin.json
Issues: https://github.com/jezweb/claude-skills/issues | Author: Jeremy Dawes (jeremy@jezweb.net) | License: MIT
1.1.0（2026-01-11）
- 添加/brief命令用于上下文保留
- 添加/reflect命令用于捕获操作经验
- /reflect现在会为需要推理的流程建议自定义代理
- 命令总数：9个
1.0.0（2025-11-12）
- 初始版本发布
- 7个集成斜杠命令
- 插件市场分发
- 通过plugin.json实现命令捆绑
问题反馈：https://github.com/jezweb/claude-skills/issues | 作者：Jeremy Dawes（jeremy@jezweb.net） | 许可证：MIT