catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-05 16:13:08 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix: update command references and improve documentation for workflow commands

Browse Source
This commit is contained in:
catlog22
2026-03-04 14:11:15 +08:00
parent fb0f56bfc0
commit b203ada9c5
16 changed files with 50 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
ccw/frontend/src/lib/pipeline-utils.ts
View File

@@ -38,11 +38,12 @@ export function deriveStageStatus(
} }
/** /**
* Three-tier pipeline stage detection. * Four-tier pipeline stage detection.
* *
* Tier 1 - explicit `pipeline_stages` from meta * Tier 1 - explicit `pipeline_stages` from meta
* Tier 2 - inferred from message senders (excluding "coordinator") * Tier 2 - explicit `roles` list from meta (excluding coordinator)
* Tier 3 - legacy 4-stage fallback * Tier 3 - inferred from message senders (excluding "coordinator")
* Tier 4 - legacy 4-stage fallback
*/ */
export function derivePipelineStages( export function derivePipelineStages(
meta: { meta: {
@@ -67,7 +68,20 @@ export function derivePipelineStages(
}); });
} }
// Tier 2: extract from message senders // Tier 2: explicit roles list from meta (authoritative source from coordinator)
if (meta.roles && meta.roles.length > 0) {
const workerRoles = meta.roles.filter((r) => r.toLowerCase() !== 'coordinator');
if (workerRoles.length > 0) {
return workerRoles.map((role) => ({
id: role.toUpperCase(),
label: formatStageLabel(role),
role,
status: deriveStageStatus(role, messages),
}));
}
}
// Tier 3: extract from message senders
if (messages.length > 0) { if (messages.length > 0) {
const seen = new Map<string, string>(); // lowercase sender -> original sender const seen = new Map<string, string>(); // lowercase sender -> original sender
for (const msg of messages) { for (const msg of messages) {
@@ -89,7 +103,7 @@ export function derivePipelineStages(
} }
} }
// Tier 3: legacy fallback // Tier 4: legacy fallback
return LEGACY_STAGES.map((stage) => ({ return LEGACY_STAGES.map((stage) => ({
id: stage.toUpperCase(), id: stage.toUpperCase(),
label: formatStageLabel(stage), label: formatStageLabel(stage),

2
docs/COMMAND_SPEC.md
View File

@@ -202,7 +202,7 @@ CLI tool configuration commands.
/cli:cli-init /cli:cli-init
``` ```
> **Note**: For analysis, planning, and bug fixing, use workflow commands (`/workflow-lite-planex`, `/workflow:lite-fix`) or semantic invocation through natural language. Claude will automatically use appropriate CLI tools (Gemini/Qwen/Codex) with templates as needed. > **Note**: For analysis, planning, and bug fixing, use workflow commands (`/workflow-lite-planex`, `/workflow:debug-with-file`) or semantic invocation through natural language. Claude will automatically use appropriate CLI tools (Gemini/Qwen/Codex) with templates as needed.
--- ---

4
docs/commands/claude/core-orchestration.md
View File

@@ -47,7 +47,7 @@ graph TD
| Type | Trigger Keywords | Workflow | | Type | Trigger Keywords | Workflow |
|------|------------------|----------| |------|------------------|----------|
| **Bug Fix** | urgent, production, critical + fix, bug | lite-fix | | **Bug Fix** | urgent, production, critical + fix, bug | debug-with-file |
| **Brainstorming** | brainstorm, ideation | brainstorm-with-file | | **Brainstorming** | brainstorm, ideation | brainstorm-with-file |
| **Debug Document** | debug document, hypothesis | debug-with-file | | **Debug Document** | debug document, hypothesis | debug-with-file |
| **Collaborative Analysis** | analyze document | analyze-with-file | | **Collaborative Analysis** | analyze document | analyze-with-file |
@@ -163,4 +163,4 @@ Both commands support the `--yes` flag for auto mode:
- [Workflow Commands](./workflow.md) - [Workflow Commands](./workflow.md)
- [Session Management](./session.md) - [Session Management](./session.md)
- [CLI Invocation System](../features/cli.md) - [CLI Invocation System](../../features/cli.md)

5
docs/commands/claude/index.md
View File

@@ -31,7 +31,6 @@
| Command | Function | Difficulty | | Command | Function | Difficulty |
|---------|----------|------------| |---------|----------|------------|
| [`/workflow-lite-planex`](./workflow.md#lite-plan) | Lightweight interactive planning workflow | Intermediate | | [`/workflow-lite-planex`](./workflow.md#lite-plan) | Lightweight interactive planning workflow | Intermediate |
| [`/workflow:lite-fix`](./workflow.md#lite-fix) | Lightweight bug diagnosis and fix | Intermediate |
| [`/workflow-plan`](./workflow.md#plan) | 5-phase planning workflow | Intermediate | | [`/workflow-plan`](./workflow.md#plan) | 5-phase planning workflow | Intermediate |
| [`/workflow-execute`](./workflow.md#execute) | Coordinate agent execution of workflow tasks | Intermediate | | [`/workflow-execute`](./workflow.md#execute) | Coordinate agent execution of workflow tasks | Intermediate |
| [`/workflow:replan`](./workflow.md#replan) | Interactive workflow replanning | Intermediate | | [`/workflow:replan`](./workflow.md#replan) | Interactive workflow replanning | Intermediate |
@@ -229,5 +228,5 @@ ccw cli -p "Review code quality" --tool gemini --mode analysis --rule analysis-r
## Related Documentation ## Related Documentation
- [Skills Reference](../skills/) - [Skills Reference](../skills/)
- [CLI Invocation System](../features/cli.md) - [CLI Invocation System](../../features/cli.md)
- [Workflow Guide](../guide/ch04-workflow-basics.md) - [Workflow Guide](../../guide/ch04-workflow-basics.md)

22
docs/commands/claude/workflow.md
View File

@@ -11,7 +11,6 @@
| Command | Function | Syntax | | Command | Function | Syntax |
|---------|----------|--------| |---------|----------|--------|
| [`lite-plan`](#lite-plan) | Lightweight interactive planning workflow | `/workflow-lite-planex [-y] [-e] "task"` | | [`lite-plan`](#lite-plan) | Lightweight interactive planning workflow | `/workflow-lite-planex [-y] [-e] "task"` |
| [`lite-fix`](#lite-fix) | Lightweight bug diagnosis and fix | `/workflow:lite-fix [-y] [--hotfix] "bug description"` |
### Standard Workflows ### Standard Workflows
@@ -86,27 +85,6 @@
/workflow-lite-planex -e "refactor authentication module" /workflow-lite-planex -e "refactor authentication module"
``` ```
### lite-fix
**Function**: Lightweight bug diagnosis and fix workflow, supporting intelligent severity assessment and optional hotfix mode.
**Syntax**:
```bash
/workflow:lite-fix [-y|--yes] [--hotfix] "bug description or issue reference"
```
**Options**:
- `--hotfix`: Hotfix mode (quick fix for production incidents)
**Examples**:
```bash
# Bug fix
/workflow:lite-fix "login returns 500 error"
# Hotfix
/workflow:lite-fix --hotfix "payment gateway timeout"
```
### plan ### plan
**Function**: 5-phase planning workflow, outputting IMPL_PLAN.md and task JSON. **Function**: 5-phase planning workflow, outputting IMPL_PLAN.md and task JSON.

2
docs/features/sessions.md
View File

@@ -182,6 +182,6 @@ interface SessionsFilter {
## Related Links ## Related Links
- [Dashboard](/features/dashboard) - Overview of all sessions with statistics - [Dashboard](/features/dashboard) - Overview of all sessions with statistics
- [Lite Tasks](/features/tasks-history) - Lite-plan and lite-fix task management - [Lite Tasks](/features/tasks-history) - Lite-plan and multi-cli-plan task management
- [Terminal Dashboard](/features/terminal-dashboard) - Terminal-first session monitoring - [Terminal Dashboard](/features/terminal-dashboard) - Terminal-first session monitoring
- [Orchestrator](/features/orchestrator) - Workflow template editor - [Orchestrator](/features/orchestrator) - Workflow template editor

5
docs/features/tasks-history.md
View File

@@ -12,7 +12,7 @@
**Location**: `ccw/frontend/src/pages/LiteTasksPage.tsx` **Location**: `ccw/frontend/src/pages/LiteTasksPage.tsx`
**Purpose**: Lite-plan and lite-fix task list page with TaskDrawer for details. **Purpose**: Lite-plan and multi-cli-plan task list page with TaskDrawer for details.
**Access**: Navigation → Lite Tasks **Access**: Navigation → Lite Tasks
@@ -20,7 +20,7 @@
| Feature | Description | | Feature | Description |
|---------|-------------| |---------|-------------|
| **Type Tabs** | Switch between lite-plan, lite-fix, multi-cli-plan types | | **Type Tabs** | Switch between lite-plan, multi-cli-plan types |
| **Task Cards** | Display task title, description, status, tags, progress | | **Task Cards** | Display task title, description, status, tags, progress |
| **TaskDrawer** | Slide-over panel with full task context and synthesis | | **TaskDrawer** | Slide-over panel with full task context and synthesis |
| **Round Synthesis** | Multi-perspective analysis results | | **Round Synthesis** | Multi-perspective analysis results |
@@ -34,7 +34,6 @@
| Type | Description | | Type | Description |
|------|-------------| |------|-------------|
| **lite-plan** | Quick planning tasks | | **lite-plan** | Quick planning tasks |
| **lite-fix** | Quick bug fix tasks |
| **multi-cli-plan** | Multi-perspective planning with multiple tools | | **multi-cli-plan** | Multi-perspective planning with multiple tools |
### Task Status Flow ### Task Status Flow

6
docs/zh/commands/claude/core-orchestration.md
View File

@@ -82,7 +82,7 @@ graph TD
| 优先级 | 类型 | 触发关键词 | 工作流 | | 优先级 | 类型 | 触发关键词 | 工作流 |
|--------|------|-----------|--------| |--------|------|-----------|--------|
| 1 | Bug 修复 (紧急) | urgent, production, critical + fix, bug | lite-fix (--hotfix) | | 1 | Bug 修复 (紧急) | urgent, production, critical + fix, bug | debug-with-file |
| 2 | 头脑风暴 | brainstorm, ideation, 头脑风暴, 创意, 发散思维 | brainstorm-with-file | | 2 | 头脑风暴 | brainstorm, ideation, 头脑风暴, 创意, 发散思维 | brainstorm-with-file |
| 3 | 头脑风暴→Issue | brainstorm.*issue, 头脑风暴.*issue | issue:from-brainstorm | | 3 | 头脑风暴→Issue | brainstorm.*issue, 头脑风暴.*issue | issue:from-brainstorm |
| 4 | 调试文档 | debug.*document, hypothesis, 假设验证, 深度调试 | debug-with-file | | 4 | 调试文档 | debug.*document, hypothesis, 假设验证, 深度调试 | debug-with-file |
@@ -94,7 +94,7 @@ graph TD
| 10 | 重构 | refactor, 重构, tech.*debt, 技术债务 | refactor-cycle | | 10 | 重构 | refactor, 重构, tech.*debt, 技术债务 | refactor-cycle |
| 11 | 团队工作流 | team.*plan.*exec, 团队规划执行, wave pipeline | team-planex | | 11 | 团队工作流 | team.*plan.*exec, 团队规划执行, wave pipeline | team-planex |
| 12 | 多CLI协作 | multi.*cli, 多CLI, 多模型协作 | multi-cli-plan | | 12 | 多CLI协作 | multi.*cli, 多CLI, 多模型协作 | multi-cli-plan |
| 13 | Bug 修复 | fix, bug, error, crash, fail, debug | lite-fix | | 13 | Bug 修复 | fix, bug, error, crash, fail, debug | debug-with-file |
| 14 | Issue 批量 | issues?.*batch, 批量issue | issue:discover → execute | | 14 | Issue 批量 | issues?.*batch, 批量issue | issue:discover → execute |
| 15 | Issue 转换 | issue workflow, structured workflow | lite-plan → convert-to-plan | | 15 | Issue 转换 | issue workflow, structured workflow | lite-plan → convert-to-plan |
| 16 | 探索 | uncertain, explore, 研究, what if | brainstorm → plan | | 16 | 探索 | uncertain, explore, 研究, what if | brainstorm → plan |
@@ -411,4 +411,4 @@ Task: <description>
- [工作流命令](./workflow.md) - [工作流命令](./workflow.md)
- [会话管理](./session.md) - [会话管理](./session.md)
- [CLI 调用系统](../features/cli.md) - [CLI 调用系统](../../features/cli.md)

5
docs/zh/commands/claude/index.md
View File

@@ -31,7 +31,6 @@
| 命令 | 功能 | 难度 | | 命令 | 功能 | 难度 |
| --- | --- | --- | | --- | --- | --- |
| [`/workflow-lite-planex`](./workflow.md#lite-plan) | 轻量级交互式规划工作流 | Intermediate | | [`/workflow-lite-planex`](./workflow.md#lite-plan) | 轻量级交互式规划工作流 | Intermediate |
| [`/workflow:lite-fix`](./workflow.md#lite-fix) | 轻量级 Bug 诊断和修复 | Intermediate |
| [`/workflow-plan`](./workflow.md#plan) | 5 阶段规划工作流 | Intermediate | | [`/workflow-plan`](./workflow.md#plan) | 5 阶段规划工作流 | Intermediate |
| [`/workflow-execute`](./workflow.md#execute) | 协调代理执行工作流任务 | Intermediate | | [`/workflow-execute`](./workflow.md#execute) | 协调代理执行工作流任务 | Intermediate |
| [`/workflow:replan`](./workflow.md#replan) | 交互式工作流重新规划 | Intermediate | | [`/workflow:replan`](./workflow.md#replan) | 交互式工作流重新规划 | Intermediate |
@@ -227,5 +226,5 @@ ccw cli -p "审查代码质量" --tool gemini --mode analysis --rule analysis-re
## 相关文档 ## 相关文档
- [Skills 参考](../skills/) - [Skills 参考](../skills/)
- [CLI 调用系统](../features/cli.md) - [CLI 调用系统](../../features/cli.md)
- [工作流指南](../guide/ch04-workflow-basics.md) - [工作流指南](../../guide/ch04-workflow-basics.md)

22
docs/zh/commands/claude/workflow.md
View File

@@ -11,7 +11,6 @@
| 命令 | 功能 | 语法 | | 命令 | 功能 | 语法 |
| --- | --- | --- | | --- | --- | --- |
| [`lite-plan`](#lite-plan) | 轻量级交互式规划工作流 | `/workflow-lite-planex [-y] [-e] "任务"` | | [`lite-plan`](#lite-plan) | 轻量级交互式规划工作流 | `/workflow-lite-planex [-y] [-e] "任务"` |
| [`lite-fix`](#lite-fix) | 轻量级 Bug 诊断和修复 | `/workflow:lite-fix [-y] [--hotfix] "Bug 描述"` |
### 标准工作流 ### 标准工作流
@@ -86,27 +85,6 @@
/workflow-lite-planex -e "重构认证模块" /workflow-lite-planex -e "重构认证模块"
``` ```
### lite-fix
**功能**: 轻量级 Bug 诊断和修复工作流，支持智能严重程度评估和可选的热修复模式。
**语法**:
```bash
/workflow:lite-fix [-y|--yes] [--hotfix] "Bug 描述或 Issue 引用"
```
**选项**:
- `--hotfix`: 热修复模式（生产事故快速修复）
**示例**:
```bash
# Bug 修复
/workflow:lite-fix "登录时出现 500 错误"
# 热修复
/workflow:lite-fix --hotfix "支付网关超时"
```
### plan ### plan
**功能**: 5 阶段规划工作流，输出 IMPL_PLAN.md 和任务 JSON。 **功能**: 5 阶段规划工作流，输出 IMPL_PLAN.md 和任务 JSON。

6
docs/zh/components/ui/badge.md
View File

@@ -114,6 +114,6 @@ Badge 徽章组件用于以紧凑形式显示状态、类别或标签。它通
## 相关组件 ## 相关组件
- [Card 卡片](/zh-CN/components/ui/card) - [Card 卡片](/zh/components/ui/card)
- [Button 按钮](/zh-CN/components/ui/button) - [Button 按钮](/zh/components/ui/button)
- [Avatar 头像](/zh-CN/components/ui/avatar) - [Avatar 头像](/zh/components/ui/avatar)

6
docs/zh/components/ui/button.md
View File

@@ -75,6 +75,6 @@ sidebar: auto
## 相关组件 ## 相关组件
- [Input 输入框](/zh-CN/components/ui/input) - [Input 输入框](/zh/components/ui/input)
- [Select 选择器](/zh-CN/components/ui/select) - [Select 选择器](/zh/components/ui/select)
- [Dialog 对话框](/zh-CN/components/ui/dialog) - [Dialog 对话框](/zh/components/ui/dialog)

6
docs/zh/components/ui/card.md
View File

@@ -102,6 +102,6 @@ sidebar: auto
## 相关组件 ## 相关组件
- [Button 按钮](/zh-CN/components/ui/button) - [Button 按钮](/zh/components/ui/button)
- [Badge 徽章](/zh-CN/components/ui/badge) - [Badge 徽章](/zh/components/ui/badge)
- [Separator 分隔线](/zh-CN/components/ui/separator) - [Separator 分隔线](/zh/components/ui/separator)

6
docs/zh/components/ui/checkbox.md
View File

@@ -115,6 +115,6 @@ const state = ref('indeterminate')
## 相关组件 ## 相关组件
- [Input 输入框](/zh-CN/components/ui/input) - [Input 输入框](/zh/components/ui/input)
- [Select 选择器](/zh-CN/components/ui/select) - [Select 选择器](/zh/components/ui/select)
- [Radio Group 单选框组](/zh-CN/components/ui/radio-group) - [Radio Group 单选框组](/zh/components/ui/radio-group)

6
docs/zh/components/ui/input.md
View File

@@ -113,6 +113,6 @@ function Example() {
## 相关组件 ## 相关组件
- [Button 按钮](/zh-CN/components/ui/button) - [Button 按钮](/zh/components/ui/button)
- [Select 选择器](/zh-CN/components/ui/select) - [Select 选择器](/zh/components/ui/select)
- [Checkbox 复选框](/zh-CN/components/ui/checkbox) - [Checkbox 复选框](/zh/components/ui/checkbox)

6
docs/zh/components/ui/select.md
View File

@@ -122,6 +122,6 @@ const selectedValue = ref('')
## 相关组件 ## 相关组件
- [Input 输入框](/zh-CN/components/ui/input) - [Input 输入框](/zh/components/ui/input)
- [Checkbox 复选框](/zh-CN/components/ui/checkbox) - [Checkbox 复选框](/zh/components/ui/checkbox)
- [Button 按钮](/zh-CN/components/ui/button) - [Button 按钮](/zh/components/ui/button)