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

@@ -32,7 +32,7 @@
**Function**: Create structured issue from GitHub URL or text description, supporting requirement clarity detection.
**Syntax**:
```
```bash
/issue:new [-y|--yes] <github-url | text description> [--priority 1-5]
```
@@ -92,7 +92,7 @@ interface Issue {
**Function**: Discover potential issues from multiple perspectives (Bug, UX, Test, Quality, Security, Performance, Maintainability, Best Practices).
**Syntax**:
```
```bash
/issue:discover [-y|--yes] <path pattern> [--perspectives=bug,ux,...] [--external]
```
@@ -125,7 +125,7 @@ interface Issue {
**Function**: Discover issues via user prompt, using Gemini-planned iterative multi-agent exploration, supporting cross-module comparison.
**Syntax**:
```
```bash
/issue:discover-by-prompt [-y|--yes] <prompt> [--scope=src/**] [--depth=standard|deep] [--max-iterations=5]
```
@@ -151,7 +151,7 @@ interface Issue {
**Function**: Batch plan issue solutions, using issue-plan-agent (explore + plan closed loop).
**Syntax**:
```
```bash
/issue:plan [-y|--yes] --all-pending <issue-id>[,<issue-id>,...] [--batch-size 3]
```
@@ -176,7 +176,7 @@ interface Issue {
**Function**: Form execution queue from bound solutions, using issue-queue-agent (solution level).
**Syntax**:
```
```bash
/issue:queue [-y|--yes] [--queues <n>] [--issue <id>]
```
@@ -201,7 +201,7 @@ interface Issue {
**Function**: Execute queue, using DAG parallel orchestration (one commit per solution).
**Syntax**:
```
```bash
/issue:execute [-y|--yes] --queue <queue-id> [--worktree [<existing-path>]]
```
@@ -223,7 +223,7 @@ interface Issue {
**Function**: Convert planning artifact (lite-plan, workflow session, markdown) to issue solution.
**Syntax**:
```
```bash
/issue:convert-to-plan [-y|--yes] [--issue <id>] [--supplement] <source>
```
@@ -253,7 +253,7 @@ interface Issue {
**Function**: Convert brainstorm session ideas to issues and generate executable solutions.
**Syntax**:
```
```bash
/issue:from-brainstorm SESSION="session-id" [--idea=<index>] [--auto] [-y|--yes]
```