docs: 完成所有文档的中文翻译并应用到项目

2026-03-22 06:20:10 +00:00 · 2026-01-28 00:12:54 +08:00
parent 0ced59a26b
commit e133f58e1c
76 changed files with 6808 additions and 6170 deletions
--- a/skills/continuous-learning-v2/commands/evolve.md
+++ b/skills/continuous-learning-v2/commands/evolve.md
@@ -1,141 +1,141 @@
 ---
 name: evolve
-description: Cluster related instincts into skills, commands, or agents
+description: 将相关本能（Instincts）聚类为技能、命令或智能体
 command: /evolve
 implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve
 ---

-# Evolve Command
+# 演进（Evolve）命令

-## Implementation
+## 实现

 ```bash
 python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]
 ```

-Analyzes instincts and clusters related ones into higher-level structures:
- **Commands**: When instincts describe user-invoked actions
- **Skills**: When instincts describe auto-triggered behaviors
- **Agents**: When instincts describe complex, multi-step processes
+分析本能（Instincts）并将相关的本能聚类为更高级别的结构：
+- **命令（Commands）**：当本能描述的是用户调用的操作时
+- **技能（Skills）**：当本能描述的是自动触发的行为时
+- **智能体（Agents）**：当本能描述的是复杂的、多步骤的过程时

-## Usage
+## 用法

 ```
-/evolve                    # Analyze all instincts and suggest evolutions
-/evolve --domain testing   # Only evolve instincts in testing domain
-/evolve --dry-run          # Show what would be created without creating
-/evolve --threshold 5      # Require 5+ related instincts to cluster
+/evolve                    # 分析所有本能并建议演进方案
+/evolve --domain testing   # 仅演进测试领域（testing domain）中的本能
+/evolve --dry-run          # 显示将要创建的内容而不实际执行
+/evolve --threshold 5      # 要求 5 个或更多相关本能才进行聚类
 ```

-## Evolution Rules
+## 演进规则

-### → Command (User-Invoked)
-When instincts describe actions a user would explicitly request:
- Multiple instincts about "when user asks to..."
- Instincts with triggers like "when creating a new X"
- Instincts that follow a repeatable sequence
+### → 命令（Command，用户调用）
+当本能描述用户会显式请求的操作时：
+- 多个关于“当用户要求...”的本能
+- 带有“在创建新的 X 时”等触发器的本能
+- 遵循可重复序列的本能

-Example:
- `new-table-step1`: "when adding a database table, create migration"
- `new-table-step2`: "when adding a database table, update schema"
- `new-table-step3`: "when adding a database table, regenerate types"
+示例：
+- `new-table-step1`：“在添加数据库表时，创建迁移文件”
+- `new-table-step2`：“在添加数据库表时，更新 schema”
+- `new-table-step3`：“在添加数据库表时，重新生成类型”

-→ Creates: `/new-table` command
+→ 创建：`/new-table` 命令

-### → Skill (Auto-Triggered)
-When instincts describe behaviors that should happen automatically:
- Pattern-matching triggers
- Error handling responses
- Code style enforcement
+### → 技能（Skill，自动触发）
+当本能描述应该自动发生的行为时：
+- 模式匹配触发器
+- 错误处理响应
+- 代码风格强制执行

-Example:
- `prefer-functional`: "when writing functions, prefer functional style"
- `use-immutable`: "when modifying state, use immutable patterns"
- `avoid-classes`: "when designing modules, avoid class-based design"
+示例：
+- `prefer-functional`：“在编写函数时，优先使用函数式风格”
+- `use-immutable`：“在修改状态时，使用不可变模式”
+- `avoid-classes`：“在设计模块时，避免基于类的设计”

-→ Creates: `functional-patterns` skill
+→ 创建：`functional-patterns` 技能

-### → Agent (Needs Depth/Isolation)
-When instincts describe complex, multi-step processes that benefit from isolation:
- Debugging workflows
- Refactoring sequences
- Research tasks
+### → 智能体（Agent，需要深度/隔离）
+当本能描述受益于隔离的复杂、多步骤过程时：
+- 调试工作流（Workflow）
+- 重构序列
+- 研究任务

-Example:
- `debug-step1`: "when debugging, first check logs"
- `debug-step2`: "when debugging, isolate the failing component"
- `debug-step3`: "when debugging, create minimal reproduction"
- `debug-step4`: "when debugging, verify fix with test"
+示例：
+- `debug-step1`：“调试时，先检查日志”
+- `debug-step2`：“调试时，隔离故障组件”
+- `debug-step3`：“调试时，创建最小复现”
+- `debug-step4`：“调试时，通过测试验证修复”

-→ Creates: `debugger` agent
+→ 创建：`debugger` 智能体

-## What to Do
+## 执行步骤

-1. Read all instincts from `~/.claude/homunculus/instincts/`
-2. Group instincts by:
-   - Domain similarity
-   - Trigger pattern overlap
-   - Action sequence relationship
-3. For each cluster of 3+ related instincts:
-   - Determine evolution type (command/skill/agent)
-   - Generate the appropriate file
-   - Save to `~/.claude/homunculus/evolved/{commands,skills,agents}/`
-4. Link evolved structure back to source instincts
+1. 从 `~/.claude/homunculus/instincts/` 读取所有本能
+2. 按以下维度对本能进行分组：
+   - 领域相似性
+   - 触发模式重叠
+   - 动作序列关系
+3. 对于每个包含 3 个或更多相关本能的聚类：
+   - 确定演进类型（命令/技能/智能体）
+   - 生成相应的文件
+   - 保存到 `~/.claude/homunculus/evolved/{commands,skills,agents}/`
+4. 将演进后的结构链接回源本能

-## Output Format
+## 输出格式

 ```
-🧬 Evolve Analysis
+🧬 演进分析（Evolve Analysis）
 ==================

-Found 3 clusters ready for evolution:
+发现 3 个已准备好演进的聚类：

-## Cluster 1: Database Migration Workflow
-Instincts: new-table-migration, update-schema, regenerate-types
-Type: Command
-Confidence: 85% (based on 12 observations)
+## 聚类 1: 数据库迁移工作流
+本能: new-table-migration, update-schema, regenerate-types
+类型: 命令 (Command)
+置信度: 85% (基于 12 次观察)

-Would create: /new-table command
-Files:
+将创建: /new-table 命令
+文件:
  - ~/.claude/homunculus/evolved/commands/new-table.md

-## Cluster 2: Functional Code Style
-Instincts: prefer-functional, use-immutable, avoid-classes, pure-functions
-Type: Skill
-Confidence: 78% (based on 8 observations)
+## 聚类 2: 函数式代码风格
+本能: prefer-functional, use-immutable, avoid-classes, pure-functions
+类型: 技能 (Skill)
+置信度: 78% (基于 8 次观察)

-Would create: functional-patterns skill
-Files:
+将创建: functional-patterns 技能
+文件:
  - ~/.claude/homunculus/evolved/skills/functional-patterns.md

-## Cluster 3: Debugging Process
-Instincts: debug-check-logs, debug-isolate, debug-reproduce, debug-verify
-Type: Agent
-Confidence: 72% (based on 6 observations)
+## 聚类 3: 调试过程
+本能: debug-check-logs, debug-isolate, debug-reproduce, debug-verify
+类型: 智能体 (Agent)
+置信度: 72% (基于 6 次观察)

-Would create: debugger agent
-Files:
+将创建: debugger 智能体
+文件:
  - ~/.claude/homunculus/evolved/agents/debugger.md

 ---
-Run `/evolve --execute` to create these files.
+运行 `/evolve --execute` 来创建这些文件。
 ```

-## Flags
+## 标志（Flags）

- `--execute`: Actually create the evolved structures (default is preview)
- `--dry-run`: Preview without creating
- `--domain <name>`: Only evolve instincts in specified domain
- `--threshold <n>`: Minimum instincts required to form cluster (default: 3)
- `--type <command|skill|agent>`: Only create specified type
+- `--execute`：实际创建演进后的结构（默认为预览）
+- `--dry-run`：预览而不创建
+- `--domain <name>`：仅演进指定领域中的本能
+- `--threshold <n>`：形成聚类所需的最小本能数量（默认：3）
+- `--type <command|skill|agent>`：仅创建指定类型

-## Generated File Format
+## 生成文件格式

-### Command
+### 命令 (Command)
 ```markdown
 ---
 name: new-table
-description: Create a new database table with migration, schema update, and type generation
+description: 创建带有迁移、schema 更新和类型生成的数据库新表
 command: /new-table
 evolved_from:
  - new-table-migration
@@ -143,36 +143,36 @@ evolved_from:
  - regenerate-types
 ---

-# New Table Command
+# New Table 命令

-[Generated content based on clustered instincts]
+[基于聚类本能生成的具体内容]

-## Steps
+## 步骤
 1. ...
 2. ...
 ```

-### Skill
+### 技能 (Skill)
 ```markdown
 ---
 name: functional-patterns
-description: Enforce functional programming patterns
+description: 强制执行函数式编程模式
 evolved_from:
  - prefer-functional
  - use-immutable
  - avoid-classes
 ---

-# Functional Patterns Skill
+# Functional Patterns 技能

-[Generated content based on clustered instincts]
+[基于聚类本能生成的具体内容]
 ```

-### Agent
+### 智能体 (Agent)
 ```markdown
 ---
 name: debugger
-description: Systematic debugging agent
+description: 系统化调试智能体
 model: sonnet
 evolved_from:
  - debug-check-logs
@@ -180,7 +180,7 @@ evolved_from:
  - debug-reproduce
 ---

-# Debugger Agent
+# Debugger 智能体

-[Generated content based on clustered instincts]
+[基于聚类本能生成的具体内容]
 ```
--- a/skills/continuous-learning-v2/commands/instinct-export.md
+++ b/skills/continuous-learning-v2/commands/instinct-export.md
@@ -1,38 +1,38 @@
 ---
 name: instinct-export
-description: Export instincts for sharing with teammates or other projects
+description: 导出直觉（Instincts）以便与团队成员或其他项目共享
 command: /instinct-export
 ---

-# Instinct Export Command
+# 直觉导出命令（Instinct Export Command）

-Exports instincts to a shareable format. Perfect for:
- Sharing with teammates
- Transferring to a new machine
- Contributing to project conventions
+将直觉（Instincts）导出为可共享的格式。非常适用于：
+- 与团队成员共享
+- 迁移到新机器
+- 贡献到项目规范（Conventions）中

-## Usage
+## 使用方法

 ```
-/instinct-export                           # Export all personal instincts
-/instinct-export --domain testing          # Export only testing instincts
-/instinct-export --min-confidence 0.7      # Only export high-confidence instincts
+/instinct-export                           # 导出所有个人直觉
+/instinct-export --domain testing          # 仅导出测试（Testing）领域的直觉
+/instinct-export --min-confidence 0.7      # 仅导出高置信度的直觉
 /instinct-export --output team-instincts.yaml
 ```

-## What to Do
+## 执行逻辑

-1. Read instincts from `~/.claude/homunculus/instincts/personal/`
-2. Filter based on flags
-3. Strip sensitive information:
-   - Remove session IDs
-   - Remove file paths (keep only patterns)
-   - Remove timestamps older than "last week"
-4. Generate export file
+1. 从 `~/.claude/homunculus/instincts/personal/` 读取直觉数据
+2. 根据参数（Flags）进行过滤
+3. 脱敏敏感信息：
+   - 移除会话 ID（Session IDs）
+   - 移除文件路径（仅保留模式串/Patterns）
+   - 移除早于“上周”的时间戳
+4. 生成导出文件

-## Output Format
+## 输出格式

-Creates a YAML file:
+创建一个 YAML 文件：

 ```yaml
 # Instincts Export
@@ -67,25 +67,25 @@ instincts:
    observations: 6
 ```

-## Privacy Considerations
+## 隐私说明

-Exports include:
- ✅ Trigger patterns
- ✅ Actions
- ✅ Confidence scores
- ✅ Domains
- ✅ Observation counts
+导出内容**包含**：
+- ✅ 触发模式（Trigger patterns）
+- ✅ 动作（Actions）
+- ✅ 置信度评分（Confidence scores）
+- ✅ 领域（Domains）
+- ✅ 观测计数（Observation counts）

-Exports do NOT include:
- ❌ Actual code snippets
- ❌ File paths
- ❌ Session transcripts
- ❌ Personal identifiers
+导出内容**不包含**：
+- ❌ 实际代码片段
+- ❌ 文件路径
+- ❌ 会话转录（Session transcripts）
+- ❌ 个人身份标识符

-## Flags
+## 参数（Flags）

- `--domain <name>`: Export only specified domain
- `--min-confidence <n>`: Minimum confidence threshold (default: 0.3)
- `--output <file>`: Output file path (default: instincts-export-YYYYMMDD.yaml)
- `--format <yaml|json|md>`: Output format (default: yaml)
- `--include-evidence`: Include evidence text (default: excluded)
+- `--domain <name>`: 仅导出指定领域（Domain）
+- `--min-confidence <n>`: 最低置信度阈值（默认值：0.3）
+- `--output <file>`: 输出文件路径（默认值：instincts-export-YYYYMMDD.yaml）
+- `--format <yaml|json|md>`: 输出格式（默认值：yaml）
+- `--include-evidence`: 包含证据（Evidence）文本（默认：排除）
--- a/skills/continuous-learning-v2/commands/instinct-import.md
+++ b/skills/continuous-learning-v2/commands/instinct-import.md
@@ -1,25 +1,25 @@
 ---
 name: instinct-import
-description: Import instincts from teammates, Skill Creator, or other sources
+description: 从队友、技能生成器（Skill Creator）或其他来源导入直觉（Instincts）
 command: /instinct-import
 implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file>
 ---

-# Instinct Import Command
+# 直觉导入命令（Instinct Import Command）

-## Implementation
+## 实现

 ```bash
 python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7]
 ```

-Import instincts from:
- Teammates' exports
- Skill Creator (repo analysis)
- Community collections
- Previous machine backups
+从以下来源导入直觉（Instincts）：
+- 队友导出的文件
+- 技能生成器（Skill Creator）（仓库分析）
+- 社区集合
+- 之前的机器备份

-## Usage
+## 用法

 ```
 /instinct-import team-instincts.yaml
@@ -27,109 +27,109 @@ Import instincts from:
 /instinct-import --from-skill-creator acme/webapp
 ```

-## What to Do
+## 执行流程

-1. Fetch the instinct file (local path or URL)
-2. Parse and validate the format
-3. Check for duplicates with existing instincts
-4. Merge or add new instincts
-5. Save to `~/.claude/homunculus/instincts/inherited/`
+1. 获取直觉文件（本地路径或 URL）
+2. 解析并验证格式
+3. 检查是否与现有直觉重复
+4. 合并或添加新直觉
+5. 保存至 `~/.claude/homunculus/instincts/inherited/`

-## Import Process
+## 导入过程示例

 ```
-📥 Importing instincts from: team-instincts.yaml
+📥 正在从 team-instincts.yaml 导入直觉：
 ================================================

-Found 12 instincts to import.
+发现 12 条待导入的直觉。

-Analyzing conflicts...
+正在分析冲突...

-## New Instincts (8)
-These will be added:
-  ✓ use-zod-validation (confidence: 0.7)
-  ✓ prefer-named-exports (confidence: 0.65)
-  ✓ test-async-functions (confidence: 0.8)
+## 新直觉 (8)
+这些将被添加：
+  ✓ use-zod-validation (置信度: 0.7)
+  ✓ prefer-named-exports (置信度: 0.65)
+  ✓ test-async-functions (置信度: 0.8)
  ...

-## Duplicate Instincts (3)
-Already have similar instincts:
+## 重复直觉 (3)
+已存在类似的直觉：
  ⚠️ prefer-functional-style
-     Local: 0.8 confidence, 12 observations
-     Import: 0.7 confidence
-     → Keep local (higher confidence)
+     本地：0.8 置信度，12 个观测项
+     导入：0.7 置信度
+     → 保留本地（置信度更高）

  ⚠️ test-first-workflow
-     Local: 0.75 confidence
-     Import: 0.9 confidence
-     → Update to import (higher confidence)
+     本地：0.75 置信度
+     导入：0.9 置信度
+     → 更新为导入的内容（置信度更高）

-## Conflicting Instincts (1)
-These contradict local instincts:
+## 冲突直觉 (1)
+这些与本地直觉相矛盾：
  ❌ use-classes-for-services
-     Conflicts with: avoid-classes
-     → Skip (requires manual resolution)
+     与 avoid-classes 冲突
+     → 跳过（需要手动解决）

 ---
-Import 8 new, update 1, skip 3?
+导入 8 个新项，更新 1 个，跳过 3 个？
 ```

-## Merge Strategies
+## 合并策略（Merge Strategies）

-### For Duplicates
-When importing an instinct that matches an existing one:
- **Higher confidence wins**: Keep the one with higher confidence
- **Merge evidence**: Combine observation counts
- **Update timestamp**: Mark as recently validated
+### 处理重复项
+当导入的直觉与现有直觉匹配时：
+- **高置信度胜出**：保留置信度（Confidence）较高的一方
+- **合并证据**：累计观测项（Observation）计数
+- **更新时间戳**：标记为最近已验证

-### For Conflicts
-When importing an instinct that contradicts an existing one:
- **Skip by default**: Don't import conflicting instincts
- **Flag for review**: Mark both as needing attention
- **Manual resolution**: User decides which to keep
+### 处理冲突
+当导入的直觉与现有直觉冲突时：
+- **默认跳过**：不导入产生冲突的直觉
+- **标记待审查**：将两者都标记为需要关注
+- **手动解决**：由用户决定保留哪一个

-## Source Tracking
+## 来源追踪

-Imported instincts are marked with:
+导入的直觉会被标记以下字段：
 ```yaml
 source: "inherited"
 imported_from: "team-instincts.yaml"
 imported_at: "2025-01-22T10:30:00Z"
-original_source: "session-observation"  # or "repo-analysis"
+original_source: "session-observation"  # 或 "repo-analysis"
 ```

-## Skill Creator Integration
+## 技能生成器（Skill Creator）集成

-When importing from Skill Creator:
+从技能生成器（Skill Creator）导入时：

 ```
 /instinct-import --from-skill-creator acme/webapp
 ```

-This fetches instincts generated from repo analysis:
- Source: `repo-analysis`
- Higher initial confidence (0.7+)
- Linked to source repository
+这将获取通过仓库分析生成的直觉：
+- 来源：`repo-analysis`
+- 较高的初始置信度（0.7+）
+- 已链接到源仓库

-## Flags
+## 参数标志（Flags）

- `--dry-run`: Preview without importing
- `--force`: Import even if conflicts exist
- `--merge-strategy <higher|local|import>`: How to handle duplicates
- `--from-skill-creator <owner/repo>`: Import from Skill Creator analysis
- `--min-confidence <n>`: Only import instincts above threshold
+- `--dry-run`：预览而不执行导入
+- `--force`：即使存在冲突也强制导入
+- `--merge-strategy <higher|local|import>`：如何处理重复项
+- `--from-skill-creator <owner/repo>`：从技能生成器（Skill Creator）分析结果导入
+- `--min-confidence <n>`：仅导入置信度高于阈值的直觉

-## Output
+## 输出

-After import:
+导入完成后：
 ```
-✅ Import complete!
+✅ 导入完成！

-Added: 8 instincts
-Updated: 1 instinct
-Skipped: 3 instincts (2 duplicates, 1 conflict)
+已添加：8 条直觉
+已更新：1 条直觉
+已跳过：3 条直觉（2 个重复，1 个冲突）

-New instincts saved to: ~/.claude/homunculus/instincts/inherited/
+新直觉已保存至：~/.claude/homunculus/instincts/inherited/

-Run /instinct-status to see all instincts.
+运行 /instinct-status 查看所有直觉。
 ```
--- a/skills/continuous-learning-v2/commands/instinct-status.md
+++ b/skills/continuous-learning-v2/commands/instinct-status.md
@@ -1,21 +1,21 @@
 ---
 name: instinct-status
-description: Show all learned instincts with their confidence levels
+description: 显示所有已学习的直觉（Instincts）及其置信度水平
 command: /instinct-status
 implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py status
 ---

-# Instinct Status Command
+# Instinct Status 命令

-Shows all learned instincts with their confidence scores, grouped by domain.
+按领域（Domain）分组显示所有已学习的直觉（Instincts）及其置信度得分。

-## Implementation
+## 实现

 ```bash
 python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py status
 ```

-## Usage
+## 用法

 ```
 /instinct-status
@@ -23,57 +23,57 @@ python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py status
 /instinct-status --low-confidence
 ```

-## What to Do
+## 执行逻辑

-1. Read all instinct files from `~/.claude/homunculus/instincts/personal/`
-2. Read inherited instincts from `~/.claude/homunculus/instincts/inherited/`
-3. Display them grouped by domain with confidence bars
+1. 从 `~/.claude/homunculus/instincts/personal/` 读取所有个人直觉文件
+2. 从 `~/.claude/homunculus/instincts/inherited/` 读取继承的直觉
+3. 按领域分组显示，并附带置信度进度条

-## Output Format
+## 输出格式

 ```
-📊 Instinct Status
+📊 直觉状态 (Instinct Status)
 ==================

-## Code Style (4 instincts)
+## 代码风格 (4 个直觉)

 ### prefer-functional-style
-Trigger: when writing new functions
-Action: Use functional patterns over classes
-Confidence: ████████░░ 80%
-Source: session-observation | Last updated: 2025-01-22
+触发条件 (Trigger)：编写新函数时
+动作 (Action)：优先使用函数式模式而非类
+置信度 (Confidence)：████████░░ 80%
+来源 (Source)：session-observation | 最后更新：2025-01-22

 ### use-path-aliases
-Trigger: when importing modules
-Action: Use @/ path aliases instead of relative imports
-Confidence: ██████░░░░ 60%
-Source: repo-analysis (github.com/acme/webapp)
+触发条件 (Trigger)：导入模块时
+动作 (Action)：使用 @/ 路径别名而非相对导入
+置信度 (Confidence)：██████░░░░ 60%
+来源 (Source)：repo-analysis (github.com/acme/webapp)

-## Testing (2 instincts)
+## 测试 (2 个直觉)

 ### test-first-workflow
-Trigger: when adding new functionality
-Action: Write test first, then implementation
-Confidence: █████████░ 90%
-Source: session-observation
+触发条件 (Trigger)：添加新功能时
+动作 (Action)：先写测试，再写实现
+置信度 (Confidence)：█████████░ 90%
+来源 (Source)：session-observation

-## Workflow (3 instincts)
+## 工作流 (3 个直觉)

 ### grep-before-edit
-Trigger: when modifying code
-Action: Search with Grep, confirm with Read, then Edit
-Confidence: ███████░░░ 70%
-Source: session-observation
+触发条件 (Trigger)：修改代码时
+动作 (Action)：先用 Grep 搜索，用 Read 确认，再进行编辑 (Edit)
+置信度 (Confidence)：███████░░░ 70%
+来源 (Source)：session-observation

 ---
-Total: 9 instincts (4 personal, 5 inherited)
-Observer: Running (last analysis: 5 min ago)
+总计：9 个直觉（4 个个人，5 个继承）
+观察器 (Observer)：运行中（上次分析：5 分钟前）
 ```

-## Flags
+## 参数 (Flags)

- `--domain <name>`: Filter by domain (code-style, testing, git, etc.)
- `--low-confidence`: Show only instincts with confidence < 0.5
- `--high-confidence`: Show only instincts with confidence >= 0.7
- `--source <type>`: Filter by source (session-observation, repo-analysis, inherited)
- `--json`: Output as JSON for programmatic use
+- `--domain <name>`：按领域过滤（code-style、testing、git 等）
+- `--low-confidence`：仅显示置信度 < 0.5 的直觉
+- `--high-confidence`：仅显示置信度 >= 0.7 的直觉
+- `--source <type>`：按来源过滤（session-observation、repo-analysis、inherited）
+- `--json`：以 JSON 格式输出，供程序化使用