mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
754f9b8da0
统一命令调用格式从 /workflow/session/list 改为 /workflow:session:list ## 修复范围 - workflow/session/: 6个子命令 (start, pause, resume, list, status, switch) - workflow/issue/: 4个子命令 (create, list, update, close) - workflow/: 3个主命令 (plan, execute, review) - task/: 4个命令 (create, execute, breakdown, replan) - gemini/: 3个命令 (chat, execute, analyze) ## 格式统一 - usage行: /workflow:session:list - examples: /workflow:session:start "任务" - 标题: # Command (/workflow:session:start) - 内容引用: 所有命令路径统一使用冒号格式 ## 验证完成 ✅ 24个命令文件全部采用统一格式 ✅ 所有examples和内容引用保持一致 ✅ parent字段同步更新 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
139 lines
3.8 KiB
Markdown
139 lines
3.8 KiB
Markdown
---
|
|
name: workflow-plan
|
|
description: Create implementation plans with intelligent input detection
|
|
usage: /workflow:plan <input>
|
|
argument-hint: "text description"|file.md|ISS-001|template-name
|
|
examples:
|
|
- /workflow:plan "Build authentication system"
|
|
- /workflow:plan requirements.md
|
|
- /workflow:plan ISS-001
|
|
- /workflow:plan web-api
|
|
---
|
|
|
|
# Workflow Plan Command (/workflow:plan)
|
|
|
|
## Overview
|
|
Creates actionable implementation plans with intelligent input source detection. Supports text, files, issues, and templates through automatic recognition.
|
|
|
|
## Core Principles
|
|
**System:** @~/.claude/workflows/unified-workflow-system-principles.md
|
|
|
|
## Usage
|
|
```bash
|
|
/workflow/plan <input>
|
|
```
|
|
|
|
## Input Detection Logic
|
|
The command automatically detects input type:
|
|
|
|
### File Input (Auto-detected)
|
|
```bash
|
|
/workflow:plan requirements.md
|
|
/workflow:plan PROJECT_SPEC.txt
|
|
/workflow:plan config.json
|
|
/workflow:plan spec.yaml
|
|
```
|
|
**Triggers**: Extensions: .md, .txt, .json, .yaml, .yml
|
|
**Processing**: Reads file contents and extracts requirements
|
|
|
|
### Issue Input (Auto-detected)
|
|
```bash
|
|
/workflow:plan ISS-001
|
|
/workflow:plan ISSUE-123
|
|
/workflow:plan feature-request-45
|
|
```
|
|
**Triggers**: Patterns: ISS-*, ISSUE-*, *-request-*
|
|
**Processing**: Loads issue data and acceptance criteria
|
|
|
|
### Template Input (Auto-detected)
|
|
```bash
|
|
/workflow:plan web-api
|
|
/workflow:plan mobile-app
|
|
/workflow:plan database-migration
|
|
/workflow:plan security-feature
|
|
```
|
|
**Triggers**: Known template names
|
|
**Processing**: Loads template and prompts for customization
|
|
|
|
### Text Input (Default)
|
|
```bash
|
|
/workflow:plan "Build user authentication with JWT and OAuth2"
|
|
/workflow:plan "Fix performance issues in dashboard"
|
|
```
|
|
**Triggers**: Everything else
|
|
**Processing**: Parse natural language requirements
|
|
|
|
## Automatic Behaviors
|
|
|
|
### Session Management
|
|
- Creates new session if none exists
|
|
- Uses active session if available
|
|
- Generates session ID: WFS-[topic-slug]
|
|
|
|
### Complexity Detection
|
|
- **Simple**: <5 tasks → Direct IMPL_PLAN.md
|
|
- **Medium**: 5-15 tasks → IMPL_PLAN.md + TODO_LIST.md
|
|
- **Complex**: >15 tasks → Full decomposition
|
|
|
|
### Task Generation
|
|
- Automatically creates .task/ files when complexity warrants
|
|
- Generates hierarchical task structure (max 3 levels)
|
|
- Updates session state with task references
|
|
|
|
## Session Check Process
|
|
⚠️ **CRITICAL**: Check for existing active session before planning
|
|
|
|
1. **Check Active Session**: Check for `.workflow/.active-*` marker file
|
|
2. **Session Selection**: Use existing active session or create new
|
|
3. **Context Integration**: Load session state and existing context
|
|
|
|
## Output Documents
|
|
|
|
### IMPL_PLAN.md (Always Created)
|
|
```markdown
|
|
# Implementation Plan - [Project Name]
|
|
*Generated from: [input_source]*
|
|
|
|
## Requirements
|
|
[Extracted requirements from input source]
|
|
|
|
## Task Breakdown
|
|
- **IMPL-001**: [Task description]
|
|
- **IMPL-002**: [Task description]
|
|
|
|
## Success Criteria
|
|
[Measurable completion conditions]
|
|
```
|
|
|
|
### Optional TODO_LIST.md (Auto-triggered)
|
|
Created when complexity > simple or task count > 5
|
|
|
|
### Task JSON Files (Auto-created)
|
|
Generated in .task/ directory when decomposition enabled
|
|
|
|
## Error Handling
|
|
|
|
### Input Processing Errors
|
|
- **File not found**: Clear error message with suggestions
|
|
- **Invalid issue**: Verify issue ID exists
|
|
- **Unknown template**: List available templates
|
|
- **Empty input**: Prompt for valid input
|
|
|
|
## Integration Points
|
|
|
|
### Related Commands
|
|
- `/workflow:session:start` - Create new session first
|
|
- `/context` - View generated plan
|
|
- `/task/execute` - Execute decomposed tasks
|
|
- `/workflow:execute` - Run implementation phase
|
|
|
|
### Template System
|
|
Available templates:
|
|
- `web-api`: REST API development
|
|
- `mobile-app`: Mobile application
|
|
- `database-migration`: Database changes
|
|
- `security-feature`: Security implementation
|
|
|
|
---
|
|
|
|
**System ensures**: Unified planning interface with intelligent input detection and automatic complexity handling |