diff --git a/4 - Resources/Everything Claude Code 方法论与最佳实践.md b/4 - Resources/Everything Claude Code 方法论与最佳实践.md
index 2072739..a7ac6f1 100644
--- a/4 - Resources/Everything Claude Code 方法论与最佳实践.md	
+++ b/4 - Resources/Everything Claude Code 方法论与最佳实践.md	
@@ -9,6 +9,29 @@ source: "https://github.com/affaan-m/everything-claude-code"
 
 深度分析 ECC 的六大核心方法论、社区最佳实践、常见陷阱与实战例子。组件列表见 [[Everything Claude Code 完整指南]]，按场景速查见 [[Everything Claude Code 用法速查]]。
 
+> **命令命名空间**: 通过插件安装的 ECC，所有命令需要加 `everything-claude-code:` 前缀（如 `/everything-claude-code:plan`）。手动安装到 `~/.claude/commands/` 的可用短名（如 `/plan`）。本文中用 **短名** 书写以保持可读性，实际使用时请加前缀。`/compact` 是 Claude Code 内置命令，无需前缀。
+
+**命令名映射速查**:
+
+| 短名 | 插件全名 |
+|------|---------|
+| `/plan` | `/everything-claude-code:plan` |
+| `/tdd` | `/everything-claude-code:tdd` |
+| `/verify` | `/everything-claude-code:verify` |
+| `/learn` | `/everything-claude-code:learn-eval` |
+| `/evolve` | `/everything-claude-code:evolve` |
+| `/claw` | `/everything-claude-code:claw` |
+| `/e2e` | `/everything-claude-code:e2e` |
+| `/orchestrate` | `/everything-claude-code:plan` (含编排) |
+| `/search-first` | `/everything-claude-code:search-first` |
+| `/eval` | `/everything-claude-code:eval-harness` |
+| `/instinct-export` | `/everything-claude-code:instinct-export` |
+| `/instinct-import` | `/everything-claude-code:instinct-import` |
+| `/instinct-status` | `/everything-claude-code:instinct-status` |
+| `/configure-ecc` | `/everything-claude-code:configure-ecc` |
+| `/security-scan` | `/everything-claude-code:security-scan` |
+| `/compact` | `/compact` (内置，无需前缀) |
+
 ---
 
 ## 一、六大核心方法论
diff --git a/4 - Resources/Everything Claude Code 用法速查.md b/4 - Resources/Everything Claude Code 用法速查.md
index 8d8c3f3..6126757 100644
--- a/4 - Resources/Everything Claude Code 用法速查.md	
+++ b/4 - Resources/Everything Claude Code 用法速查.md	
@@ -7,7 +7,9 @@ source: "https://github.com/affaan-m/everything-claude-code"
 
 # Everything Claude Code 用法速查
 
-按使用场景分类的快速参考手册。组件完整列表见 [[Everything Claude Code 完整指南]]。
+按使用场景分类的快速参考手册。组件完整列表见 [[Everything Claude Code 完整指南]]。方法论深度分析见 [[Everything Claude Code 方法论与最佳实践]]。
+
+> **命名空间**: 通过插件安装的 ECC，命令需加 `everything-claude-code:` 前缀。本文用短名书写，实际使用时如 `/plan` → `/everything-claude-code:plan`。完整映射表见 [[Everything Claude Code 方法论与最佳实践#命令名映射速查]]。
 
 ---