Refactor documentation for code commands and workflows

- Updated command syntax formatting to use code blocks for clarity in `prep.md`, `review.md`, and `spec.md`.
- Enhanced architectural diagrams in `ch01-what-is-claude-dms3.md` and core concepts in `ch03-core-concepts.md` using mermaid syntax for better visualization.
- Improved workflow diagrams in `ch04-workflow-basics.md` and `4-level.md` to provide clearer representations of processes.
- Added troubleshooting section in `installation.md` to address common installation issues and provide quick start examples.
- Revised skill documentation in `claude-meta.md` and `claude-workflow.md` to standardize command triggers and output structures.
- Updated best practices and workflow index documentation to enhance readability and understanding of workflow levels and practices.
This commit is contained in:
catlog22
2026-02-28 19:53:24 +08:00
parent b0bfdb907a
commit 4a89f626fc
51 changed files with 741 additions and 619 deletions

View File

@@ -4,7 +4,7 @@ CCW 四级工作流系统提供了一种从规格说明到部署的结构化软
## 概述
```
```text
Level 1: 规格说明 → Level 2: 规划 → Level 3: 实现 → Level 4: 验证
```
@@ -38,7 +38,7 @@ Level 1: 规格说明 → Level 2: 规划 → Level 3: 实现 → Level 4: 验
### 示例任务
```
```text
RESEARCH-001 → DRAFT-001 → DRAFT-002 → DRAFT-003 → DRAFT-004 → QUALITY-001
```
@@ -95,7 +95,7 @@ RESEARCH-001 → DRAFT-001 → DRAFT-002 → DRAFT-003 → DRAFT-004 → QUALITY
任务根据依赖关系按拓扑顺序执行:
```
```text
TASK-001 (无依赖) → TASK-002 (依赖 001) → TASK-003 (依赖 002)
```
@@ -142,7 +142,7 @@ TASK-001 (无依赖) → TASK-002 (依赖 001) → TASK-003 (依赖 002)
事件驱动执行,由协调器编排:
```
```text
Event Coordinator Workers
────────────────────────────────────────────────
callback/resume → handleCallback ─────────────────┐
@@ -172,7 +172,7 @@ callback <───────────────────────
对于简单的线性继任,工作器可以直接生成后继者:
```
```text
[Worker A] complete
→ Check: 1 ready task? simple successor?
→ YES: Spawn Worker B directly
@@ -183,7 +183,7 @@ callback <───────────────────────
某些史诗可以并行执行:
```
```text
EPIC-003: Content Modules ──┐
├──→ EPIC-005: Interaction Features
EPIC-004: Search & Nav ────┘

View File

@@ -135,7 +135,7 @@
### 良好的工作流
```
```text
[Specification]
↓ Clear requirements with acceptance criteria
[Planning]
@@ -149,7 +149,7 @@
### 有问题的工作流
```
```text
[Specification]
↓ Vague requirements, no acceptance criteria
[Planning]

View File

@@ -4,7 +4,7 @@ CCW 的 4 级工作流系统编排从需求到部署代码的整个开发生命
## 工作流级别
```
```text
Level 1: 规范
Level 2: 规划
@@ -105,7 +105,7 @@ Skill(skill="team-lifecycle-v4", args="构建用户身份验证系统")
## 工作流可视化
```
```text
┌─────────────────────────────────────────────────────────────┐
│ 工作流编排 │
├─────────────────────────────────────────────────────────────┤