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

@@ -66,29 +66,15 @@ Codex Prompts 定义在 `.codex/prompts/` 目录,专为 Codex 模型优化。
## 3.2 三层关系
```
┌─────────────────────────────────────────────────────┐
│ 用户请求 │
└────────────────────┬────────────────────────────────┘
┌─────────────────────────────────────────────────────┐
ccw (编排器) │
意图分析 → 工作流选择 → 命令链执行 │
└────────────────────┬────────────────────────────────┘
┌───────────┼───────────┐
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ Command│ │ Skill │ │ Prompt │
│ (原子) │ │ (复合) │ │(模板) │
└────────┘ └────────┘ └────────┘
│ │ │
└───────────┼───────────┘
┌────────────────┐
│ AI 模型调用 │
└────────────────┘
```mermaid
graph TB
A[用户请求] --> B[ccw 编排器<br/>意图分析 → 工作流选择 → 命令链执行]
B --> C[Command 原子]
B --> D[Skill 复合]
B --> E[Prompt 模板]
C --> F[AI 模型调用]
D --> F
E --> F
```
### 3.2.1 调用路径
@@ -107,17 +93,13 @@ Codex Prompts 定义在 `.codex/prompts/` 目录,专为 Codex 模型优化。
### 3.3.1 会话生命周期
```
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ Start │────▶│ Resume │────▶│ Execute │────▶│Complete │
│ 启动 │ │ 恢复 │ │ 执行 │ │ 完成 │
└─────────┘ └─────────┘ └─────────┘ └─────────┘
│ │
▼ ▼
┌─────────┐ ┌─────────┐
│ List │ │ Solidify│
│ 列出 │ │ 固化 │
└─────────┘ └─────────┘
```mermaid
graph LR
A[Start<br/>启动] --> B[Resume<br/>恢复]
B --> C[Execute<br/>执行]
C --> D[Complete<br/>完成]
A --> E[List<br/>列出]
D --> F[Solidify<br/>固化]
```
### 3.3.2 会话命令
@@ -172,20 +154,11 @@ Claude_dms3 支持 8 种团队工作流,每种工作流定义了不同的角
团队成员通过消息总线通信:
```
┌────────────┐ ┌────────────┐
Planner │ │ Executor
└─────┬──────┘ └──────┬─────┘
│ │
│ [plan_ready] │
├────────────────────────────────▶
│ │
│ [task_complete]
│◀────────────────────────────────┤
│ │
│ [plan_approved] │
├────────────────────────────────▶
│ │
```mermaid
graph LR
A[Planner] -->|plan_ready| B[Executor]
B -->|task_complete| A
A -->|plan_approved| B
```
### 3.4.3 工作流选择指南
@@ -221,38 +194,25 @@ Claude_dms3 支持 8 种团队工作流,每种工作流定义了不同的角
## 3.6 数据流
```
用户请求
┌──────────────┐
CCW 编排器 │ ──▶ 意图分析
└──────────────┘
├─▶ Workflow 选择
│ │
│ ├─▶ PlanEx
│ ├─▶ IterDev
│ ├─▶ Lifecycle
│ └─▶ ...
├─▶ Command 执行
│ │
│ ├─▶ 内置命令
│ └─▶ Skill 调用
├─▶ AI 模型调用
│ │
│ ├─▶ Gemini
│ ├─▶ Qwen
│ ├─▶ Codex
│ └─▶ Claude
└─▶ 结果返回
├─▶ 文件修改
├─▶ Memory 更新
└─▶ Dashboard 更新
```mermaid
graph TB
A[用户请求] --> B[CCW 编排器<br/>意图分析]
B --> C[Workflow 选择]
B --> D[Command 执行]
B --> E[AI 模型调用]
B --> F[结果返回]
C --> C1[PlanEx]
C --> C2[IterDev]
C --> C3[Lifecycle]
D --> D1[内置命令]
D --> D2[Skill 调用]
E --> E1[Gemini]
E --> E2[Qwen]
E --> E3[Codex]
E --> E4[Claude]
F --> F1[文件修改]
F --> F2[Memory 更新]
F --> F3[Dashboard 更新]
```
---