docs(zh-CN): translate code block(plain text) (#753)

Co-authored-by: neo <neo.dowithless@gmail.com>
This commit is contained in:
zdoc.app
2026-03-23 06:39:24 +08:00
committed by GitHub
parent fd2a8edb53
commit 4f6f587700
118 changed files with 1807 additions and 1835 deletions

View File

@@ -147,13 +147,13 @@ CLAW_SESSION=my-project CLAW_SKILLS=tdd-workflow,security-review node scripts/cl
### 架构:双提示系统
```
PROMPT 1 (Orchestrator) PROMPT 2 (Sub-Agents)
PROMPT 1(协调器) PROMPT 2(子代理)
┌─────────────────────┐ ┌──────────────────────┐
Parse spec file │ │ Receive full context
Scan output dir │ deploys │ Read assigned number
Plan iteration │────────────│ Follow spec exactly
Assign creative dirs │ N agents │ Generate unique output
Manage waves │ │ Save to output dir
解析规范文件 │ │ 接收完整上下文
扫描输出目录 │ 部署 │ 读取分配编号
规划迭代 │────────────│ 严格遵循规范
分配创作目录 │ N个代理 │ 生成唯一输出
管理批次 │ │ 保存至输出目录
└─────────────────────┘ └──────────────────────┘
```
@@ -218,20 +218,20 @@ PROMPT 1 (Orchestrator) PROMPT 2 (Sub-Agents)
```
┌─────────────────────────────────────────────────────┐
CONTINUOUS CLAUDE ITERATION
持续 CLAUDE 迭代
│ │
│ 1. Create branch (continuous-claude/iteration-N) │
│ 2. Run claude -p with enhanced prompt
│ 3. (Optional) Reviewer pass — separate claude -p │
│ 4. Commit changes (claude generates message)
│ 5. Push + create PR (gh pr create) │
│ 6. Wait for CI checks (poll gh pr checks) │
│ 7. CI failure? → Auto-fix pass (claude -p) │
│ 8. Merge PR (squash/merge/rebase) │
│ 9. Return to main → repeat
│ 1. 创建分支 (continuous-claude/iteration-N)
│ 2. 使用增强提示运行 claude -p
│ 3. (可选) 审查者通过 — 单独的 claude -p
│ 4. 提交更改 (claude 生成提交信息)
│ 5. 推送 + 创建 PR (gh pr create)
│ 6. 等待 CI 检查 (轮询 gh pr checks)
│ 7. CI 失败? → 自动修复通过 (claude -p)
│ 8. 合并 PR (squash/merge/rebase)
│ 9. 返回 main → 重复
│ │
Limit by: --max-runs N | --max-cost $X
│ --max-duration 2h | completion signal
限制条件: --max-runs N | --max-cost $X │
│ --max-duration 2h | 完成信号
└─────────────────────────────────────────────────────┘
```
@@ -390,27 +390,27 @@ done
### 架构概述
```
RFC/PRD Document
RFC/PRD 文档
DECOMPOSITION (AI)
Break RFC into work units with dependency DAG
分解(AI
将 RFC 分解为具有依赖关系 DAG 的工作单元
┌──────────────────────────────────────────────────────┐
│ RALPH LOOP (up to 3 passes)
│ RALPH 循环(最多 3 轮)
│ │
For each DAG layer (sequential, by dependency):
针对每个 DAG 层级(按依赖关系顺序):
│ │
│ ┌── Quality Pipelines (parallel per unit) ───────┐
│ │ Each unit in its own worktree:
│ │ Research → Plan → Implement → Test → Review │
│ │ (depth varies by complexity tier)
│ ┌── 质量流水线(每个单元并行) ───────┐
│ │ 每个单元在其独立的工作树中:
│ │ 研究 → 规划 → 实现 → 测试 → 评审 │
│ │ (深度根据复杂度层级变化) │
│ └────────────────────────────────────────────────┘ │
│ │
│ ┌── Merge Queue ─────────────────────────────────┐ │
│ │ Rebase onto main → Run tests → Land or evict │
│ │ Evicted units re-enter with conflict context │
│ ┌── 合并队列 ─────────────────────────────────┐
│ │ 变基到主分支 → 运行测试 → 合并或移除 │
│ │ 被移除的单元携带冲突上下文重新进入 │
│ └────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────┘
@@ -442,9 +442,9 @@ interface WorkUnit {
依赖关系 DAG 决定了执行顺序:
```
Layer 0: [unit-a, unit-b] ← no deps, run in parallel
Layer 1: [unit-c] ← depends on unit-a
Layer 2: [unit-d, unit-e] ← depend on unit-c
Layer 0: [unit-a, unit-b] ← 无依赖,并行运行
Layer 1: [unit-c] ← 依赖于 unit-a
Layer 2: [unit-d, unit-e] ← 依赖于 unit-c
```
### 复杂度层级
@@ -484,13 +484,13 @@ Layer 2: [unit-d, unit-e] ← depend on unit-c
```
Unit branch
├─ Rebase onto main
│ └─ Conflict? → EVICT (capture conflict context)
├─ 变基到 main 分支
│ └─ 冲突?→ 移除(捕获冲突上下文)
├─ Run build + tests
│ └─ Fail? → EVICT (capture test output)
├─ 运行构建 + 测试
│ └─ 失败?→ 移除(捕获测试输出)
└─ Pass → Fast-forward main, push, delete branch
└─ 通过 → 快进合并 main 分支,推送,删除分支
```
**文件重叠智能:**
@@ -513,13 +513,13 @@ Unit branch
### 阶段间的数据流
```
research.contextFilePath ──────────────────→ plan
plan.implementationSteps ──────────────────→ implement
implement.{filesCreated, whatWasDone} ─────→ test, reviews
test.failingSummary ───────────────────────→ reviews, implement (next pass)
reviews.{feedback, issues} ────────────────→ review-fix → implement (next pass)
final-review.reasoning ────────────────────→ implement (next pass)
evictionContext ───────────────────────────→ implement (after merge conflict)
research.contextFilePath ──────────────────→ 方案
plan.implementationSteps ──────────────────→ 实施
implement.{filesCreated, whatWasDone} ─────→ 测试, 审查
test.failingSummary ───────────────────────→ 审查, 实施(下一轮)
reviews.{feedback, issues} ────────────────→ 审查修复 → 实施(下一轮)
final-review.reasoning ────────────────────→ 实施(下一轮)
evictionContext ───────────────────────────→ 实施(合并冲突后)
```
### 工作树隔离
@@ -560,15 +560,15 @@ evictionContext ─────────────────────
### 决策矩阵
```
Is the task a single focused change?
├─ Yes → Sequential Pipeline or NanoClaw
└─ NoIs there a written spec/RFC?
├─ Yes → Do you need parallel implementation?
│ ├─ Yes → Ralphinho (DAG orchestration)
│ └─ No → Continuous Claude (iterative PR loop)
└─ NoDo you need many variations of the same thing?
├─ Yes → Infinite Agentic Loop (spec-driven generation)
└─ NoSequential Pipeline with de-sloppify
该任务是否是一个单一的、专注的变更?
├─ 是 → 顺序管道或NanoClaw
└─ 是否有书面的规范/RFC
├─ 有 → 是否需要并行实现?
│ ├─ → RalphinhoDAG编排)
│ └─ → Continuous Claude迭代式PR循环
└─ 是否需要同一事物的多种变体?
├─ 是 → 无限代理循环(规范驱动生成)
└─ 顺序管道与去杂乱化
```
### 模式组合