From b1d03833b944dad5341da5d2cbfdbb842d6e3968 Mon Sep 17 00:00:00 2001
From: xuxiang <xuxiang@cestc.cn>
Date: Sat, 31 Jan 2026 18:22:06 +0800
Subject: [PATCH] chore: sync with upstream ae2c063 + update zh translations

---
 .claude-plugin/PLUGIN_SCHEMA_NOTES.md         | 122 +++--
 .claude-plugin/README.md                      |   5 +
 .claude-plugin/plugin.json                    |  11 +-
 .github/PULL_REQUEST_TEMPLATE.md              |  17 +
 .github/workflows/ci.yml                      | 218 +++++++++
 .github/workflows/maintenance.yml             |  51 +++
 .github/workflows/release.yml                 |  47 ++
 .github/workflows/reusable-release.yml        |  59 +++
 .github/workflows/reusable-test.yml           | 130 ++++++
 .github/workflows/reusable-validate.yml       |  40 ++
 .gitignore                                    |   3 +
 README.md                                     | 351 +++++++++------
 agents/database-reviewer.md                   | 342 +++++++-------
 docs/zh-TW/README.md                          | 424 ++++++++++++++++++
 hooks/hooks.json                              |   2 +-
 scripts/hooks/check-console-log.js            |   2 +-
 scripts/hooks/session-end.js                  |   1 -
 scripts/hooks/session-start.js                |   1 -
 scripts/hooks/suggest-compact.js              |   1 -
 scripts/lib/package-manager.js                |   2 +-
 scripts/lib/utils.js                          |  33 +-
 scripts/setup-package-manager.js              |   4 +-
 skills/continuous-learning-v2/SKILL.md        | 169 ++++---
 .../continuous-learning-v2/commands/evolve.md |  26 +-
 .../commands/instinct-import.md               |   2 +-
 .../continuous-learning-v2/hooks/observe.sh   |  20 +-
 tests/hooks/hooks.test.js                     |  33 +-
 tests/lib/package-manager.test.js             |   1 -
 tests/lib/utils.test.js                       |  57 ++-
 translation_workdir/cache/translation_db.json |  36 +-
 30 files changed, 1694 insertions(+), 516 deletions(-)
 create mode 100644 .claude-plugin/README.md
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 .github/workflows/maintenance.yml
 create mode 100644 .github/workflows/release.yml
 create mode 100644 .github/workflows/reusable-release.yml
 create mode 100644 .github/workflows/reusable-test.yml
 create mode 100644 .github/workflows/reusable-validate.yml
 create mode 100644 docs/zh-TW/README.md

diff --git a/.claude-plugin/PLUGIN_SCHEMA_NOTES.md b/.claude-plugin/PLUGIN_SCHEMA_NOTES.md
index fca1cdb..f9409f2 100644
--- a/.claude-plugin/PLUGIN_SCHEMA_NOTES.md
+++ b/.claude-plugin/PLUGIN_SCHEMA_NOTES.md
@@ -1,22 +1,22 @@
-# 插件清单模式（Manifest Schema）注意事项
+# 插件清单模式（Plugin Manifest Schema）说明
 
-本文档记录了 Claude Code 插件清单校验器中**未见于文档但强制执行的约束**。
+本文档记录了 Claude Code 插件清单校验器（Validator）中**未公开但强制执行的约束条件**。
 
-这些规则基于真实的安装失败案例、校验器行为以及与已知可用插件的对比。
-设置这些规则是为了防止隐性故障和重复的回归问题。
+这些规则基于真实的安装失败案例、校验器行为分析以及与已知可用插件的对比。
+它们的存在是为了防止隐性破坏（silent breakage）和重复出现的回归（regressions）问题。
 
-如果你编辑 `.claude-plugin/plugin.json`，请先阅读本文。
+如果你需要编辑 `.claude-plugin/plugin.json`，请务必先阅读本文。
 
 ---
 
 ## 摘要（优先阅读）
 
-Claude 插件清单校验器**极其严格且具有主观性**。
-它执行了一些在公开模式（Schema）参考文档中未完全说明的规则。
+Claude 插件清单校验器非常**严格且具有确定性**。
+它强制执行了一些在公共模式（Schema）引用中未完全记录的规则。
 
 最常见的失败模式是：
 
-> 清单看起来很合理，但校验器以模糊的错误拒绝它，例如：
+> 清单看起来很合理，但校验器拒绝了它，并给出模糊的错误提示，例如
 > `agents: Invalid input`
 
 本文档将解释其原因。
@@ -25,11 +25,11 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 
 ## 必填字段
 
-### `version`（强制性）
+### `version`（强制要求）
 
-即便在某些示例中被省略，校验器也要求必须包含 `version` 字段。
+校验器要求必须包含 `version` 字段，即使在某些示例中省略了它。
 
-如果缺失，在应用市场安装或 CLI 校验期间可能会失败。
+如果缺失该字段，在应用市场安装或 CLI 校验期间可能会失败。
 
 示例：
 
@@ -50,9 +50,9 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 * `skills`
 * `hooks`（如果存在）
 
-即便只有一个条目，**也不接受字符串（Strings）**。
+即使只有一个条目，**也不接受字符串（Strings）类型**。
 
-### 错误写法（Invalid）
+### 错误示例（Invalid）
 
 ```json
 {
@@ -60,7 +60,7 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 }
 ```
 
-### 正确写法（Valid）
+### 正确示例（Valid）
 
 ```json
 {
@@ -68,17 +68,17 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 }
 ```
 
-这适用于所有组件路径字段。
+这一规则一致适用于所有组件路径字段。
 
 ---
 
-## 路径解析规则（至关重要）
+## 路径解析规则（关键）
 
 ### Agents 必须使用显式文件路径
 
-校验器**不接受 `agents` 使用目录路径**。
+校验器**不接受 `agents` 字段使用目录路径**。
 
-即便如下写法也会失败：
+即使是以下写法也会失败：
 
 ```json
 {
@@ -86,7 +86,7 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 }
 ```
 
-相反，你必须显式列举智能体（Agent）文件：
+相反，你必须显式枚举智能体（Agent）文件：
 
 ```json
 {
@@ -100,21 +100,58 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 
 这是校验错误最常见的来源。
 
-### Commands 和 Skills
+### 命令（Commands）与技能（Skills）
 
-* `commands` 和 `skills` 仅在**包裹在数组中**时才接受目录路径。
-* 使用显式文件路径是最安全且面向未来的做法。
+* `commands` 和 `skills` **仅在包裹在数组中时**接受目录路径。
+* 显式文件路径是最安全且最能兼容未来的做法。
 
 ---
 
-## 校验器行为备注
+## 校验器行为注意事项
 
-* `claude plugin validate` 比某些应用市场预览更严格。
-* 校验可能在本地通过，但如果路径含义模糊，则在安装时可能会失败。
-* 错误通常很笼统（`Invalid input`），且不指示根本原因。
+* `claude plugin validate` 比某些应用市场预览（marketplace previews）更严格。
+* 校验可能在本地通过，但如果路径含义模糊，在安装时可能会失败。
+* 错误提示通常很通用（`Invalid input`），且不会指出根本原因。
 * 跨平台安装（尤其是 Windows）对路径假设的容忍度较低。
 
-请假设校验器是“带有敌意的”且完全字面化的。
+请假设校验器是严苛且完全按字面意思理解的。
+
+---
+
+## `hooks` 字段：请勿添加
+
+> ⚠️ **关键（CRITICAL）：** 请勿在 `plugin.json` 中添加 `"hooks"` 字段。这是一个回归测试强制要求的规则。
+
+### 为什么这很重要
+
+按照约定，Claude Code v2.1+ 会**自动加载**任何已安装插件中的 `hooks/hooks.json`。如果你在 `plugin.json` 中也声明了它，你会得到：
+
+```
+Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file.
+The standard hooks/hooks.json is loaded automatically, so manifest.hooks should
+only reference additional hook files.
+```
+
+### 反复变更的历史
+
+这曾导致此仓库中出现多次“修复/回滚”循环：
+
+| 提交 | 动作 | 触发原因 |
+|--------|--------|---------|
+| `22ad036` | 添加（ADD）hooks | 用户报告“钩子未加载” |
+| `a7bc5f2` | 移除（REMOVE）hooks | 用户报告“重复钩子错误” (#52) |
+| `779085e` | 添加（ADD）hooks | 用户报告“智能体未加载” (#88) |
+| `e3a1306` | 移除（REMOVE）hooks | 用户报告“重复钩子错误” (#103) |
+
+**根本原因：** Claude Code CLI 在不同版本间更改了行为：
+- v2.1 之前：需要显式声明 `hooks`。
+- v2.1+：按约定自动加载，显式声明会导致重复错误。
+
+### 当前规则（由测试强制执行）
+
+`tests/hooks/hooks.test.js` 中的测试 `plugin.json does NOT have explicit hooks declaration` 会阻止重新引入此声明。
+
+**如果你要添加额外的钩子文件**（非 `hooks/hooks.json`），可以声明它们。但标准路径 `hooks/hooks.json` **绝不能**被声明。
 
 ---
 
@@ -123,16 +160,17 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 这些看起来正确但会被拒绝：
 
 * 使用字符串值而非数组
-* 为 `agents` 提供目录数组
+* 在 `agents` 中使用目录数组
 * 缺失 `version`
 * 依赖推断路径
-* 假设应用市场的行为与本地校验一致
+* 假设应用市场行为与本地校验一致
+* **添加 `"hooks": "./hooks/hooks.json"`** —— 按约定自动加载，会导致重复错误
 
-不要耍小聪明。请保持显式。
+不要尝试“取巧”，请保持显式声明。
 
 ---
 
-## 最小已知有效示例
+## 最小已知可用示例
 
 ```json
 {
@@ -146,35 +184,37 @@ Claude 插件清单校验器**极其严格且具有主观性**。
 }
 ```
 
-该结构已通过 Claude 插件校验器的验证。
+此结构已通过 Claude 插件校验器的验证。
+
+**重要提示：** 请注意这里**没有** `"hooks"` 字段。`hooks/hooks.json` 文件会按约定自动加载。显式添加它会导致重复错误。
 
 ---
 
-## 对贡献者的建议
+## 贡献者建议
 
-在提交涉及 `plugin.json` 的更改之前：
+在提交涉及 `plugin.json` 的更改前：
 
-1. 为 agents 使用显式文件路径
+1. 为智能体（Agents）使用显式文件路径
 2. 确保所有组件字段均为数组
-3. 包含 `version`
-4. 运行：
+3. 包含 `version` 字段
+4. 运行以下命令：
 
 ```bash
 claude plugin validate .claude-plugin/plugin.json
 ```
 
-如有疑问，宁可繁琐也不要追求便利。
+如有疑问，宁可繁琐也不要为了方便而导致解析失败。
 
 ---
 
 ## 为什么存在此文件
 
-此仓库被广泛 fork 并用作参考实现。
+此仓库被广泛 Fork 并作为参考实现。
 
-在此记录校验器的特性：
+在此记录校验器的奇特行为（quirks）是为了：
 
 * 防止重复出现的问题
 * 减少贡献者的挫败感
 * 随着生态系统的演进保持插件的稳定性
 
-如果校验器发生变化，请首先更新本文档。
+如果校验器规则发生变化，请首先更新此文档。
diff --git a/.claude-plugin/README.md b/.claude-plugin/README.md
new file mode 100644
index 0000000..a3c4dfb
--- /dev/null
+++ b/.claude-plugin/README.md
@@ -0,0 +1,5 @@
+### 插件清单注意事项（Plugin Manifest Gotchas）
+
+如果你计划编辑 `.claude-plugin/plugin.json`，请注意 Claude 插件验证器（plugin validator）强制执行了一些**未公开但严格的约束**，这些约束可能导致安装失败并显示模糊的错误（例如，`agents: Invalid input`）。特别是，组件字段必须是数组（arrays），`agents` 必须使用明确的文件路径而非目录，且为了实现可靠的验证和安装，必须包含 `version` 字段。
+
+这些约束在公开示例中并不明显，且在过去曾多次导致安装失败。它们在 `.claude-plugin/PLUGIN_SCHEMA_NOTES.md` 中有详细记录，在对插件清单（plugin manifest）进行任何更改之前，应仔细阅读该文档。
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 3186376..a90f4e5 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "everything-claude-code",
-  "version": "1.0.0",
-  "description": "Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, commands, and rules evolved over 10+ months of intensive daily use",
+  "version": "1.2.0",
+  "description": "Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use",
   "author": {
     "name": "Affaan Mustafa",
     "url": "https://x.com/affaanmustafa"
@@ -14,7 +14,6 @@
     "agents",
     "skills",
     "hooks",
-    "commands",
     "rules",
     "tdd",
     "code-review",
@@ -23,8 +22,7 @@
     "automation",
     "best-practices"
   ],
-  "commands": ["./commands/"],
-  "skills": ["./skills/"],
+  "skills": ["./skills/", "./commands/"],
   "agents": [
     "./agents/architect.md",
     "./agents/build-error-resolver.md",
@@ -38,6 +36,5 @@
     "./agents/refactor-cleaner.md",
     "./agents/security-reviewer.md",
     "./agents/tdd-guide.md"
-  ],
-  "hooks": "./hooks/hooks.json"
+  ]
 }
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..7dc3060
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,17 @@
+## Description
+<!-- Brief description of changes -->
+
+## Type of Change
+- [ ] `fix:` Bug fix
+- [ ] `feat:` New feature
+- [ ] `refactor:` Code refactoring
+- [ ] `docs:` Documentation
+- [ ] `test:` Tests
+- [ ] `chore:` Maintenance/tooling
+- [ ] `ci:` CI/CD changes
+
+## Checklist
+- [ ] Tests pass locally (`node tests/run-all.js`)
+- [ ] Validation scripts pass
+- [ ] Follows conventional commits format
+- [ ] Updated relevant documentation
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..e4d61e2
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,218 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Prevent duplicate runs
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+# Minimal permissions
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test (${{ matrix.os }}, Node ${{ matrix.node }}, ${{ matrix.pm }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node: ['18.x', '20.x', '22.x']
+        pm: [npm, pnpm, yarn, bun]
+        exclude:
+          # Bun has limited Windows support
+          - os: windows-latest
+            pm: bun
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+
+      # Package manager setup
+      - name: Setup pnpm
+        if: matrix.pm == 'pnpm'
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: Setup Bun
+        if: matrix.pm == 'bun'
+        uses: oven-sh/setup-bun@v2
+
+      # Cache configuration
+      - name: Get npm cache directory
+        if: matrix.pm == 'npm'
+        id: npm-cache-dir
+        shell: bash
+        run: echo "dir=$(npm config get cache)" >> $GITHUB_OUTPUT
+
+      - name: Cache npm
+        if: matrix.pm == 'npm'
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.npm-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ matrix.node }}-npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ matrix.node }}-npm-
+
+      - name: Get pnpm store directory
+        if: matrix.pm == 'pnpm'
+        id: pnpm-cache-dir
+        shell: bash
+        run: echo "dir=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Cache pnpm
+        if: matrix.pm == 'pnpm'
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pnpm-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ matrix.node }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ matrix.node }}-pnpm-
+
+      - name: Get yarn cache directory
+        if: matrix.pm == 'yarn'
+        id: yarn-cache-dir
+        shell: bash
+        run: |
+          # Try Yarn Berry first, fall back to Yarn v1
+          if yarn config get cacheFolder >/dev/null 2>&1; then
+            echo "dir=$(yarn config get cacheFolder)" >> $GITHUB_OUTPUT
+          else
+            echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Cache yarn
+        if: matrix.pm == 'yarn'
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.yarn-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ matrix.node }}-yarn-${{ hashFiles('**/yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ matrix.node }}-yarn-
+
+      - name: Cache bun
+        if: matrix.pm == 'bun'
+        uses: actions/cache@v4
+        with:
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      # Install dependencies
+      - name: Install dependencies
+        shell: bash
+        run: |
+          case "${{ matrix.pm }}" in
+            npm) npm ci ;;
+            pnpm) pnpm install ;;
+            # --ignore-engines required for Node 18 compat with some devDependencies (e.g., markdownlint-cli)
+            yarn) yarn install --ignore-engines ;;
+            bun) bun install ;;
+            *) echo "Unsupported package manager: ${{ matrix.pm }}" && exit 1 ;;
+          esac
+
+      # Run tests
+      - name: Run tests
+        run: node tests/run-all.js
+        env:
+          CLAUDE_CODE_PACKAGE_MANAGER: ${{ matrix.pm }}
+
+      # Upload test artifacts on failure
+      - name: Upload test artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-${{ matrix.os }}-node${{ matrix.node }}-${{ matrix.pm }}
+          path: |
+            tests/
+            !tests/node_modules/
+
+  validate:
+    name: Validate Components
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Validate agents
+        run: node scripts/ci/validate-agents.js
+        continue-on-error: false
+
+      - name: Validate hooks
+        run: node scripts/ci/validate-hooks.js
+        continue-on-error: false
+
+      - name: Validate commands
+        run: node scripts/ci/validate-commands.js
+        continue-on-error: false
+
+      - name: Validate skills
+        run: node scripts/ci/validate-skills.js
+        continue-on-error: false
+
+      - name: Validate rules
+        run: node scripts/ci/validate-rules.js
+        continue-on-error: false
+
+  security:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Run npm audit
+        run: npm audit --audit-level=high
+        continue-on-error: true  # Allows PR to proceed, but marks job as failed if vulnerabilities found
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npx eslint scripts/**/*.js tests/**/*.js
+
+      - name: Run markdownlint
+        run: npx markdownlint "agents/**/*.md" "skills/**/*.md" "commands/**/*.md" "rules/**/*.md"
diff --git a/.github/workflows/maintenance.yml b/.github/workflows/maintenance.yml
new file mode 100644
index 0000000..5d30084
--- /dev/null
+++ b/.github/workflows/maintenance.yml
@@ -0,0 +1,51 @@
+name: Scheduled Maintenance
+
+on:
+  schedule:
+    - cron: '0 9 * * 1'  # Weekly Monday 9am UTC
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  dependency-check:
+    name: Check Dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+      - name: Check for outdated packages
+        run: npm outdated || true
+
+  security-audit:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+      - name: Run security audit
+        run: |
+          if [ -f package-lock.json ]; then
+            npm ci
+            npm audit --audit-level=high
+          else
+            echo "No package-lock.json found; skipping npm audit"
+          fi
+
+  stale:
+    name: Stale Issues/PRs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          stale-issue-message: 'This issue is stale due to inactivity.'
+          stale-pr-message: 'This PR is stale due to inactivity.'
+          days-before-stale: 30
+          days-before-close: 7
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..43947b5
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*']
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate version tag
+        run: |
+          if ! [[ "${{ github.ref_name }}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Invalid version tag format. Expected vX.Y.Z"
+            exit 1
+          fi
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -z "$PREV_TAG" ]; then
+            COMMITS=$(git log --pretty=format:"- %s" HEAD)
+          else
+            COMMITS=$(git log --pretty=format:"- %s" ${PREV_TAG}..HEAD)
+          fi
+          echo "commits<<EOF" >> $GITHUB_OUTPUT
+          echo "$COMMITS" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body: |
+            ## Changes
+            ${{ steps.changelog.outputs.commits }}
+          generate_release_notes: false
diff --git a/.github/workflows/reusable-release.yml b/.github/workflows/reusable-release.yml
new file mode 100644
index 0000000..b711991
--- /dev/null
+++ b/.github/workflows/reusable-release.yml
@@ -0,0 +1,59 @@
+name: Reusable Release Workflow
+
+on:
+  workflow_call:
+    inputs:
+      tag:
+        description: 'Version tag (e.g., v1.0.0)'
+        required: true
+        type: string
+      generate-notes:
+        description: 'Auto-generate release notes'
+        required: false
+        type: boolean
+        default: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate version tag
+        run: |
+          if ! [[ "${{ inputs.tag }}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Invalid version tag format. Expected vX.Y.Z"
+            exit 1
+          fi
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -z "$PREV_TAG" ]; then
+            COMMITS=$(git log --pretty=format:"- %s" HEAD)
+          else
+            COMMITS=$(git log --pretty=format:"- %s" ${PREV_TAG}..HEAD)
+          fi
+          # Use unique delimiter to prevent truncation if commit messages contain EOF
+          DELIMITER="COMMITS_END_$(date +%s)"
+          echo "commits<<${DELIMITER}" >> $GITHUB_OUTPUT
+          echo "$COMMITS" >> $GITHUB_OUTPUT
+          echo "${DELIMITER}" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ inputs.tag }}
+          body: |
+            ## Changes
+            ${{ steps.changelog.outputs.commits }}
+          generate_release_notes: ${{ inputs.generate-notes }}
diff --git a/.github/workflows/reusable-test.yml b/.github/workflows/reusable-test.yml
new file mode 100644
index 0000000..ff90724
--- /dev/null
+++ b/.github/workflows/reusable-test.yml
@@ -0,0 +1,130 @@
+name: Reusable Test Workflow
+
+on:
+  workflow_call:
+    inputs:
+      os:
+        description: 'Operating system'
+        required: false
+        type: string
+        default: 'ubuntu-latest'
+      node-version:
+        description: 'Node.js version'
+        required: false
+        type: string
+        default: '20.x'
+      package-manager:
+        description: 'Package manager to use'
+        required: false
+        type: string
+        default: 'npm'
+
+jobs:
+  test:
+    name: Test
+    runs-on: ${{ inputs.os }}
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ inputs.node-version }}
+
+      - name: Setup pnpm
+        if: inputs.package-manager == 'pnpm'
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: Setup Bun
+        if: inputs.package-manager == 'bun'
+        uses: oven-sh/setup-bun@v2
+
+      - name: Get npm cache directory
+        if: inputs.package-manager == 'npm'
+        id: npm-cache-dir
+        shell: bash
+        run: echo "dir=$(npm config get cache)" >> $GITHUB_OUTPUT
+
+      - name: Cache npm
+        if: inputs.package-manager == 'npm'
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.npm-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ inputs.node-version }}-npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ inputs.node-version }}-npm-
+
+      - name: Get pnpm store directory
+        if: inputs.package-manager == 'pnpm'
+        id: pnpm-cache-dir
+        shell: bash
+        run: echo "dir=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Cache pnpm
+        if: inputs.package-manager == 'pnpm'
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pnpm-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ inputs.node-version }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ inputs.node-version }}-pnpm-
+
+      - name: Get yarn cache directory
+        if: inputs.package-manager == 'yarn'
+        id: yarn-cache-dir
+        shell: bash
+        run: |
+          # Try Yarn Berry first, fall back to Yarn v1
+          if yarn config get cacheFolder >/dev/null 2>&1; then
+            echo "dir=$(yarn config get cacheFolder)" >> $GITHUB_OUTPUT
+          else
+            echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Cache yarn
+        if: inputs.package-manager == 'yarn'
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.yarn-cache-dir.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ inputs.node-version }}-yarn-${{ hashFiles('**/yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ inputs.node-version }}-yarn-
+
+      - name: Cache bun
+        if: inputs.package-manager == 'bun'
+        uses: actions/cache@v4
+        with:
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
+
+      - name: Install dependencies
+        shell: bash
+        run: |
+          case "${{ inputs.package-manager }}" in
+            npm) npm ci ;;
+            pnpm) pnpm install ;;
+            yarn) yarn install --ignore-engines ;;
+            bun) bun install ;;
+            *) echo "Unsupported package manager: ${{ inputs.package-manager }}" && exit 1 ;;
+          esac
+
+      - name: Run tests
+        run: node tests/run-all.js
+        env:
+          CLAUDE_CODE_PACKAGE_MANAGER: ${{ inputs.package-manager }}
+
+      - name: Upload test artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-${{ inputs.os }}-node${{ inputs.node-version }}-${{ inputs.package-manager }}
+          path: |
+            tests/
+            !tests/node_modules/
diff --git a/.github/workflows/reusable-validate.yml b/.github/workflows/reusable-validate.yml
new file mode 100644
index 0000000..1d0da8f
--- /dev/null
+++ b/.github/workflows/reusable-validate.yml
@@ -0,0 +1,40 @@
+name: Reusable Validation Workflow
+
+on:
+  workflow_call:
+    inputs:
+      node-version:
+        description: 'Node.js version'
+        required: false
+        type: string
+        default: '20.x'
+
+jobs:
+  validate:
+    name: Validate Components
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ inputs.node-version }}
+
+      - name: Validate agents
+        run: node scripts/ci/validate-agents.js
+
+      - name: Validate hooks
+        run: node scripts/ci/validate-hooks.js
+
+      - name: Validate commands
+        run: node scripts/ci/validate-commands.js
+
+      - name: Validate skills
+        run: node scripts/ci/validate-skills.js
+
+      - name: Validate rules
+        run: node scripts/ci/validate-rules.js
diff --git a/.gitignore b/.gitignore
index d947b2c..31ba5f1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -27,3 +27,6 @@ private/
 
 # Session templates (not committed)
 examples/sessions/*.tmp
+
+# Local drafts
+marketing/
diff --git a/README.md b/README.md
index 59ee7b2..272b54d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-# Everything Claude Code (Claude Code 全集)
+**语言：** [English](README.md) | 繁體中文
+
+# Everything Claude Code
 
 [![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -7,49 +9,54 @@
 ![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)
 ![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)
 
-**来自 Anthropic 黑客松获胜者的 Claude Code 配置完整合集。**
+<p align="left">
+  <a href="README.md">English</a> |
+  <span>简体中文</span>
+</p>
 
-包含生产级智能体（Agents）、技能（Skills）、钩子（Hooks）、命令（Commands）、规约（Rules）以及 MCP 配置，这些都是在超过 10 个月的真实产品开发与深度日常使用中演进出来的。
+**由 Anthropic 黑客松获胜者整理的 Claude Code 配置完整合集。**
+
+这是在 10 个月以上高强度日常开发真实产品的过程中，不断演进出的生产级智能体（Agents）、技能（Skills）、钩子（Hooks）、命令（Commands）、规则（Rules）以及 MCP 配置。
 
 ---
 
-## 指南文档
+## 指南（The Guides）
 
-本仓库仅包含原始代码。以下指南将解释一切。
+本仓库仅包含原始代码。以下指南将解释所有细节。
 
 <table>
 <tr>
 <td width="50%">
-<a href="https://x.com/affaanmustafa/status/2012378465664745795">
-<img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="The Shorthand Guide to Everything Claude Code" />
+<a href="the-shortform-guide_zh.md">
+<img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="Everything Claude Code 简明指南" />
 </a>
 </td>
 <td width="50%">
-<a href="https://x.com/affaanmustafa/status/2014040193557471352">
-<img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="The Longform Guide to Everything Claude Code" />
+<a href="the-longform-guide.md">
+<img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="Everything Claude Code 深度指南" />
 </a>
 </td>
 </tr>
 <tr>
-<td align="center"><b>简明指南 (Shorthand Guide)</b><br/>安装设置、基础概念与哲学。<b>请先阅读此篇。</b></td>
-<td align="center"><b>深度指南 (Longform Guide)</b><br/>Token 优化、内存持久化、评测（Evals）与并行化。</td>
+<td align="center"><b>简明指南 (Shorthand Guide)</b><br/>安装、基础、哲学。<b>请先阅读此篇。</b></td>
+<td align="center"><b>深度指南 (Longform Guide)</b><br/>Token 优化、内存持久化、评测（Evals）、并行化。</td>
 </tr>
 </table>
 
 | 主题 | 你将学到什么 |
 |-------|-------------------|
-| Token 优化 | 模型选择、系统提示词瘦身、后台进程 |
-| 内存持久化 | 自动跨会话保存/加载上下文的钩子（Hooks） |
+| Token 优化 | 模型选择、系统提示词精简、后台进程 |
+| 内存持久化 | 跨会话（Session）自动保存/加载上下文的钩子（Hooks） |
 | 持续学习 | 从会话中自动提取模式并转化为可复用的技能（Skills） |
-| 验证循环 | 检查点 vs 持续评测、打分器类型、pass@k 指标 |
-| 并行化 | Git worktrees、级联法（Cascade method）、何时扩展实例 |
-| 子智能体编排 | 上下文问题、迭代检索模式（Iterative retrieval pattern） |
+| 验证循环 | 检查点（Checkpoint）与持续评测（Evals）、评分器类型、pass@k 指标 |
+| 并行化 | Git worktrees、级联方法、何时扩展实例 |
+| 子智能体编排 | 上下文问题、迭代检索模式 |
 
 ---
 
 ## 跨平台支持
 
-本插件现已全面支持 **Windows、macOS 和 Linux**。所有钩子和脚本均已使用 Node.js 重写，以实现最大兼容性。
+该插件现已全面支持 **Windows、macOS 和 Linux**。所有钩子（Hooks）和脚本都已使用 Node.js 重写，以实现最大的兼容性。
 
 ### 包管理器检测
 
@@ -58,7 +65,7 @@
 1. **环境变量**：`CLAUDE_PACKAGE_MANAGER`
 2. **项目配置**：`.claude/package-manager.json`
 3. **package.json**：`packageManager` 字段
-4. **锁文件**：根据 package-lock.json, yarn.lock, pnpm-lock.yaml, 或 bun.lockb 检测
+4. **锁文件**：根据 package-lock.json, yarn.lock, pnpm-lock.yaml 或 bun.lockb 检测
 5. **全局配置**：`~/.claude/package-manager.json`
 6. **备选项**：第一个可用的包管理器
 
@@ -82,9 +89,9 @@ node scripts/setup-package-manager.js --detect
 
 ---
 
-## 核心内容
+## 包含内容
 
-本仓库是一个 **Claude Code 插件** —— 你可以直接安装，也可以手动复制组件。
+本仓库是一个 **Claude Code 插件** —— 你可以直接安装它，或者手动复制组件。
 
 ```
 everything-claude-code/
@@ -92,133 +99,193 @@ everything-claude-code/
 |   |-- plugin.json         # 插件元数据与组件路径
 |   |-- marketplace.json    # 用于 /plugin marketplace add 的市场目录
 |
-|-- agents/           # 用于任务委派的专用子智能体
+|-- agents/           # 用于任务委派的专用子智能体（Subagents）
 |   |-- planner.md           # 功能实现规划
 |   |-- architect.md         # 系统设计决策
-|   |-- tdd-guide.md         # 测试驱动开发 (TDD)
-|   |-- code-reviewer.md     # 质量与安全审查
+|   |-- tdd-guide.md         # 测试驱动开发（TDD）
+|   |-- code-reviewer.md     # 代码质量与安全评审
 |   |-- security-reviewer.md # 漏洞分析
-|   |-- build-error-resolver.md # 构建错误修复
-|   |-- e2e-runner.md        # Playwright E2E 测试
-|   |-- refactor-cleaner.md  # 冗余代码清理
+|   |-- build-error-resolver.md # 构建错误解决
+|   |-- e2e-runner.md        # Playwright 端到端测试
+|   |-- refactor-cleaner.md  # 死代码清理
 |   |-- doc-updater.md       # 文档同步
-|   |-- go-reviewer.md       # Go 代码审查 (新增)
-|   |-- go-build-resolver.md # Go 构建错误解决 (新增)
+|   |-- go-reviewer.md       # Go 代码评审（新增）
+|   |-- go-build-resolver.md # Go 构建错误解决（新增）
 |
-|-- skills/           # 工作流定义与领域知识
-|   |-- coding-standards/           # 编程语言最佳实践
+|-- skills/           # 工作流（Workflow）定义与领域知识
+|   |-- coding-standards/           # 语言最佳实践
 |   |-- backend-patterns/           # API、数据库、缓存模式
-|   |-- frontend-patterns/          # React, Next.js 模式
-|   |-- continuous-learning/        # 从会话中自动提取模式 (深度指南)
-|   |-- continuous-learning-v2/     # 基于本能 (Instinct) 的学习与置信度评分
-|   |-- iterative-retrieval/        # 为子智能体提供渐进式上下文精炼
-|   |-- strategic-compact/          # 手动压缩建议 (深度指南)
+|   |-- frontend-patterns/          # React、Next.js 模式
+|   |-- continuous-learning/        # 从会话中自动提取模式（深度指南内容）
+|   |-- continuous-learning-v2/     # 基于直觉（Instinct）的带置信度评分学习系统
+|   |-- iterative-retrieval/        # 子智能体的渐进式上下文精炼
+|   |-- strategic-compact/          # 手动压缩建议（深度指南内容）
 |   |-- tdd-workflow/               # TDD 方法论
-|   |-- security-review/            # 安全检查清单
-|   |-- eval-harness/               # 验证循环评估 (深度指南)
-|   |-- verification-loop/          # 持续验证 (深度指南)
-|   |-- golang-patterns/            # Go 惯用法与最佳实践 (新增)
-|   |-- golang-testing/             # Go 测试模式、TDD、基准测试 (新增)
+|   |-- security-review/            # 安全自查表
+|   |-- eval-harness/               # 验证循环评测（深度指南内容）
+|   |-- verification-loop/          # 持续验证（深度指南内容）
+|   |-- golang-patterns/            # Go 惯用法与最佳实践（新增）
+|   |-- golang-testing/             # Go 测试模式、TDD、基准测试（新增）
 |
-|-- commands/         # 用于快速执行的斜杠命令 (/命令)
+|-- commands/         # 用于快速执行的斜杠命令（Slash Commands）
 |   |-- tdd.md              # /tdd - 测试驱动开发
 |   |-- plan.md             # /plan - 实现规划
-|   |-- e2e.md              # /e2e - E2E 测试生成
-|   |-- code-review.md      # /code-review - 质量审查
+|   |-- e2e.md              # /e2e - 端到端测试生成
+|   |-- code-review.md      # /code-review - 质量评审
 |   |-- build-fix.md        # /build-fix - 修复构建错误
-|   |-- refactor-clean.md   # /refactor-clean - 冗余代码移除
-|   |-- learn.md            # /learn - 会话中途提取模式 (深度指南)
-|   |-- checkpoint.md       # /checkpoint - 保存验证状态 (深度指南)
-|   |-- verify.md           # /verify - 运行验证循环 (深度指南)
+|   |-- refactor-clean.md   # /refactor-clean - 移除死代码
+|   |-- learn.md            # /learn - 会话中途提取模式（深度指南内容）
+|   |-- checkpoint.md       # /checkpoint - 保存验证状态（深度指南内容）
+|   |-- verify.md           # /verify - 运行验证循环（深度指南内容）
 |   |-- setup-pm.md         # /setup-pm - 配置包管理器
-|   |-- go-review.md        # /go-review - Go 代码审查 (新增)
-|   |-- go-test.md          # /go-test - Go TDD 工作流 (新增)
-|   |-- go-build.md         # /go-build - 修复 Go 构建错误 (新增)
+|   |-- go-review.md        # /go-review - Go 代码评审（新增）
+|   |-- go-test.md          # /go-test - Go TDD 工作流（新增）
+|   |-- go-build.md         # /go-build - 修复 Go 构建错误（新增）
+|   |-- skill-create.md     # /skill-create - 从 git 历史生成技能（新增）
+|   |-- instinct-status.md  # /instinct-status - 查看已学习的直觉（新增）
+|   |-- instinct-import.md  # /instinct-import - 导入直觉（新增）
+|   |-- instinct-export.md  # /instinct-export - 导出直觉（新增）
+|   |-- evolve.md           # /evolve - 将相关直觉聚类为技能（新增）
 |
-|-- rules/            # 必须遵守的指南 (复制到 ~/.claude/rules/)
+|-- rules/            # 必须遵守的准则（复制到 ~/.claude/rules/）
 |   |-- security.md         # 强制性安全检查
-|   |-- coding-style.md     # 不可变性、文件组织结构
+|   |-- coding-style.md     # 不可变性、文件组织
 |   |-- testing.md          # TDD、80% 覆盖率要求
-|   |-- git-workflow.md     # Commit 格式、PR 流程
+|   |-- git-workflow.md     # 提交格式、PR 流程
 |   |-- agents.md           # 何时委派给子智能体
 |   |-- performance.md      # 模型选择、上下文管理
 |
 |-- hooks/            # 基于触发器的自动化
-|   |-- hooks.json                # 所有钩子配置 (PreToolUse, PostToolUse, Stop 等)
-|   |-- memory-persistence/       # 会话生命周期钩子 (深度指南)
-|   |-- strategic-compact/        # 压缩建议 (深度指南)
+|   |-- hooks.json                # 所有钩子配置（PreToolUse, PostToolUse, Stop 等）
+|   |-- memory-persistence/       # 会话生命周期钩子（深度指南内容）
+|   |-- strategic-compact/        # 压缩建议（深度指南内容）
 |
-|-- scripts/          # 跨平台 Node.js 脚本 (新增)
+|-- scripts/          # 跨平台 Node.js 脚本（新增）
 |   |-- lib/                     # 共享实用程序
 |   |   |-- utils.js             # 跨平台文件/路径/系统工具
 |   |   |-- package-manager.js   # 包管理器检测与选择
 |   |-- hooks/                   # 钩子实现
-|   |   |-- session-start.js     # 会话启动时加载上下文
+|   |   |-- session-start.js     # 会话开始时加载上下文
 |   |   |-- session-end.js       # 会话结束时保存状态
-|   |   |-- pre-compact.js       # 压缩前的状态保存
-|   |   |-- suggest-compact.js   # 策略性压缩建议
+|   |   |-- pre-compact.js       # 压缩前状态保存
+|   |   |-- suggest-compact.js   # 战略性压缩建议
 |   |   |-- evaluate-session.js  # 从会话中提取模式
 |   |-- setup-package-manager.js # 交互式包管理器设置
 |
-|-- tests/            # 测试套件 (新增)
+|-- tests/            # 测试套件（新增）
 |   |-- lib/                     # 库测试
 |   |-- hooks/                   # 钩子测试
 |   |-- run-all.js               # 运行所有测试
 |
-|-- contexts/         # 动态系统提示词注入上下文 (深度指南)
+|-- contexts/         # 动态系统提示词注入上下文（深度指南内容）
 |   |-- dev.md              # 开发模式上下文
-|   |-- review.md           # 代码审查模式上下文
+|   |-- review.md           # 代码评审模式上下文
 |   |-- research.md         # 研究/探索模式上下文
 |
-|-- examples/         # 示例配置与会话
+|-- examples/         # 配置与会话示例
 |   |-- CLAUDE.md           # 项目级配置示例
 |   |-- user-CLAUDE.md      # 用户级配置示例
 |
-|-- mcp-configs/      # MCP 服务器配置
+|-- mcp-configs/      # MCP 服务配置
 |   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway 等
 |
-|-- marketplace.json  # 自托管市场配置 (用于 /plugin marketplace add)
+|-- marketplace.json  # 自托管市场配置（用于 /plugin marketplace add）
 ```
 
 ---
 
 ## 生态工具
 
-### ecc.tools - 技能生成器 (Skill Creator)
+### 技能创建器（Skill Creator）
 
-自动根据你的仓库生成 Claude Code 技能（Skills）。
+有两种方法可以从你的仓库生成 Claude Code 技能：
+
+#### 方案 A：本地分析（内置）
+
+使用 `/skill-create` 命令进行本地分析，无需外部服务：
+
+```bash
+/skill-create                    # 分析当前仓库
+/skill-create --instincts        # 同时为持续学习（continuous-learning）生成直觉（instincts）
+```
+
+该命令会在本地分析你的 git 历史并生成 SKILL.md 文件。
+
+#### 方案 B：GitHub App（高级）
+
+适用于高级功能（1万+ commit、自动 PR、团队共享）：
 
 [安装 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)
 
-分析你的仓库并创建：
-- **SKILL.md 文件** - 开箱即用的 Claude Code 技能
-- **本能 (Instinct) 集合** - 适用于 continuous-learning-v2
-- **模式提取** - 从你的 commit 历史中学习
-
 ```bash
-# 安装 GitHub App 后，技能将出现在：
-~/.claude/skills/generated/
+# 在任何 issue 下留言：
+/skill-creator analyze
+
+# 或者在 push 到默认分支时自动触发
 ```
 
-与 `continuous-learning-v2` 技能完美配合，实现遗传式的本能学习。
+两种方案都会创建：
+- **SKILL.md 文件** - 可直接用于 Claude Code 的技能
+- **直觉集合（Instinct collections）** - 用于 continuous-learning-v2
+- **模式提取（Pattern extraction）** - 从你的提交历史中学习
+
+### 持续学习（Continuous Learning）v2
+
+基于直觉（instinct）的学习系统会自动学习你的开发模式：
+
+```bash
+/instinct-status        # 显示带有置信度的已学习直觉
+/instinct-import <file> # 导入他人的直觉
+/instinct-export        # 导出你的直觉以便分享
+/evolve                 # 将相关的直觉聚类为技能（skills）
+```
+
+详见 `skills/continuous-learning-v2/` 的完整文档。
 
 ---
 
-## 安装方法
+## 要求
+
+### Claude Code CLI 版本
+
+**最低版本：v2.1.0 或更高**
+
+由于插件系统处理钩子（hooks）方式的变更，本插件要求 Claude Code CLI v2.1.0+。
+
+检查你的版本：
+```bash
+claude --version
+```
+
+### 重要：钩子（Hooks）自动加载行为
+
+> ⚠️ **对贡献者的提醒：** 请勿在 `.claude-plugin/plugin.json` 中添加 `"hooks"` 字段。这是由回归测试强制执行的。
+
+Claude Code v2.1+ 会**自动加载**已安装插件中约定的 `hooks/hooks.json`。在 `plugin.json` 中显式声明会导致重复检测错误：
+
+```
+Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
+```
+
+**历史背景：** 此问题在本仓库中曾多次出现修复/回退循环（[#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)）。Claude Code 版本间的行为差异导致了混淆。我们现在已加入回归测试以防止此类问题再次发生。
+
+---
+
+## 安装
 
 ### 方案 1：作为插件安装（推荐）
 
-使用本仓库最简单的方法 —— 作为 Claude Code 插件安装：
+这是使用本仓库最简单的方法 —— 作为 Claude Code 插件安装：
 
 ```bash
-# 将此仓库添加为市场
+# 将此仓库添加为市场（marketplace）
 /plugin marketplace add affaan-m/everything-claude-code
 
 # 安装插件
 /plugin install everything-claude-code@everything-claude-code
 ```
 
-或者直接添加到你的 `~/.claude/settings.json` 中：
+或者直接添加到你的 `~/.claude/settings.json`：
 
 ```json
 {
@@ -236,18 +303,18 @@ everything-claude-code/
 }
 ```
 
-安装后你即可立即使用所有命令、智能体、技能和钩子。
+安装后即可立即使用所有命令（commands）、智能体（agents）、技能（skills）和钩子（hooks）。
 
-> **注意：** Claude Code 插件系统目前不支持通过插件分发 `rules`（[上游限制](https://code.claude.com/docs/en/plugins-reference)）。你需要手动安装规约（Rules）：
-> 
+> **注意：** Claude Code 插件系统目前不支持通过插件分发规则（`rules`）（这是 [上游限制](https://code.claude.com/docs/en/plugins-reference)）。你需要手动安装规则：
+>
 > ```bash
-> # 先克隆仓库
+> # 首先克隆仓库
 > git clone https://github.com/affaan-m/everything-claude-code.git
-> 
-> # 选项 A：用户级规约 (适用于所有项目)
+>
+> # 方案 A：用户级规则（应用于所有项目）
 > cp -r everything-claude-code/rules/* ~/.claude/rules/
-> 
-> # 选项 B：项目级规约 (仅适用于当前项目)
+>
+> # 方案 B：项目级规则（仅应用于当前项目）
 > mkdir -p .claude/rules
 > cp -r everything-claude-code/rules/* .claude/rules/
 > ```
@@ -256,85 +323,85 @@ everything-claude-code/
 
 ### 方案 2：手动安装
 
-如果你更喜欢手动控制安装内容：
+如果你更倾向于手动控制安装的内容：
 
 ```bash
 # 克隆仓库
 git clone https://github.com/affaan-m/everything-claude-code.git
 
-# 将智能体复制到你的 Claude 配置目录
+# 复制智能体（agents）到你的 Claude 配置目录
 cp everything-claude-code/agents/*.md ~/.claude/agents/
 
-# 复制规约 (Rules)
+# 复制规则（rules）
 cp everything-claude-code/rules/*.md ~/.claude/rules/
 
-# 复制命令 (Commands)
+# 复制命令（commands）
 cp everything-claude-code/commands/*.md ~/.claude/commands/
 
-# 复制技能 (Skills)
+# 复制技能（skills）
 cp -r everything-claude-code/skills/* ~/.claude/skills/
 ```
 
-#### 将钩子 (Hooks) 添加到 settings.json
+#### 将钩子（hooks）添加到 settings.json
 
-将 `hooks/hooks.json` 中的钩子配置复制到你的 `~/.claude/settings.json`。
+将 `hooks/hooks.json` 中的钩子配置复制到你的 `~/.claude/settings.json` 中。
 
-#### 配置 MCP
+#### 配置 MCPs
 
-将 `mcp-configs/mcp-servers.json` 中需要的 MCP 服务器配置复制到你的 `~/.claude.json`。
+将 `mcp-configs/mcp-servers.json` 中你需要的 MCP 服务配置复制到你的 `~/.claude.json`。
 
-**重要：** 请将 `YOUR_*_HERE` 占位符替换为你实际的 API 密钥。
+**重要：** 请将 `YOUR_*_HERE` 占位符替换为你真实的 API 密钥。
 
 ---
 
 ## 核心概念
 
-### 智能体 (Agents)
+### 智能体（Agents）
 
-子智能体负责处理具有特定范围的委派任务。示例：
+子智能体（Subagents）负责处理受限范围内的委派任务。示例：
 
 ```markdown
 ---
 name: code-reviewer
-description: 审查代码的质量、安全性与可维护性
+description: 评审代码质量、安全性与可维护性
 tools: ["Read", "Grep", "Glob", "Bash"]
 model: opus
 ---
 
-你是一个资深代码审查员...
+你是一名资深代码评审员...
 ```
 
-### 技能 (Skills)
+### 技能（Skills）
 
-技能是由命令或智能体调用的工作流定义：
+技能（Skills）是可由命令或智能体调用的工作流定义：
 
 ```markdown
 # TDD 工作流
 
 1. 首先定义接口
-2. 编写失败的测试 (RED)
-3. 实现最简代码 (GREEN)
-4. 重构 (IMPROVE)
-5. 验证 80% 以上的覆盖率
+2. 编写失败的测试（RED）
+3. 实现最简代码（GREEN）
+4. 重构（IMPROVE）
+5. 验证覆盖率是否达到 80% 以上
 ```
 
-### 钩子 (Hooks)
+### 钩子（Hooks）
 
-钩子在工具事件上触发。示例 —— 警告关于 console.log 的使用：
+钩子（Hooks）在工具事件发生时触发。示例 —— 针对 console.log 发出警告：
 
 ```json
 {
   "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
   "hooks": [{
     "type": "command",
-    "command": "#!/bin/bash\ngrep -n 'console\.log' \"$file_path\" && echo '[Hook] 移除 console.log' >&2"
+    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
   }]
 }
 ```
 
-### 规约 (Rules)
+### 规则（Rules）
 
-规约是必须始终遵循的指南。保持模块化：
+规则（Rules）是必须始终遵守的准则。请保持它们的模块化：
 
 ```
 ~/.claude/rules/
@@ -347,7 +414,7 @@ model: opus
 
 ## 运行测试
 
-本插件包含完整的测试套件：
+本插件包含一个全面的测试套件：
 
 ```bash
 # 运行所有测试
@@ -361,56 +428,56 @@ node tests/hooks/hooks.test.js
 
 ---
 
-## 贡献指南
+## 贡献
 
-**欢迎并鼓励大家做出贡献。**
+**非常欢迎并鼓励贡献。**
 
-本仓库旨在作为一个社区资源。如果你有：
+本仓库旨在成为一个社区资源。如果你有：
 - 有用的智能体或技能
 - 巧妙的钩子
 - 更好的 MCP 配置
-- 改进后的规约
+- 改进后的规则
 
-请提交贡献！参见 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
+请提交你的贡献！参考 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
 
 ### 贡献思路
 
-- 特定语言的技能 (Python, Rust 模式) —— Go 已包含！
-- 特定框架的配置 (Django, Rails, Laravel)
-- DevOps 智能体 (Kubernetes, Terraform, AWS)
-- 测试策略 (针对不同框架)
-- 领域特定知识 (机器学习, 数据工程, 移动端)
+- 语言专用技能（Python, Rust 模式）—— 已包含 Go！
+- 框架专用配置（Django, Rails, Laravel）
+- DevOps 智能体（Kubernetes, Terraform, AWS）
+- 测试策略（不同框架）
+- 领域特定知识（机器学习、数据工程、移动开发）
 
 ---
 
-## 背景故事
+## 背景
 
-自实验性推出以来，我一直在使用 Claude Code。在 2025 年 9 月的 Anthropic x Forum Ventures 黑客松中，我与 [@DRodriguezFX](https://x.com/DRodriguezFX) 合作构建了 [zenith.chat](https://zenith.chat)，并最终获胜 —— 整个过程完全使用了 Claude Code。
+我从 Claude Code 实验阶段就开始使用了。在 2025 年 9 月的 Anthropic x Forum Ventures 黑客松中，我与 [@DRodriguezFX](https://x.com/DRodriguezFX) 合作开发了 [zenith.chat](https://zenith.chat)，并获得了冠军 —— 该项目完全使用 Claude Code 构建。
 
-这些配置在多个生产级应用中经过了实战测试。
+这些配置在多个生产级应用中经过了实战检验。
 
 ---
 
-## 重要注意事项
+## 重要提示
 
 ### 上下文窗口管理
 
-**关键：** 不要一次性启用所有 MCP。开启过多工具会将你 200k 的上下文窗口压缩到 70k。
+**至关重要：** 不要一次性启用所有 MCP。如果启用的工具过多，你的 200k 上下文窗口可能会缩减到 70k。
 
 经验法则：
 - 配置 20-30 个 MCP
-- 每个项目保持启用 10 个以下
-- 活跃工具总数保持在 80 个以下
+- 每个项目保持启用 10 个以内
+- 活跃工具总数控制在 80 个以内
 
-在项目配置中使用 `disabledMcpServers` 来禁用不常用的服务器。
+在项目配置中使用 `disabledMcpServers` 来禁用不需要的服务。
 
 ### 自定义
 
-这些配置适合我的工作流。你应该：
-1. 从产生共鸣的内容开始
+这些配置适用于我的工作流。你应该：
+1. 从你产生共鸣的内容开始
 2. 根据你的技术栈进行修改
-3. 移除你不使用的部分
-4. 添加你自己的模式
+3. 移除你不需要的内容
+4. 加入你自己的模式
 
 ---
 
@@ -422,17 +489,17 @@ node tests/hooks/hooks.test.js
 
 ## 相关链接
 
-- **简明指南 (从这里开始)：** [The Shorthand Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2012378465664745795)
-- **深度指南 (进阶)：** [The Longform Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2014040193557471352)
-- **关注：** [@affaanmustafa](https://x.com/affaanmustafa)
-- **zenith.chat:** [zenith.chat](https://zenith.chat)
+- **简明指南（入门必读）：** [Everything Claude Code 简明指南](https://x.com/affaanmustafa/status/2012378465664745795)
+- **深度指南（进阶参考）：** [Everything Claude Code 深度指南](https://x.com/affaanmustafa/status/2014040193557471352)
+- **关注我：** [@affaanmustafa](https://x.com/affaanmustafa)
+- **zenith.chat：** [zenith.chat](https://zenith.chat)
 
 ---
 
 ## 许可证
 
-MIT - 自由使用，根据需要修改，如果可以请回馈社区。
+MIT - 自由使用，按需修改，如果可以请回馈社区。
 
 ---
 
-**如果对你有帮助，请给本仓库点个 Star。阅读两篇指南。构建伟大的产品。**
+**如果对你有帮助，请给本仓库点个 Star。阅读两份指南。构建伟大的产品。**
diff --git a/agents/database-reviewer.md b/agents/database-reviewer.md
index c4bf418..4d9ae21 100644
--- a/agents/database-reviewer.md
+++ b/agents/database-reviewer.md
@@ -1,31 +1,31 @@
 ---
 name: database-reviewer
-description: PostgreSQL 数据库专家，专注于查询优化、模式设计、安全性和性能。在编写 SQL、创建迁移（migrations）、设计模式（schemas）或排除数据库性能故障时应主动使用。整合了 Supabase 的最佳实践。
+description: PostgreSQL 数据库专家，专注于查询优化、模式设计、安全性和性能。在编写 SQL、创建迁移、设计模式或排查数据库性能问题时主动使用。包含 Supabase 最佳实践。
 tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
 model: opus
 ---
 
-# 数据库审查员 (Database Reviewer)
+# 数据库评审专家 (Database Reviewer)
 
-你是一名资深的 PostgreSQL 数据库专家，专注于查询优化、模式设计（Schema Design）、安全性以及性能表现。你的使命是确保数据库代码遵循最佳实践、预防性能瓶颈并维护数据完整性。本智能体（Agent）整合了来自 [Supabase's postgres-best-practices](https://github.com/supabase/agent-skills) 的模式。
+你是一名专家级 PostgreSQL 数据库专家，专注于查询优化（Query Optimization）、模式设计（Schema Design）、安全性（Security）和性能（Performance）。你的使命是确保数据库代码遵循最佳实践，防止性能问题，并维护数据完整性。该智能体集成了来自 [Supabase's postgres-best-practices](https://github.com/supabase/agent-skills) 的模式。
 
-## 核心职责
+## 核心职责 (Core Responsibilities)
 
-1. **查询性能 (Query Performance)** - 优化查询，添加合适的索引，防止全表扫描。
-2. **模式设计 (Schema Design)** - 设计高效的模式，使用正确的数据类型和约束。
-3. **安全性与 RLS (Security & RLS)** - 实施行级安全性（Row Level Security），遵循最小权限访问原则。
-4. **连接管理 (Connection Management)** - 配置连接池、超时和限制。
-5. **并发控制 (Concurrency)** - 预防死锁，优化锁定策略。
+1. **查询性能 (Query Performance)** - 优化查询，添加合适的索引，防止全表扫描（Table Scans）。
+2. **模式设计 (Schema Design)** - 使用正确的数据类型和约束设计高效的模式。
+3. **安全性与 RLS (Security & RLS)** - 实现行级安全性（Row Level Security, RLS），遵循最小权限原则。
+4. **连接管理 (Connection Management)** - 配置连接池（Pooling）、超时、限制。
+5. **并发 (Concurrency)** - 防止死锁（Deadlocks），优化锁策略。
 6. **监控 (Monitoring)** - 设置查询分析和性能跟踪。
 
-## 可用工具
+## 你可以使用的工具 (Tools at Your Disposal)
 
 ### 数据库分析命令
 ```bash
 # 连接到数据库
 psql $DATABASE_URL
 
-# 检查慢查询 (需要 pg_stat_statements 扩展)
+# 检查慢查询（需要 pg_stat_statements）
 psql -c "SELECT query, mean_exec_time, calls FROM pg_stat_statements ORDER BY mean_exec_time DESC LIMIT 10;"
 
 # 检查表大小
@@ -37,26 +37,26 @@ psql -c "SELECT indexrelname, idx_scan, idx_tup_read FROM pg_stat_user_indexes O
 # 查找外键上缺失的索引
 psql -c "SELECT conrelid::regclass, a.attname FROM pg_constraint c JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = ANY(c.conkey) WHERE c.contype = 'f' AND NOT EXISTS (SELECT 1 FROM pg_index i WHERE i.indrelid = c.conrelid AND a.attnum = ANY(i.indkey));"
 
-# 检查表膨胀情况
+# 检查表膨胀（Table Bloat）
 psql -c "SELECT relname, n_dead_tup, last_vacuum, last_autovacuum FROM pg_stat_user_tables WHERE n_dead_tup > 1000 ORDER BY n_dead_tup DESC;"
 ```
 
-## 数据库审查工作流
+## 数据库评审工作流 (Database Review Workflow)
 
-### 1. 查询性能审查 (关键)
+### 1. 查询性能评审 (CRITICAL)
 
-针对每一个 SQL 查询，请验证：
+对于每一个 SQL 查询，验证：
 
 ```
-a) 索引使用情况
-   - WHERE 子句涉及的列是否已建索引？
-   - JOIN 子句涉及的列是否已建索引？
-   - 索引类型是否合适 (B-tree, GIN, BRIN)？
+a) 索引使用 (Index Usage)
+   - WHERE 列是否已索引？
+   - JOIN 列是否已索引？
+   - 索引类型是否合适（B-tree, GIN, BRIN）？
 
-b) 查询计划分析
+b) 查询计划分析 (Query Plan Analysis)
    - 对复杂查询运行 EXPLAIN ANALYZE
-   - 检查大表是否存在全表扫描 (Seq Scan)
-   - 验证估算行数是否与实际匹配
+   - 检查大表是否存在顺序扫描（Seq Scans）
+   - 验证预估行数是否与实际匹配
 
 c) 常见问题
    - N+1 查询模式
@@ -64,43 +64,43 @@ c) 常见问题
    - 索引中的列顺序错误
 ```
 
-### 2. 模式设计审查 (高优先级)
+### 2. 模式设计评审 (HIGH)
 
 ```
-a) 数据类型
-   - ID 使用 bigint (而非 int)
-   - 字符串使用 text (除非需要特定约束，否则不用 varchar(n))
-   - 时间戳使用 timestamptz (而非 timestamp)
-   - 货币使用 numeric (而非 float)
-   - 标志位使用 boolean (而非 varchar)
+a) 数据类型 (Data Types)
+   - ID 使用 bigint（不要用 int）
+   - 字符串使用 text（不要用 varchar(n)，除非需要约束）
+   - 时间戳使用 timestamptz（不要用 timestamp）
+   - 金额使用 numeric（不要用 float）
+   - 标志位使用 boolean（不要用 varchar）
 
-b) 约束
-   - 已定义主键 (Primary keys)
-   - 外键具有合适的 ON DELETE 策略
+b) 约束 (Constraints)
+   - 定义主键（Primary keys）
+   - 带有正确 ON DELETE 的外键（Foreign keys）
    - 在适当的地方使用 NOT NULL
-   - 使用 CHECK 约束进行数据校验
+   - 用于验证的 CHECK 约束
 
-c) 命名规范
-   - 使用 lowercase_snake_case (避免使用引号引起来的标识符)
-   - 保持一致的命名模式
+c) 命名 (Naming)
+   - 使用 lowercase_snake_case（避免使用带引号的标识符）
+   - 命名模式保持一致
 ```
 
-### 3. 安全性审查 (关键)
+### 3. 安全评审 (CRITICAL)
 
 ```
-a) 行级安全性 (Row Level Security / RLS)
+a) 行级安全性 (Row Level Security)
    - 多租户表是否启用了 RLS？
-   - 策略（Policies）是否使用了 (select auth.uid()) 模式？
-   - RLS 涉及的列是否已建索引？
+   - 策略是否使用 (select auth.uid()) 模式？
+   - RLS 列是否已索引？
 
-b) 权限管理
+b) 权限 (Permissions)
    - 是否遵循最小权限原则？
-   - 是否没有向应用用户授予 GRANT ALL 权限？
-   - 是否撤销了 public 模式的权限？
+   - 是否向应用用户授予了 GRANT ALL？
+   - 公共模式（Public schema）权限是否已撤销？
 
 c) 数据保护
-   - 敏感数据是否加密？
-   - 个人可识别信息 (PII) 的访问是否已记录日志？
+   - 敏感数据是否已加密？
+   - PII（个人身份信息）访问是否记录日志？
 ```
 
 ---
@@ -112,14 +112,14 @@ c) 数据保护
 **影响：** 在大表上可使查询速度提升 100-1000 倍。
 
 ```sql
--- ❌ 错误示例：外键上没有索引
+-- ❌ 错误：外键上没有索引
 CREATE TABLE orders (
   id bigint PRIMARY KEY,
   customer_id bigint REFERENCES customers(id)
-  -- 缺失索引！
+  -- 缺少索引！
 );
 
--- ✅ 正确示例：在外键上建立索引
+-- ✅ 正确：外键上有索引
 CREATE TABLE orders (
   id bigint PRIMARY KEY,
   customer_id bigint REFERENCES customers(id)
@@ -129,19 +129,19 @@ CREATE INDEX orders_customer_id_idx ON orders (customer_id);
 
 ### 2. 选择正确的索引类型
 
-| 索引类型 | 使用场景 | 运算符 |
+| 索引类型 | 场景 | 运算符 |
 |------------|----------|-----------|
-| **B-tree** (默认) | 等值、范围查询 | `=`, `<`, `>`, `BETWEEN`, `IN` |
-| **GIN** | 数组、JSONB、全文检索 | `@>`, `?`, `?&`, `?|`, `@@` |
-| **BRIN** | 大型时间序列数据表 | 对有序数据的范围查询 |
-| **Hash** | 仅等值查询 | `=` (略快于 B-tree) |
+| **B-tree** (默认) | 等值、范围 | `=`, `<`, `>`, `BETWEEN`, `IN` |
+| **GIN** | 数组、JSONB、全文检索 | `@>`, `?`, `?&`, `?\|`, `@@` |
+| **BRIN** | 大型时序表 | 排序数据上的范围查询 |
+| **Hash** | 仅等值 | `=` (略快于 B-tree) |
 
 ```sql
--- ❌ 错误示例：对 JSONB 包含关系使用 B-tree
+-- ❌ 错误：在 JSONB 包含查询中使用 B-tree
 CREATE INDEX products_attrs_idx ON products (attributes);
 SELECT * FROM products WHERE attributes @> '{"color": "red"}';
 
--- ✅ 正确示例：对 JSONB 使用 GIN
+-- ✅ 正确：对 JSONB 使用 GIN
 CREATE INDEX products_attrs_idx ON products USING gin (attributes);
 ```
 
@@ -150,48 +150,48 @@ CREATE INDEX products_attrs_idx ON products USING gin (attributes);
 **影响：** 多列查询速度提升 5-10 倍。
 
 ```sql
--- ❌ 错误示例：分开建立索引
+-- ❌ 错误：单独的索引
 CREATE INDEX orders_status_idx ON orders (status);
 CREATE INDEX orders_created_idx ON orders (created_at);
 
--- ✅ 正确示例：复合索引 (等值列在前，范围列在后)
+-- ✅ 正确：复合索引（等值列在前，范围列在后）
 CREATE INDEX orders_status_created_idx ON orders (status, created_at);
 ```
 
-**左前缀规则 (Leftmost Prefix Rule):**
+**最左前缀原则 (Leftmost Prefix Rule)：**
 - 索引 `(status, created_at)` 适用于：
   - `WHERE status = 'pending'`
   - `WHERE status = 'pending' AND created_at > '2024-01-01'`
-- **不适用于：**
+- **不适用于**：
   - 单独的 `WHERE created_at > '2024-01-01'`
 
 ### 4. 覆盖索引 (Covering Indexes / Index-Only Scans)
 
-**影响：** 通过避免表查找，使查询速度提升 2-5 倍。
+**影响：** 通过避免回表查询，速度提升 2-5 倍。
 
 ```sql
--- ❌ 错误示例：必须从表中获取 name 字段
+-- ❌ 错误：必须从表中获取 name
 CREATE INDEX users_email_idx ON users (email);
 SELECT email, name FROM users WHERE email = 'user@example.com';
 
--- ✅ 正确示例：索引包含所有需要的列
+-- ✅ 正确：索引中包含所有列
 CREATE INDEX users_email_idx ON users (email) INCLUDE (name, created_at);
 ```
 
 ### 5. 过滤查询的部分索引 (Partial Indexes)
 
-**影响：** 索引体积缩小 5-20 倍，写入和查询速度更快。
+**影响：** 索引减小 5-20 倍，写入和查询速度更快。
 
 ```sql
--- ❌ 错误示例：全量索引包含已删除的行
+-- ❌ 错误：全量索引包含已删除的行
 CREATE INDEX users_email_idx ON users (email);
 
--- ✅ 正确示例：部分索引排除已删除的行
+-- ✅ 正确：部分索引排除已删除的行
 CREATE INDEX users_active_email_idx ON users (email) WHERE deleted_at IS NULL;
 ```
 
 **常见模式：**
-- 逻辑删除：`WHERE deleted_at IS NULL`
+- 软删除：`WHERE deleted_at IS NULL`
 - 状态过滤：`WHERE status = 'pending'`
 - 非空值：`WHERE sku IS NOT NULL`
 
@@ -202,16 +202,16 @@ CREATE INDEX users_active_email_idx ON users (email) WHERE deleted_at IS NULL;
 ### 1. 数据类型选择
 
 ```sql
--- ❌ 错误示例：糟糕的类型选择
+-- ❌ 错误：糟糕的类型选择
 CREATE TABLE users (
-  id int,                           -- 超过 21 亿时会溢出
-  email varchar(255),               -- 人为设置的限制
-  created_at timestamp,             -- 没有时区信息
+  id int,                           -- 在 21 亿时溢出
+  email varchar(255),               -- 人为限制长度
+  created_at timestamp,             -- 无时区
   is_active varchar(5),             -- 应该是 boolean
-  balance float                     -- 会导致精度丢失
+  balance float                     -- 精度丢失
 );
 
--- ✅ 正确示例：合适的类型
+-- ✅ 正确：合适的类型
 CREATE TABLE users (
   id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
   email text NOT NULL,
@@ -221,32 +221,32 @@ CREATE TABLE users (
 );
 ```
 
-### 2. 主键策略
+### 2. 主键策略 (Primary Key Strategy)
 
 ```sql
--- ✅ 单数据库环境：IDENTITY (默认，推荐)
+-- ✅ 单数据库：IDENTITY（默认，推荐）
 CREATE TABLE users (
   id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY
 );
 
--- ✅ 分布式系统：UUIDv7 (按时间排序)
+-- ✅ 分布式系统：UUIDv7（按时间排序）
 CREATE EXTENSION IF NOT EXISTS pg_uuidv7;
 CREATE TABLE orders (
   id uuid DEFAULT uuid_generate_v7() PRIMARY KEY
 );
 
--- ❌ 避免使用：随机 UUID 会导致索引碎片
+-- ❌ 避免：随机 UUID 会导致索引碎片（Index Fragmentation）
 CREATE TABLE events (
-  id uuid DEFAULT gen_random_uuid() PRIMARY KEY  -- 会导致插入时的索引碎片！
+  id uuid DEFAULT gen_random_uuid() PRIMARY KEY  -- 会导致插入碎片化！
 );
 ```
 
 ### 3. 表分区 (Table Partitioning)
 
-**适用场景：** 数据表超过 1 亿行、时间序列数据、需要定期删除旧数据。
+**适用场景：** 表数据量 > 1 亿行，时序数据，需要删除旧数据。
 
 ```sql
--- ✅ 正确示例：按月分区
+-- ✅ 正确：按月分区
 CREATE TABLE events (
   id bigint GENERATED ALWAYS AS IDENTITY,
   created_at timestamptz NOT NULL,
@@ -260,35 +260,35 @@ CREATE TABLE events_2024_02 PARTITION OF events
   FOR VALUES FROM ('2024-02-01') TO ('2024-03-01');
 
 -- 瞬间删除旧数据
-DROP TABLE events_2023_01;  -- 瞬间完成，对比 DELETE 可能需要数小时
+DROP TABLE events_2023_01;  -- 瞬间完成，而 DELETE 可能需要数小时
 ```
 
 ### 4. 使用小写标识符
 
 ```sql
--- ❌ 错误示例：双引号引起来的混合大小写标识符在任何地方都需要加引号
+-- ❌ 错误：带引号的混合大小写要求到处都要加引号
 CREATE TABLE "Users" ("userId" bigint, "firstName" text);
 SELECT "firstName" FROM "Users";  -- 必须加引号！
 
--- ✅ 正确示例：小写标识符不需要加引号即可工作
+-- ✅ 正确：小写不需要引号
 CREATE TABLE users (user_id bigint, first_name text);
 SELECT first_name FROM users;
 ```
 
 ---
 
-## 安全性与行级安全性 (RLS)
+## 安全与行级安全性 (RLS)
 
 ### 1. 为多租户数据启用 RLS
 
-**影响：** 关键级别 - 数据库强制执行的租户隔离。
+**影响：** 关键（CRITICAL）- 数据库层面强制执行的租户隔离。
 
 ```sql
--- ❌ 错误示例：仅靠应用程序过滤
+-- ❌ 错误：仅靠应用层过滤
 SELECT * FROM orders WHERE user_id = $current_user_id;
--- 一旦出现 Bug 意味着所有订单都会暴露！
+-- 一旦有 Bug 意味着所有订单都会暴露！
 
--- ✅ 正确示例：数据库强制执行 RLS
+-- ✅ 正确：数据库层强制执行 RLS
 ALTER TABLE orders ENABLE ROW LEVEL SECURITY;
 ALTER TABLE orders FORCE ROW LEVEL SECURITY;
 
@@ -308,25 +308,25 @@ CREATE POLICY orders_user_policy ON orders
 **影响：** RLS 查询速度提升 5-10 倍。
 
 ```sql
--- ❌ 错误示例：每行都调用一次函数
+-- ❌ 错误：每行都调用函数
 CREATE POLICY orders_policy ON orders
-  USING (auth.uid() = user_id);  -- 处理 100 万行时会调用 100 万次！
+  USING (auth.uid() = user_id);  -- 对 100 万行调用 100 万次！
 
--- ✅ 正确示例：包装在 SELECT 中 (会被缓存，仅调用一次)
+-- ✅ 正确：包装在 SELECT 中（会被缓存，仅调用一次）
 CREATE POLICY orders_policy ON orders
   USING ((SELECT auth.uid()) = user_id);  -- 速度快 100 倍
 
--- 务必在 RLS 策略涉及的列上建立索引
+-- 始终索引 RLS 策略涉及的列
 CREATE INDEX orders_user_id_idx ON orders (user_id);
 ```
 
-### 3. 最小权限访问
+### 3. 最小权限访问 (Least Privilege Access)
 
 ```sql
--- ❌ 错误示例：权限过大
+-- ❌ 错误：权限过大
 GRANT ALL PRIVILEGES ON ALL TABLES TO app_user;
 
--- ✅ 正确示例：最小权限
+-- ✅ 正确：最小权限
 CREATE ROLE app_readonly NOLOGIN;
 GRANT USAGE ON SCHEMA public TO app_readonly;
 GRANT SELECT ON public.products, public.categories TO app_readonly;
@@ -345,15 +345,15 @@ REVOKE ALL ON SCHEMA public FROM public;
 
 ### 1. 连接限制
 
-**计算公式：** `(RAM_in_MB / 5MB_per_connection) - reserved`
+**公式：** `(内存_MB / 每连接_5MB) - 预留空间`
 
 ```sql
--- 以 4GB RAM 为例
+-- 4GB 内存示例
 ALTER SYSTEM SET max_connections = 100;
-ALTER SYSTEM SET work_mem = '8MB';  -- 8MB * 100 = 800MB 最大消耗
+ALTER SYSTEM SET work_mem = '8MB';  -- 8MB * 100 = 最大 800MB
 SELECT pg_reload_conf();
 
--- 监控连接情况
+-- 监控连接
 SELECT count(*), state FROM pg_stat_activity GROUP BY state;
 ```
 
@@ -367,59 +367,59 @@ SELECT pg_reload_conf();
 
 ### 3. 使用连接池 (Connection Pooling)
 
-- **事务模式 (Transaction mode)**：最适用于大多数应用 (连接在每个事务后返回)。
-- **会话模式 (Session mode)**：用于预处理语句、临时表。
-- **连接池大小**：`(CPU_cores * 2) + spindle_count`
+- **事务模式 (Transaction mode)**：适用于大多数应用（每个事务后返回连接）。
+- **会话模式 (Session mode)**：用于预处理语句（Prepared statements）、临时表。
+- **池大小 (Pool size)**：`(CPU 核心数 * 2) + 磁盘驱动器数量`
 
 ---
 
-## 并发与锁定 (Concurrency & Locking)
+## 并发与锁 (Concurrency & Locking)
 
 ### 1. 保持事务短小
 
 ```sql
--- ❌ 错误示例：在调用外部 API 期间持有锁
+-- ❌ 错误：在外部 API 调用期间持有锁
 BEGIN;
 SELECT * FROM orders WHERE id = 1 FOR UPDATE;
--- HTTP 调用耗时 5 秒...
+-- HTTP 调用花费了 5 秒...
 UPDATE orders SET status = 'paid' WHERE id = 1;
 COMMIT;
 
--- ✅ 正确示例：最小化锁持有时长
--- 先在事务外部完成 API 调用
+-- ✅ 正确：最小化持锁时间
+-- 先进行 API 调用，在事务之外
 BEGIN;
 UPDATE orders SET status = 'paid', payment_id = $1
 WHERE id = $2 AND status = 'pending'
 RETURNING *;
-COMMIT;  -- 锁仅持有几毫秒
+COMMIT;  -- 持锁时间仅为毫秒级
 ```
 
-### 2. 预防死锁
+### 2. 防止死锁 (Deadlocks)
 
 ```sql
--- ❌ 错误示例：不一致的加锁顺序导致死锁
--- 事务 A：锁定行 1，然后锁定行 2
--- 事务 B：锁定行 2，然后锁定行 1
--- 死锁发生！
+-- ❌ 错误：不一致的加锁顺序导致死锁
+-- 事务 A：锁定第 1 行，然后是第 2 行
+-- 事务 B：锁定第 2 行，然后是第 1 行
+-- 死锁！
 
--- ✅ 正确示例：一致的加锁顺序
+-- ✅ 正确：一致的加锁顺序
 BEGIN;
 SELECT * FROM accounts WHERE id IN (1, 2) ORDER BY id FOR UPDATE;
--- 现在两行都已锁定，可以按任何顺序更新
+-- 现在两行都被锁定了，可以按任何顺序更新
 UPDATE accounts SET balance = balance - 100 WHERE id = 1;
 UPDATE accounts SET balance = balance + 100 WHERE id = 2;
 COMMIT;
 ```
 
-### 3. 队列使用 SKIP LOCKED
+### 3. 在队列中使用 SKIP LOCKED
 
-**影响：** 工作队列吞吐量提升 10 倍。
+**影响：** 提升工作队列吞吐量 10 倍。
 
 ```sql
--- ❌ 错误示例：工作线程互相等待
+-- ❌ 错误：工作进程互相等待
 SELECT * FROM jobs WHERE status = 'pending' LIMIT 1 FOR UPDATE;
 
--- ✅ 正确示例：工作线程跳过已锁定的行
+-- ✅ 正确：工作进程跳过已锁定的行
 UPDATE jobs
 SET status = 'processing', worker_id = $1, started_at = now()
 WHERE id = (
@@ -438,39 +438,39 @@ RETURNING *;
 
 ### 1. 批量插入 (Batch Inserts)
 
-**影响：** 大批量插入速度提升 10-50 倍。
+**影响：** 批量插入速度提升 10-50 倍。
 
 ```sql
--- ❌ 错误示例：单条插入
+-- ❌ 错误：逐条插入
 INSERT INTO events (user_id, action) VALUES (1, 'click');
 INSERT INTO events (user_id, action) VALUES (2, 'view');
--- 1000 次往返请求
+-- 需要 1000 次往返（Round trips）
 
--- ✅ 正确示例：批量插入
+-- ✅ 正确：批量插入
 INSERT INTO events (user_id, action) VALUES
   (1, 'click'),
   (2, 'view'),
   (3, 'click');
--- 1 次往返请求
+-- 1 次往返
 
--- ✅ 最佳实践：对于极大数据集使用 COPY
+-- ✅ 最佳：对大数据集使用 COPY
 COPY events (user_id, action) FROM '/path/to/data.csv' WITH (FORMAT csv);
 ```
 
 ### 2. 消除 N+1 查询
 
 ```sql
--- ❌ 错误示例：N+1 模式
+-- ❌ 错误：N+1 模式
 SELECT id FROM users WHERE active = true;  -- 返回 100 个 ID
 -- 然后执行 100 次查询：
 SELECT * FROM orders WHERE user_id = 1;
 SELECT * FROM orders WHERE user_id = 2;
 -- ... 还有 98 次
 
--- ✅ 正确示例：使用 ANY 执行单词查询
+-- ✅ 正确：使用 ANY 进行单次查询
 SELECT * FROM orders WHERE user_id = ANY(ARRAY[1, 2, 3, ...]);
 
--- ✅ 正确示例：使用 JOIN
+-- ✅ 正确：使用 JOIN
 SELECT u.id, u.name, o.*
 FROM users u
 LEFT JOIN orders o ON o.user_id = u.id
@@ -479,26 +479,26 @@ WHERE u.active = true;
 
 ### 3. 基于游标的分页 (Cursor-Based Pagination)
 
-**影响：** 无论页码深度如何，均能保持稳定的 O(1) 性能。
+**影响：** 无论页码多深，始终保持一致的 O(1) 性能。
 
 ```sql
--- ❌ 错误示例：OFFSET 在页数深时变慢
+-- ❌ 错误：OFFSET 随着深度增加而变慢
 SELECT * FROM products ORDER BY id LIMIT 20 OFFSET 199980;
 -- 扫描了 200,000 行！
 
--- ✅ 正确示例：基于游标 (始终快速)
+-- ✅ 正确：基于游标（始终很快）
 SELECT * FROM products WHERE id > 199980 ORDER BY id LIMIT 20;
 -- 使用索引，O(1)
 ```
 
-### 4. 使用 UPSERT 执行“插入或更新”
+### 4. 使用 UPSERT 进行“插入或更新”
 
 ```sql
--- ❌ 错误示例：竞态条件
+-- ❌ 错误：竞态条件（Race condition）
 SELECT * FROM settings WHERE user_id = 123 AND key = 'theme';
--- 两个线程都没找到结果，都执行插入，其中一个会失败
+-- 两个线程都没发现记录，都尝试插入，其中一个失败
 
--- ✅ 正确示例：原子的 UPSERT
+-- ✅ 正确：原子性的 UPSERT
 INSERT INTO settings (user_id, key, value)
 VALUES (123, 'theme', 'dark')
 ON CONFLICT (user_id, key)
@@ -538,9 +538,9 @@ SELECT * FROM orders WHERE customer_id = 123;
 | 指标 | 问题 | 解决方案 |
 |-----------|---------|----------|
 | 大表上的 `Seq Scan` | 缺失索引 | 在过滤列上添加索引 |
-| `Rows Removed by Filter` 很高 | 区分度差 | 检查 WHERE 子句 |
+| `Rows Removed by Filter` 过高 | 区分度（Selectivity）差 | 检查 WHERE 子句 |
 | `Buffers: read >> hit` | 数据未缓存 | 增加 `shared_buffers` |
-| `Sort Method: external merge` | `work_mem` 过低 | 增加 `work_mem` |
+| `Sort Method: external merge` | `work_mem` 太低 | 增加 `work_mem` |
 
 ### 3. 维护统计信息
 
@@ -548,12 +548,12 @@ SELECT * FROM orders WHERE customer_id = 123;
 -- 分析特定表
 ANALYZE orders;
 
--- 检查上次分析时间
+-- 检查上次分析的时间
 SELECT relname, last_analyze, last_autoanalyze
 FROM pg_stat_user_tables
 ORDER BY last_analyze NULLS FIRST;
 
--- 为高频变动的表调整自动清理 (autovacuum)
+-- 为高频变动的表调整 autovacuum
 ALTER TABLE orders SET (
   autovacuum_vacuum_scale_factor = 0.05,
   autovacuum_analyze_scale_factor = 0.02
@@ -564,22 +564,22 @@ ALTER TABLE orders SET (
 
 ## JSONB 模式 (JSONB Patterns)
 
-### 1. 为 JSONB 列建立索引
+### 1. 为 JSONB 列创建索引
 
 ```sql
--- 为包含运算符建立 GIN 索引
+-- 为包含运算符创建 GIN 索引
 CREATE INDEX products_attrs_gin ON products USING gin (attributes);
 SELECT * FROM products WHERE attributes @> '{"color": "red"}';
 
--- 为特定键建立表达式索引
+-- 为特定键创建表达式索引
 CREATE INDEX products_brand_idx ON products ((attributes->>'brand'));
 SELECT * FROM products WHERE attributes->>'brand' = 'Nike';
 
--- jsonb_path_ops：体积缩小 2-3 倍，仅支持 @> 运算符
+-- jsonb_path_ops：体积减小 2-3 倍，但仅支持 @>
 CREATE INDEX idx ON products USING gin (attributes jsonb_path_ops);
 ```
 
-### 2. 使用 tsvector 进行全文检索
+### 2. 使用 tsvector 进行全文检索 (Full-Text Search)
 
 ```sql
 -- 添加生成的 tsvector 列
@@ -594,7 +594,7 @@ CREATE INDEX articles_search_idx ON articles USING gin (search_vector);
 SELECT * FROM articles
 WHERE search_vector @@ to_tsquery('english', 'postgresql & performance');
 
--- 带权重排名
+-- 带排名（Ranking）
 SELECT *, ts_rank(search_vector, query) as rank
 FROM articles, to_tsquery('english', 'postgresql') query
 WHERE search_vector @@ query
@@ -603,52 +603,52 @@ ORDER BY rank DESC;
 
 ---
 
-## 需要警示的反模式 (Anti-Patterns to Flag)
+## 需要标记的反模式 (Anti-Patterns to Flag)
 
 ### ❌ 查询反模式
-- 在生产环境代码中使用 `SELECT *`
+- 生产代码中使用 `SELECT *`
 - WHERE/JOIN 列缺失索引
-- 在大表上使用 OFFSET 分页
+- 大表上的 OFFSET 分页
 - N+1 查询模式
-- 未参数化的查询 (存在 SQL 注入风险)
+- 未参数化的查询（存在 SQL 注入风险）
 
-### ❌ 模式设计反模式
-- ID 使用 `int` (应使用 `bigint`)
-- 无理由地使用 `varchar(255)` (应使用 `text`)
-- 不带时区的 `timestamp` (应使用 `timestamptz`)
-- 使用随机 UUID 作为主键 (应使用 UUIDv7 或 IDENTITY)
-- 使用需要加引号的混合大小写标识符
+### ❌ 模式反模式
+- ID 使用 `int`（应使用 `bigint`）
+- 无理由使用 `varchar(255)`（应使用 `text`）
+- 时间戳不带时区（应使用 `timestamptz`）
+- 使用随机 UUID 作为主键（应使用 UUIDv7 或 IDENTITY）
+- 混合大小写的标识符（强制要求引号）
 
-### ❌ 安全性反模式
+### ❌ 安全反模式
 - 向应用用户授予 `GRANT ALL`
 - 多租户表缺失 RLS
-- RLS 策略每行调用函数 (未包装在 SELECT 中)
-- RLS 策略涉及的列未建索引
+- RLS 策略每行调用函数（未包装在 SELECT 中）
+- 未索引的 RLS 策略涉及列
 
 ### ❌ 连接反模式
-- 未使用连接池
-- 未设置空闲超时
+- 没有连接池
+- 没有空闲超时
 - 在事务模式连接池中使用预处理语句
-- 在调用外部 API 期间持有锁
+- 在外部 API 调用期间持有锁
 
 ---
 
-## 审查检查清单 (Review Checklist)
+## 评审检查清单 (Review Checklist)
 
-### 在批准数据库更改前：
-- [ ] 所有 WHERE/JOIN 列都已建索引
-- [ ] 复合索引的列顺序正确
-- [ ] 数据类型合适 (bigint, text, timestamptz, numeric)
+### 在批准数据库更改之前：
+- [ ] 所有 WHERE/JOIN 列已建立索引
+- [ ] 复合索引中的列顺序正确
+- [ ] 数据类型正确（bigint, text, timestamptz, numeric）
 - [ ] 多租户表已启用 RLS
-- [ ] RLS 策略使用了 `(SELECT auth.uid())` 模式
-- [ ] 外键具有索引
-- [ ] 无 N+1 查询模式
+- [ ] RLS 策略使用 `(SELECT auth.uid())` 模式
+- [ ] 外键已建立索引
+- [ ] 没有 N+1 查询模式
 - [ ] 对复杂查询运行了 EXPLAIN ANALYZE
 - [ ] 使用了小写标识符
-- [ ] 事务保持短小
+- [ ] 保持事务短小
 
 ---
 
-**请记住**：数据库问题通常是应用程序性能问题的根源。请尽早优化查询和模式设计。使用 EXPLAIN ANALYZE 验证假设。务必为外键和 RLS 策略列建立索引。
+**记住**：数据库问题通常是应用性能问题的根源。应尽早优化查询和模式设计。使用 EXPLAIN ANALYZE 验证假设。务必索引外键和 RLS 策略列。
 
-*模式参考自 [Supabase Agent Skills](https://github.com/supabase/agent-skills)，基于 MIT 许可。*
+*模式改编自 [Supabase Agent Skills](https://github.com/supabase/agent-skills)，遵循 MIT 许可。*
diff --git a/docs/zh-TW/README.md b/docs/zh-TW/README.md
new file mode 100644
index 0000000..c4cea37
--- /dev/null
+++ b/docs/zh-TW/README.md
@@ -0,0 +1,424 @@
+# Everything Claude Code
+
+[![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)
+![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
+![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)
+![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)
+
+**来自 Anthropic 黑客松冠军的完整 Claude Code 配置集。**
+
+经过 10 个月以上密集日常使用、打造真实产品所淬炼出的生产就绪智能体（Agents）、技能（Skills）、钩子（Hooks）、指令（Commands）、规则（Rules）和 MCP 配置。
+
+---
+
+## 指南
+
+本仓库仅包含原始代码。指南会解释所有内容。
+
+<table>
+<tr>
+<td width="50%">
+<a href="https://x.com/affaanmustafa/status/2012378465664745795">
+<img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="Everything Claude Code 简明指南" />
+</a>
+</td>
+<td width="50%">
+<a href="https://x.com/affaanmustafa/status/2014040193557471352">
+<img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="Everything Claude Code 完整指南" />
+</a>
+</td>
+</tr>
+<tr>
+<td align="center"><b>简明指南</b><br/>配置、基础、理念。<b>请先阅读此指南。</b></td>
+<td align="center"><b>完整指南</b><br/>Token 优化、记忆持久化、评估、并行处理。</td>
+</tr>
+</table>
+
+| 主题 | 学习内容 |
+|------|----------|
+| Token 优化 | 模型选择、系统提示精简、后台进程 |
+| 记忆持久化 | 自动跨会话（Session）保存/加载上下文的钩子（Hooks） |
+| 持续学习 | 从会话中自动提取模式并转化为可重用技能（Skills） |
+| 验证循环 | 检查点 vs 持续评估、评分器类型、pass@k 指标 |
+| 并行处理 | Git worktrees、串联方法、何时扩展实例 |
+| 子智能体协调 | 上下文问题、渐进式检索模式 |
+
+---
+
+## 跨平台支持
+
+此插件现已完整支持 **Windows、macOS 和 Linux**。所有钩子和脚本已使用 Node.js 重写以获得最佳兼容性。
+
+### 包管理器检测
+
+插件会自动检测您偏好的包管理器（npm、pnpm、yarn 或 bun），优先级如下：
+
+1. **环境变量**：`CLAUDE_PACKAGE_MANAGER`
+2. **项目配置**：`.claude/package-manager.json`
+3. **package.json**：`packageManager` 字段
+4. **锁文件**：从 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 检测
+5. **全局配置**：`~/.claude/package-manager.json`
+6. **备选方案**：第一个可用的包管理器
+
+设置您偏好的包管理器：
+
+```bash
+# 通过环境变量
+export CLAUDE_PACKAGE_MANAGER=pnpm
+
+# 通过全局配置
+node scripts/setup-package-manager.js --global pnpm
+
+# 通过项目配置
+node scripts/setup-package-manager.js --project bun
+
+# 检测当前配置
+node scripts/setup-package-manager.js --detect
+```
+
+或在 Claude Code 中使用 `/setup-pm` 指令。
+
+---
+
+## 内容概览
+
+本仓库是一个 **Claude Code 插件** - 可直接安装或手动复制组件。
+
+```
+everything-claude-code/
+|-- .claude-plugin/   # 插件和市场清单
+|   |-- plugin.json         # 插件元数据和组件路径
+|   |-- marketplace.json    # 用于 /plugin marketplace add 的市场目录
+|
+|-- agents/           # 用于委派任务的专门子智能体（Agents）
+|   |-- planner.md           # 功能实现规划
+|   |-- architect.md         # 系统设计决策
+|   |-- tdd-guide.md         # 测试驱动开发
+|   |-- code-reviewer.md     # 质量与安全审查
+|   |-- security-reviewer.md # 漏洞分析
+|   |-- build-error-resolver.md
+|   |-- e2e-runner.md        # Playwright E2E 测试
+|   |-- refactor-cleaner.md  # 无用代码清理
+|   |-- doc-updater.md       # 文档同步
+|   |-- go-reviewer.md       # Go 代码审查（新增）
+|   |-- go-build-resolver.md # Go 构建错误解决（新增）
+|
+|-- skills/           # 工作流（Workflow）定义和领域知识
+|   |-- coding-standards/           # 编程语言最佳实践
+|   |-- backend-patterns/           # API、数据库、缓存模式
+|   |-- frontend-patterns/          # React、Next.js 模式
+|   |-- continuous-learning/        # 从会话中自动提取模式（完整指南）
+|   |-- continuous-learning-v2/     # 基于本能的学习与信心评分
+|   |-- iterative-retrieval/        # 子代理的渐进式上下文精炼
+|   |-- strategic-compact/          # 手动压缩建议（完整指南）
+|   |-- tdd-workflow/               # TDD 方法论
+|   |-- security-review/            # 安全性检查清单
+|   |-- eval-harness/               # 验证循环评估（完整指南）
+|   |-- verification-loop/          # 持续验证（完整指南）
+|   |-- golang-patterns/            # Go 惯用法和最佳实践（新增）
+|   |-- golang-testing/             # Go 测试模式、TDD、基准测试（新增）
+|
+|-- commands/         # 快速执行的斜杠指令（Commands）
+|   |-- tdd.md              # /tdd - 测试驱动开发
+|   |-- plan.md             # /plan - 实现规划
+|   |-- e2e.md              # /e2e - E2E 测试生成
+|   |-- code-review.md      # /code-review - 质量审查
+|   |-- build-fix.md        # /build-fix - 修复构建错误
+|   |-- refactor-clean.md   # /refactor-clean - 移除无用代码
+|   |-- learn.md            # /learn - 会话中提取模式（完整指南）
+|   |-- checkpoint.md       # /checkpoint - 保存验证状态（完整指南）
+|   |-- verify.md           # /verify - 执行验证循环（完整指南）
+|   |-- setup-pm.md         # /setup-pm - 设置包管理器
+|   |-- go-review.md        # /go-review - Go 代码审查（新增）
+|   |-- go-test.md          # /go-test - Go TDD 工作流（新增）
+|   |-- go-build.md         # /go-build - 修复 Go 构建错误（新增）
+|
+|-- rules/            # 必须遵守的准则（Rules）（复制到 ~/.claude/rules/）
+|   |-- security.md         # 强制性安全检查
+|   |-- coding-style.md     # 不变性、文件组织
+|   |-- testing.md          # TDD、80% 覆盖率要求
+|   |-- git-workflow.md     # 提交格式、PR 流程
+|   |-- agents.md           # 何时委派给子智能体
+|   |-- performance.md      # 模型选择、上下文管理
+|
+|-- hooks/            # 基于触发器的自动化钩子（Hooks）
+|   |-- hooks.json                # 所有钩子配置（PreToolUse、PostToolUse、Stop 等）
+|   |-- memory-persistence/       # 会话生命周期钩子（完整指南）
+|   |-- strategic-compact/        # 压缩建议（完整指南）
+|
+|-- scripts/          # 跨平台 Node.js 脚本（新增）
+|   |-- lib/                     # 共享工具
+|   |   |-- utils.js             # 跨平台文件/路径/系统工具
+|   |   |-- package-manager.js   # 包管理器检测与选择
+|   |-- hooks/                   # 钩子实现
+|   |   |-- session-start.js     # 会话开始时加载上下文
+|   |   |-- session-end.js       # 会话结束时保存状态
+|   |   |-- pre-compact.js       # 压缩前状态保存
+|   |   |-- suggest-compact.js   # 策略性压缩建议
+|   |   |-- evaluate-session.js  # 从会话中提取模式
+|   |-- setup-package-manager.js # 交互式包管理器设置
+|
+|-- tests/            # 测试套件（新增）
+|   |-- lib/                     # 库测试
+|   |-- hooks/                   # 钩子测试
+|   |-- run-all.js               # 执行所有测试
+|
+|-- contexts/         # 动态系统提示词（Prompt）注入上下文（完整指南）
+|   |-- dev.md              # 开发模式上下文
+|   |-- review.md           # 代码审查模式上下文
+|   |-- research.md         # 研究/探索模式上下文
+|
+|-- examples/         # 示例配置和会话
+|   |-- CLAUDE.md           # 项目级配置示例
+|   |-- user-CLAUDE.md      # 用户级配置示例
+|
+|-- mcp-configs/      # MCP 服务器配置
+|   |-- mcp-servers.json    # GitHub、Supabase、Vercel、Railway 等
+|
+|-- marketplace.json  # 自托管市场配置（用于 /plugin marketplace add）
+```
+
+---
+
+## 生态系统工具
+
+### ecc.tools - 技能生成器
+
+从您的仓库自动生成 Claude Code 技能（Skills）。
+
+[安装 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)
+
+分析您的仓库并创建：
+- **SKILL.md 文件** - 可直接用于 Claude Code 的技能
+- **本能集合** - 用于 continuous-learning-v2
+- **模式提取** - 从您的提交历史学习
+
+```bash
+# 安装 GitHub App 后，技能会出现在：
+~/.claude/skills/generated/
+```
+
+与 `continuous-learning-v2` 技能无缝整合以继承本能。
+
+---
+
+## 安装
+
+### 选项 1：以插件（Plugin）安装（推荐）
+
+使用本仓库最简单的方式 - 安装为 Claude Code 插件：
+
+```bash
+# 将此仓库添加为市场
+/plugin marketplace add affaan-m/everything-claude-code
+
+# 安装插件
+/plugin install everything-claude-code@everything-claude-code
+```
+
+或直接添加到您的 `~/.claude/settings.json`：
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "everything-claude-code": {
+      "source": {
+        "source": "github",
+        "repo": "affaan-m/everything-claude-code"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "everything-claude-code@everything-claude-code": true
+  }
+}
+```
+
+这会让您立即访问所有指令、智能体、技能和钩子。
+
+---
+
+### 选项 2：手动安装
+
+如果您偏好手动控制安装内容：
+
+```bash
+# 克隆仓库
+git clone https://github.com/affaan-m/everything-claude-code.git
+
+# 将智能体复制到您的 Claude 配置
+cp everything-claude-code/agents/*.md ~/.claude/agents/
+
+# 复制规则
+cp everything-claude-code/rules/*.md ~/.claude/rules/
+
+# 复制指令
+cp everything-claude-code/commands/*.md ~/.claude/commands/
+
+# 复制技能
+cp -r everything-claude-code/skills/* ~/.claude/skills/
+```
+
+#### 将钩子添加到 settings.json
+
+将 `hooks/hooks.json` 中的钩子复制到您的 `~/.claude/settings.json`。
+
+#### 配置 MCP
+
+将 `mcp-configs/mcp-servers.json` 中所需的 MCP 服务器配置复制到您的 `~/.claude.json`。
+
+**重要：** 将 `YOUR_*_HERE` 占位符替换为您实际的 API 密钥。
+
+---
+
+## 核心概念
+
+### 智能体（Agents）
+
+子智能体以有限范围处理委派的任务。示例：
+
+```markdown
+---
+name: code-reviewer
+description: Reviews code for quality, security, and maintainability
+tools: ["Read", "Grep", "Glob", "Bash"]
+model: opus
+---
+
+You are a senior code reviewer...
+```
+
+### 技能（Skills）
+
+技能是由指令或智能体调用的工作流定义：
+
+```markdown
+# TDD Workflow
+
+1. Define interfaces first
+2. Write failing tests (RED)
+3. Implement minimal code (GREEN)
+4. Refactor (IMPROVE)
+5. Verify 80%+ coverage
+```
+
+### 钩子（Hooks）
+
+钩子在工具（Tool）事件时触发。示例 - 警告 console.log：
+
+```json
+{
+  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
+  "hooks": [{
+    "type": "command",
+    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
+  }]
+}
+```
+
+### 规则（Rules）
+
+规则是必须遵守的准则。保持模块化：
+
+```
+~/.claude/rules/
+  security.md      # 禁止硬编码密钥
+  coding-style.md  # 不变性、文件组织
+  testing.md       # TDD、80% 覆盖率要求
+```
+
+---
+
+## 执行测试
+
+插件包含完整的测试套件：
+
+```bash
+# 执行所有测试
+node tests/run-all.js
+
+# 执行个别测试文件
+node tests/lib/utils.test.js
+node tests/lib/package-manager.test.js
+node tests/hooks/hooks.test.js
+```
+
+---
+
+## 贡献
+
+**欢迎并鼓励贡献。**
+
+本仓库旨在成为社区资源。如果您有：
+- 实用的智能体或技能
+- 巧妙的钩子
+- 更好的 MCP 配置
+- 改进的规则
+
+请贡献！详见 [CONTRIBUTING.md](CONTRIBUTING.md) 的指南。
+
+### 贡献想法
+
+- 特定语言的技能（Python、Rust 模式）- Go 现已包含！
+- 特定框架的配置（Django、Rails、Laravel）
+- DevOps 智能体（Kubernetes、Terraform、AWS）
+- 测试策略（不同框架）
+- 特定领域知识（ML、数据工程、移动开发）
+
+---
+
+## 背景
+
+我从实验性推出就开始使用 Claude Code。2025 年 9 月与 [@DRodriguezFX](https://x.com/DRodriguezFX) 一起使用 Claude Code 打造 [zenith.chat](https://zenith.chat)，赢得了 Anthropic x Forum Ventures 黑客松。
+
+这些配置已在多个生产应用程序中经过实战测试。
+
+---
+
+## 重要注意事项
+
+### 上下文窗口管理
+
+**关键：** 不要同时启用所有 MCP。启用过多工具会让您的 200k 上下文窗口缩减至 70k。
+
+经验法则：
+- 设置 20-30 个 MCP
+- 每个项目启用少于 10 个
+- 启用的工具少于 80 个
+
+在项目配置中使用 `disabledMcpServers` 来禁用未使用的 MCP。
+
+### 自定义
+
+这些配置适合我的工作流。您应该：
+1. 从您认同的部分开始
+2. 根据您的技术栈修改
+3. 移除不需要的部分
+4. 添加您自己的模式
+
+---
+
+## Star 历史
+
+[![Star History Chart](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code&type=Date)](https://star-history.com/#affaan-m/everything-claude-code&Date)
+
+---
+
+## 链接
+
+- **简明指南（从这里开始）：** [Everything Claude Code 简明指南](https://x.com/affaanmustafa/status/2012378465664745795)
+- **完整指南（进阶）：** [Everything Claude Code 完整指南](https://x.com/affaanmustafa/status/2014040193557471352)
+- **关注：** [@affaanmustafa](https://x.com/affaanmustafa)
+- **zenith.chat：** [zenith.chat](https://zenith.chat)
+
+---
+
+## 授权
+
+MIT - 自由使用、依需求修改、如可能请回馈贡献。
+
+---
+
+**如果有帮助请为本仓库点赞（Star）。阅读两份指南。打造伟大的作品。**
diff --git a/hooks/hooks.json b/hooks/hooks.json
index 04b4a82..4a974af 100644
--- a/hooks/hooks.json
+++ b/hooks/hooks.json
@@ -105,7 +105,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){try{execSync('npx prettier --write \"'+p+'\"',{stdio:['pipe','pipe','pipe']})}catch(e){}}console.log(d)})\""
+            "command": "node -e \"const{execFileSync}=require('child_process');const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){try{execFileSync('npx',['prettier','--write',p],{stdio:['pipe','pipe','pipe']})}catch(e){}}console.log(d)})\""
           }
         ],
         "description": "Auto-format JS/TS files with Prettier after edits"
diff --git a/scripts/hooks/check-console-log.js b/scripts/hooks/check-console-log.js
index e1aa3c2..9b25fc4 100755
--- a/scripts/hooks/check-console-log.js
+++ b/scripts/hooks/check-console-log.js
@@ -52,7 +52,7 @@ process.stdin.on('end', () => {
     if (hasConsole) {
       console.error('[Hook] Remove console.log statements before committing');
     }
-  } catch (error) {
+  } catch (_error) {
     // Silently ignore errors (git might not be available, etc.)
   }
 
diff --git a/scripts/hooks/session-end.js b/scripts/hooks/session-end.js
index cfc389d..b429db3 100644
--- a/scripts/hooks/session-end.js
+++ b/scripts/hooks/session-end.js
@@ -16,7 +16,6 @@ const {
   getTimeString,
   getSessionIdShort,
   ensureDir,
-  readFile,
   writeFile,
   replaceInFile,
   log
diff --git a/scripts/hooks/session-start.js b/scripts/hooks/session-start.js
index 5e38231..76fa600 100644
--- a/scripts/hooks/session-start.js
+++ b/scripts/hooks/session-start.js
@@ -8,7 +8,6 @@
  * files and notifies Claude of available context to load.
  */
 
-const path = require('path');
 const {
   getSessionsDir,
   getLearnedSkillsDir,
diff --git a/scripts/hooks/suggest-compact.js b/scripts/hooks/suggest-compact.js
index ae690b7..323e34c 100644
--- a/scripts/hooks/suggest-compact.js
+++ b/scripts/hooks/suggest-compact.js
@@ -14,7 +14,6 @@
  */
 
 const path = require('path');
-const fs = require('fs');
 const {
   getTempDir,
   readFile,
diff --git a/scripts/lib/package-manager.js b/scripts/lib/package-manager.js
index 0b95056..cd8f6ee 100644
--- a/scripts/lib/package-manager.js
+++ b/scripts/lib/package-manager.js
@@ -7,7 +7,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { commandExists, getClaudeDir, readFile, writeFile, log, runCommand } = require('./utils');
+const { commandExists, getClaudeDir, readFile, writeFile } = require('./utils');
 
 // Package manager definitions
 const PACKAGE_MANAGERS = {
diff --git a/scripts/lib/utils.js b/scripts/lib/utils.js
index ce0a05c..1fa4616 100644
--- a/scripts/lib/utils.js
+++ b/scripts/lib/utils.js
@@ -79,17 +79,34 @@ function getTimeString() {
   return `${hours}:${minutes}`;
 }
 
+/**
+ * Get the git repository name
+ */
+function getGitRepoName() {
+  const result = runCommand('git rev-parse --show-toplevel');
+  if (!result.success) return null;
+  return path.basename(result.output);
+}
+
+/**
+ * Get project name from git repo or current directory
+ */
+function getProjectName() {
+  const repoName = getGitRepoName();
+  if (repoName) return repoName;
+  return path.basename(process.cwd()) || null;
+}
+
 /**
  * Get short session ID from CLAUDE_SESSION_ID environment variable
- * Returns the last 8 characters for uniqueness with brevity
- * @param {string} fallback - Fallback value if no session ID (default: 'default')
+ * Returns last 8 characters, falls back to project name then 'default'
  */
 function getSessionIdShort(fallback = 'default') {
   const sessionId = process.env.CLAUDE_SESSION_ID;
-  if (!sessionId || sessionId.length === 0) {
-    return fallback;
+  if (sessionId && sessionId.length > 0) {
+    return sessionId.slice(-8);
   }
-  return sessionId.slice(-8);
+  return getProjectName() || fallback;
 }
 
 /**
@@ -148,7 +165,7 @@ function findFiles(dir, pattern, options = {}) {
           searchDir(fullPath);
         }
       }
-    } catch (err) {
+    } catch (_err) {
       // Ignore permission errors
     }
   }
@@ -373,7 +390,11 @@ module.exports = {
   getDateString,
   getTimeString,
   getDateTimeString,
+
+  // Session/Project
   getSessionIdShort,
+  getGitRepoName,
+  getProjectName,
 
   // File operations
   findFiles,
diff --git a/scripts/setup-package-manager.js b/scripts/setup-package-manager.js
index 1a6a8fa..bdc833b 100644
--- a/scripts/setup-package-manager.js
+++ b/scripts/setup-package-manager.js
@@ -19,10 +19,8 @@ const {
   setProjectPackageManager,
   getAvailablePackageManagers,
   detectFromLockFile,
-  detectFromPackageJson,
-  getSelectionPrompt
+  detectFromPackageJson
 } = require('./lib/package-manager');
-const { log } = require('./lib/utils');
 
 function showHelp() {
   console.log(`
diff --git a/skills/continuous-learning-v2/SKILL.md b/skills/continuous-learning-v2/SKILL.md
index a75269f..4d32138 100644
--- a/skills/continuous-learning-v2/SKILL.md
+++ b/skills/continuous-learning-v2/SKILL.md
@@ -1,27 +1,27 @@
 ---
 name: continuous-learning-v2
-description: 基于直觉的学习系统，通过钩子（hooks）观察会话，创建带有置信度评分的原子直觉（atomic instincts），并将其演化为技能/命令/智能体。
+description: 基于直觉（Instinct）的学习系统，通过钩子（Hooks）观测会话，创建带有置信度评分（Confidence Scoring）的原子直觉，并将其演进为技能（Skills）、命令（Commands）或智能体（Agents）。
 version: 2.0.0
 ---
 
-# 持续学习 v2 - 基于直觉的架构 (Instinct-Based Architecture)
+# 持续学习 v2 - 基于直觉的架构（Instinct-Based Architecture）
 
-一个高级学习系统，通过原子“直觉（instincts）”——带有置信度评分的小型习得行为，将你的 Claude Code 会话转化为可复用的知识。
+这是一个先进的学习系统，通过原子化“直觉（Instincts）”——即带有置信度评分的小型习得行为，将你的 Claude Code 会话转化为可复用的知识。
 
 ## v2 版本新特性
 
 | 特性 | v1 | v2 |
 |---------|----|----|
-| 观察 (Observation) | Stop 钩子（会话结束） | PreToolUse/PostToolUse (100% 可靠) |
-| 分析 (Analysis) | 主上下文 (Main context) | 后台智能体 (Haiku) |
-| 粒度 (Granularity) | 完整技能 (Full skills) | 原子“直觉（instincts）” |
-| 置信度 (Confidence) | 无 | 0.3-0.9 加权 |
-| 演化 (Evolution) | 直接转换为技能 | 直觉 → 聚类 → 技能/命令/智能体 |
-| 共享 (Sharing) | 无 | 导出/导入直觉 |
+| 观测（Observation） | Stop 钩子（会话结束时） | PreToolUse/PostToolUse (100% 可靠) |
+| 分析（Analysis） | 主上下文（Main context） | 后台智能体 (Haiku) |
+| 粒度（Granularity） | 完整技能（Full skills） | 原子化“直觉（Instincts）” |
+| 置信度（Confidence） | 无 | 0.3-0.9 加权评分 |
+| 演进（Evolution） | 直接转化为技能 | 直觉 → 聚类 → 技能/命令/智能体 |
+| 共享（Sharing） | 无 | 导出/导入直觉 |
 
-## 直觉模型 (The Instinct Model)
+## 直觉模型（The Instinct Model）
 
-“直觉（instinct）”是一个小型的习得行为：
+直觉（Instinct）是一种小型习得行为：
 
 ```yaml
 ---
@@ -32,41 +32,41 @@ domain: "code-style"
 source: "session-observation"
 ---
 
-# 偏好函数式风格 (Prefer Functional Style)
+# 偏好函数式风格（Prefer Functional Style）
 
-## 操作 (Action)
-在合适的时候，优先使用函数式模式而非类（class）。
+## 动作（Action）
+在合适的情况下，优先使用函数式模式（Functional Patterns）而非类（Classes）。
 
-## 证据 (Evidence)
-- 观察到 5 次偏好函数式模式的实例
-- 用户在 2025-01-15 将基于类的方法修正为函数式
+## 证据（Evidence）
+- 观测到 5 次函数式模式偏好实例
+- 用户在 2025-01-15 将基于类的方法修正为函数式方法
 ```
 
 **属性：**
-- **原子性 (Atomic)** — 一个触发器，一个动作
-- **置信度加权 (Confidence-weighted)** — 0.3 = 尝试性的，0.9 = 近乎确定
-- **领域标签 (Domain-tagged)** — code-style、testing、git、debugging、workflow 等
-- **证据支持 (Evidence-backed)** — 追踪是哪些观察结果创建了它
+- **原子化（Atomic）** — 一个触发器对应一个动作
+- **置信度加权（Confidence-weighted）** — 0.3 = 尝试性的，0.9 = 近乎确定
+- **领域标签（Domain-tagged）** — 代码风格（code-style）、测试（testing）、git、调试（debugging）、工作流（workflow）等
+- **证据支持（Evidence-backed）** — 追踪是哪些观测结果创建了它
 
 ## 工作原理
 
 ```
-会话活动 (Session Activity)
+会话活动（Session Activity）
       │
-      │ 钩子捕获提示词 + 工具使用 (100% 可靠)
+      │ 钩子（Hooks）捕获提示词 + 工具使用 (100% 可靠)
       ▼
 ┌─────────────────────────────────────────┐
 │         observations.jsonl              │
-│   (提示词, 工具调用, 结果)                 │
+│   (提示词、工具调用、执行结果)          │
 └─────────────────────────────────────────┘
       │
-      │ 观察者智能体读取 (后台运行, Haiku)
+      │ 观测者智能体读取 (后台运行, Haiku)
       ▼
 ┌─────────────────────────────────────────┐
-│          模式检测 (PATTERN DETECTION)    │
-│   • 用户修正 → 直觉                       │
-│   • 错误修复 → 直觉                       │
-│   • 重复工作流 → 直觉                     │
+│          模式检测（PATTERN DETECTION）  │
+│   • 用户修正 → 直觉                     │
+│   • 错误解决 → 直觉                     │
+│   • 重复工作流 → 直觉                   │
 └─────────────────────────────────────────┘
       │
       │ 创建/更新
@@ -88,11 +88,36 @@ source: "session-observation"
 └─────────────────────────────────────────┘
 ```
 
-## 快速开始
+## 快速入门
 
-### 1. 启用观察钩子 (Observation Hooks)
+### 1. 启用观测钩子（Observation Hooks）
 
-添加到你的 `~/.claude/settings.json`：
+将以下内容添加到你的 `~/.claude/settings.json` 中。
+
+**如果作为插件安装**（推荐）：
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh pre"
+      }]
+    }],
+    "PostToolUse": [{
+      "matcher": "*",
+      "hooks": [{
+        "type": "command",
+        "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh post"
+      }]
+    }]
+  }
+}
+```
+
+**如果手动安装**到 `~/.claude/skills`：
 
 ```json
 {
@@ -117,30 +142,32 @@ source: "session-observation"
 
 ### 2. 初始化目录结构
 
+Python CLI 会自动创建这些目录，但你也可以手动创建：
+
 ```bash
 mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands}}
 touch ~/.claude/homunculus/observations.jsonl
 ```
 
-### 3. 运行观察者智能体 (可选)
-
-观察者可以在后台运行，分析观察结果：
+### 3. 使用直觉命令
 
 ```bash
-# 启动后台观察者
-~/.claude/skills/continuous-learning-v2/agents/start-observer.sh
+/instinct-status     # 显示已习得的直觉及其置信度评分
+/evolve              # 将相关的直觉聚类为技能/命令
+/instinct-export     # 导出直觉以便分享
+/instinct-import     # 从他人处导入直觉
 ```
 
-## 命令
+## 命令（Commands）
 
 | 命令 | 描述 |
 |---------|-------------|
-| `/instinct-status` | 显示所有习得的直觉及其置信度 |
+| `/instinct-status` | 显示所有已习得的直觉及置信度 |
 | `/evolve` | 将相关的直觉聚类为技能/命令 |
-| `/instinct-export` | 导出直觉以便共享 |
+| `/instinct-export` | 导出直觉以便分享 |
 | `/instinct-import <file>` | 从他人处导入直觉 |
 
-## 配置
+## 配置（Configuration）
 
 编辑 `config.json`：
 
@@ -183,8 +210,8 @@ touch ~/.claude/homunculus/observations.jsonl
 ```
 ~/.claude/homunculus/
 ├── identity.json           # 你的个人资料、技术水平
-├── observations.jsonl      # 当前会话观察结果
-├── observations.archive/   # 已处理的观察结果
+├── observations.jsonl      # 当前会话观测结果
+├── observations.archive/   # 已处理的观测结果
 ├── instincts/
 │   ├── personal/           # 自动习得的直觉
 │   └── inherited/          # 从他人处导入的直觉
@@ -194,64 +221,64 @@ touch ~/.claude/homunculus/observations.jsonl
     └── commands/           # 生成的命令
 ```
 
-## 与技能创建器 (Skill Creator) 集成
+## 与 Skill Creator 集成
 
 当你使用 [Skill Creator GitHub App](https://skill-creator.app) 时，它现在会**同时**生成：
-- 传统的 SKILL.md 文件（为了向后兼容）
-- 直觉集合 (Instinct collections)（为了 v2 学习系统）
+- 传统的 SKILL.md 文件（用于向下兼容）
+- 直觉集合（用于 v2 学习系统）
 
-来自仓库分析的直觉带有 `source: "repo-analysis"` 标签，并包含源仓库的 URL。
+来自仓库分析的直觉具有 `source: "repo-analysis"` 属性，并包含源仓库 URL。
 
-## 置信度评分 (Confidence Scoring)
+## 置信度评分（Confidence Scoring）
 
-置信度会随时间演化：
+置信度随时间演进：
 
 | 分数 | 含义 | 行为 |
 |-------|---------|----------|
-| 0.3 | 尝试性 (Tentative) | 建议但不强制执行 |
-| 0.5 | 中等 (Moderate) | 在相关时应用 |
-| 0.7 | 强 (Strong) | 自动批准应用 |
-| 0.9 | 近乎确定 (Near-certain) | 核心行为 |
+| 0.3 | 尝试性的（Tentative） | 建议但不强制执行 |
+| 0.5 | 中等（Moderate） | 在相关时应用 |
+| 0.7 | 强（Strong） | 自动批准应用 |
+| 0.9 | 近乎确定（Near-certain） | 核心行为 |
 
-**置信度增加** 的情况：
-- 模式被重复观察到
+**置信度增加**的情况：
+- 模式被重复观测到
 - 用户没有修正建议的行为
 - 来自其他来源的类似直觉达成一致
 
-**置信度降低** 的情况：
+**置信度降低**的情况：
 - 用户明确修正了该行为
-- 模式在很长一段时间内没有被观察到
+- 模式长时间未被观测到
 - 出现矛盾的证据
 
-## 为什么使用钩子 (Hooks) 而非技能 (Skills) 进行观察？
+## 为什么使用钩子（Hooks）而非技能（Skills）进行观测？
 
-> “v1 依赖技能进行观察。技能是概率性的——根据 Claude 的判断，它们的触发率约为 50-80%。”
+> "v1 依赖技能进行观测。技能具有概率性——根据 Claude 的判断，其触发率约为 50-80%。"
 
-钩子（Hooks）的触发是 **100% 确定性**的。这意味着：
-- 每一个工具调用都会被观察到
+钩子（Hooks）的触发是 **100% 确定性的**。这意味着：
+- 每一个工具调用都会被观测到
 - 不会遗漏任何模式
 - 学习是全面的
 
-## 向后兼容性
+## 向下兼容性
 
 v2 完全兼容 v1：
 - 现有的 `~/.claude/skills/learned/` 技能仍然有效
-- Stop 钩子仍然运行（但现在也会输入到 v2 系统中）
-- 渐进式迁移路径：并行运行两者
+- Stop 钩子仍然运行（但现在也会为 v2 提供输入）
+- 渐进式迁移路径：两者并行运行
 
-## 隐私
+## 隐私（Privacy）
 
-- 观察结果保存在你的本地机器上
-- 只有 **直觉（instincts）**（即模式）可以被导出
-- 不会共享实际的代码或对话内容
-- 你可以控制哪些内容被导出
+- 观测结果保存在你本地机器上
+- 只有**直觉**（模式）可以被导出
+- 不会分享实际的代码或对话内容
+- 你可以控制导出的内容
 
 ## 相关链接
 
 - [Skill Creator](https://skill-creator.app) - 从仓库历史生成直觉
 - [Homunculus](https://github.com/humanplane/homunculus) - v2 架构的灵感来源
-- [The Longform Guide](https://x.com/affaanmustafa/status/2014040193557471352) - 持续学习章节
+- [长篇指南（The Longform Guide）](https://x.com/affaanmustafa/status/2014040193557471352) - 持续学习章节
 
 ---
 
-*基于直觉的学习：通过一次又一次的观察，教会 Claude 你的模式。*
+*基于直觉的学习：通过每一次观测，教会 Claude 你的模式。*
diff --git a/skills/continuous-learning-v2/commands/evolve.md b/skills/continuous-learning-v2/commands/evolve.md
index 9f33bdf..ec56f2b 100644
--- a/skills/continuous-learning-v2/commands/evolve.md
+++ b/skills/continuous-learning-v2/commands/evolve.md
@@ -1,11 +1,11 @@
 ---
 name: evolve
-description: 将相关本能（Instincts）聚类为技能、命令或智能体
+description: 将相关本能 (Instincts) 聚类为技能 (Skills)、命令 (Commands) 或智能体 (Agents)
 command: /evolve
 implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve
 ---
 
-# 演进（Evolve）命令
+# 演进 (Evolve) 命令
 
 ## 实现
 
@@ -13,23 +13,23 @@ implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct
 python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]
 ```
 
-分析本能（Instincts）并将相关的本能聚类为更高级别的结构：
-- **命令（Commands）**：当本能描述的是用户调用的操作时
-- **技能（Skills）**：当本能描述的是自动触发的行为时
-- **智能体（Agents）**：当本能描述的是复杂的、多步骤的过程时
+分析本能 (Instincts) 并将相关的本能聚类为更高级别的结构：
+- **命令 (Commands)**：当本能描述的是用户调用的操作时
+- **技能 (Skills)**：当本能描述的是自动触发的行为时
+- **智能体 (Agents)**：当本能描述的是复杂的、多步骤的过程时
 
 ## 用法
 
 ```
 /evolve                    # 分析所有本能并建议演进方案
-/evolve --domain testing   # 仅演进测试领域（testing domain）中的本能
+/evolve --domain testing   # 仅演进测试领域 (testing domain) 中的本能
 /evolve --dry-run          # 显示将要创建的内容而不实际执行
 /evolve --threshold 5      # 要求 5 个或更多相关本能才进行聚类
 ```
 
 ## 演进规则
 
-### → 命令（Command，用户调用）
+### → 命令 (Command，用户调用)
 当本能描述用户会显式请求的操作时：
 - 多个关于“当用户要求...”的本能
 - 带有“在创建新的 X 时”等触发器的本能
@@ -42,7 +42,7 @@ python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [
 
 → 创建：`/new-table` 命令
 
-### → 技能（Skill，自动触发）
+### → 技能 (Skill，自动触发)
 当本能描述应该自动发生的行为时：
 - 模式匹配触发器
 - 错误处理响应
@@ -55,9 +55,9 @@ python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [
 
 → 创建：`functional-patterns` 技能
 
-### → 智能体（Agent，需要深度/隔离）
+### → 智能体 (Agent，需要深度/隔离)
 当本能描述受益于隔离的复杂、多步骤过程时：
-- 调试工作流（Workflow）
+- 调试工作流 (Workflow)
 - 重构序列
 - 研究任务
 
@@ -85,7 +85,7 @@ python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [
 ## 输出格式
 
 ```
-🧬 演进分析（Evolve Analysis）
+🧬 演进分析 (Evolve Analysis)
 ==================
 
 发现 3 个已准备好演进的聚类：
@@ -121,7 +121,7 @@ python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [
 运行 `/evolve --execute` 来创建这些文件。
 ```
 
-## 标志（Flags）
+## 标志 (Flags)
 
 - `--execute`：实际创建演进后的结构（默认为预览）
 - `--dry-run`：预览而不创建
diff --git a/skills/continuous-learning-v2/commands/instinct-import.md b/skills/continuous-learning-v2/commands/instinct-import.md
index 7157b13..0107089 100644
--- a/skills/continuous-learning-v2/commands/instinct-import.md
+++ b/skills/continuous-learning-v2/commands/instinct-import.md
@@ -132,4 +132,4 @@ original_source: "session-observation"  # 或 "repo-analysis"
 新直觉已保存至：~/.claude/homunculus/instincts/inherited/
 
 运行 /instinct-status 查看所有直觉。
-```
+```
\ No newline at end of file
diff --git a/skills/continuous-learning-v2/hooks/observe.sh b/skills/continuous-learning-v2/hooks/observe.sh
index 31ffa0c..225c90e 100755
--- a/skills/continuous-learning-v2/hooks/observe.sh
+++ b/skills/continuous-learning-v2/hooks/observe.sh
@@ -5,15 +5,31 @@
 # Claude Code passes hook data via stdin as JSON.
 #
 # Hook config (in ~/.claude/settings.json):
+#
+# If installed as a plugin, use ${CLAUDE_PLUGIN_ROOT}:
 # {
 #   "hooks": {
 #     "PreToolUse": [{
 #       "matcher": "*",
-#       "hooks": [{ "type": "command", "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh" }]
+#       "hooks": [{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh pre" }]
 #     }],
 #     "PostToolUse": [{
 #       "matcher": "*",
-#       "hooks": [{ "type": "command", "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh" }]
+#       "hooks": [{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh post" }]
+#     }]
+#   }
+# }
+#
+# If installed manually to ~/.claude/skills:
+# {
+#   "hooks": {
+#     "PreToolUse": [{
+#       "matcher": "*",
+#       "hooks": [{ "type": "command", "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh pre" }]
+#     }],
+#     "PostToolUse": [{
+#       "matcher": "*",
+#       "hooks": [{ "type": "command", "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh post" }]
 #     }]
 #   }
 # }
diff --git a/tests/hooks/hooks.test.js b/tests/hooks/hooks.test.js
index e629a26..8994d40 100644
--- a/tests/hooks/hooks.test.js
+++ b/tests/hooks/hooks.test.js
@@ -8,7 +8,7 @@ const assert = require('assert');
 const path = require('path');
 const fs = require('fs');
 const os = require('os');
-const { execSync, spawn } = require('child_process');
+const { spawn } = require('child_process');
 
 // Test helper
 function test(name, fn) {
@@ -113,14 +113,19 @@ async function runTests() {
     // Run the script
     await runScript(path.join(scriptsDir, 'session-end.js'));
 
-    // Check if session file was created (default session ID)
+    // Check if session file was created
+    // Note: Without CLAUDE_SESSION_ID, falls back to project name (not 'default')
     // Use local time to match the script's getDateString() function
     const sessionsDir = path.join(os.homedir(), '.claude', 'sessions');
     const now = new Date();
     const today = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
-    const sessionFile = path.join(sessionsDir, `${today}-default-session.tmp`);
 
-    assert.ok(fs.existsSync(sessionFile), 'Session file should exist');
+    // Get the expected session ID (project name fallback)
+    const utils = require('../../scripts/lib/utils');
+    const expectedId = utils.getSessionIdShort();
+    const sessionFile = path.join(sessionsDir, `${today}-${expectedId}-session.tmp`);
+
+    assert.ok(fs.existsSync(sessionFile), `Session file should exist: ${sessionFile}`);
   })) passed++; else failed++;
 
   if (await asyncTest('includes session ID in filename', async () => {
@@ -296,7 +301,7 @@ async function runTests() {
       }
     };
 
-    for (const [eventType, hookArray] of Object.entries(hooks.hooks)) {
+    for (const [, hookArray] of Object.entries(hooks.hooks)) {
       checkHooks(hookArray);
     }
   })) passed++; else failed++;
@@ -320,11 +325,27 @@ async function runTests() {
       }
     };
 
-    for (const [eventType, hookArray] of Object.entries(hooks.hooks)) {
+    for (const [, hookArray] of Object.entries(hooks.hooks)) {
       checkHooks(hookArray);
     }
   })) passed++; else failed++;
 
+  // plugin.json validation
+  console.log('\nplugin.json Validation:');
+
+  if (test('plugin.json does NOT have explicit hooks declaration', () => {
+    // Claude Code automatically loads hooks/hooks.json by convention.
+    // Explicitly declaring it in plugin.json causes a duplicate detection error.
+    // See: https://github.com/affaan-m/everything-claude-code/issues/103
+    const pluginPath = path.join(__dirname, '..', '..', '.claude-plugin', 'plugin.json');
+    const plugin = JSON.parse(fs.readFileSync(pluginPath, 'utf8'));
+
+    assert.ok(
+      !plugin.hooks,
+      'plugin.json should NOT have "hooks" field - Claude Code auto-loads hooks/hooks.json'
+    );
+  })) passed++; else failed++;
+
   // Summary
   console.log('\n=== Test Results ===');
   console.log(`Passed: ${passed}`);
diff --git a/tests/lib/package-manager.test.js b/tests/lib/package-manager.test.js
index 75df3bc..fb496c0 100644
--- a/tests/lib/package-manager.test.js
+++ b/tests/lib/package-manager.test.js
@@ -11,7 +11,6 @@ const os = require('os');
 
 // Import the modules
 const pm = require('../../scripts/lib/package-manager');
-const utils = require('../../scripts/lib/utils');
 
 // Test helper
 function test(name, fn) {
diff --git a/tests/lib/utils.test.js b/tests/lib/utils.test.js
index 0679463..208ef15 100644
--- a/tests/lib/utils.test.js
+++ b/tests/lib/utils.test.js
@@ -7,7 +7,6 @@
 const assert = require('assert');
 const path = require('path');
 const fs = require('fs');
-const os = require('os');
 
 // Import the module
 const utils = require('../../scripts/lib/utils');
@@ -106,58 +105,52 @@ function runTests() {
     assert.ok(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(dt), `Expected YYYY-MM-DD HH:MM:SS, got ${dt}`);
   })) passed++; else failed++;
 
+  // Project name tests
+  console.log('\nProject Name Functions:');
+
+  if (test('getGitRepoName returns string or null', () => {
+    const repoName = utils.getGitRepoName();
+    assert.ok(repoName === null || typeof repoName === 'string');
+  })) passed++; else failed++;
+
+  if (test('getProjectName returns non-empty string', () => {
+    const name = utils.getProjectName();
+    assert.ok(name && name.length > 0);
+  })) passed++; else failed++;
+
   // Session ID tests
   console.log('\nSession ID Functions:');
 
-  if (test('getSessionIdShort returns default when no env var', () => {
-    const originalEnv = process.env.CLAUDE_SESSION_ID;
+  if (test('getSessionIdShort falls back to project name', () => {
+    const original = process.env.CLAUDE_SESSION_ID;
     delete process.env.CLAUDE_SESSION_ID;
     try {
       const shortId = utils.getSessionIdShort();
-      assert.strictEqual(shortId, 'default');
+      assert.strictEqual(shortId, utils.getProjectName());
     } finally {
-      if (originalEnv) process.env.CLAUDE_SESSION_ID = originalEnv;
+      if (original) process.env.CLAUDE_SESSION_ID = original;
     }
   })) passed++; else failed++;
 
   if (test('getSessionIdShort returns last 8 characters', () => {
-    const originalEnv = process.env.CLAUDE_SESSION_ID;
+    const original = process.env.CLAUDE_SESSION_ID;
     process.env.CLAUDE_SESSION_ID = 'test-session-abc12345';
     try {
-      const shortId = utils.getSessionIdShort();
-      assert.strictEqual(shortId, 'abc12345');
+      assert.strictEqual(utils.getSessionIdShort(), 'abc12345');
     } finally {
-      if (originalEnv) {
-        process.env.CLAUDE_SESSION_ID = originalEnv;
-      } else {
-        delete process.env.CLAUDE_SESSION_ID;
-      }
-    }
-  })) passed++; else failed++;
-
-  if (test('getSessionIdShort uses custom fallback', () => {
-    const originalEnv = process.env.CLAUDE_SESSION_ID;
-    delete process.env.CLAUDE_SESSION_ID;
-    try {
-      const shortId = utils.getSessionIdShort('custom');
-      assert.strictEqual(shortId, 'custom');
-    } finally {
-      if (originalEnv) process.env.CLAUDE_SESSION_ID = originalEnv;
+      if (original) process.env.CLAUDE_SESSION_ID = original;
+      else delete process.env.CLAUDE_SESSION_ID;
     }
   })) passed++; else failed++;
 
   if (test('getSessionIdShort handles short session IDs', () => {
-    const originalEnv = process.env.CLAUDE_SESSION_ID;
+    const original = process.env.CLAUDE_SESSION_ID;
     process.env.CLAUDE_SESSION_ID = 'short';
     try {
-      const shortId = utils.getSessionIdShort();
-      assert.strictEqual(shortId, 'short');
+      assert.strictEqual(utils.getSessionIdShort(), 'short');
     } finally {
-      if (originalEnv) {
-        process.env.CLAUDE_SESSION_ID = originalEnv;
-      } else {
-        delete process.env.CLAUDE_SESSION_ID;
-      }
+      if (original) process.env.CLAUDE_SESSION_ID = original;
+      else delete process.env.CLAUDE_SESSION_ID;
     }
   })) passed++; else failed++;
 
diff --git a/translation_workdir/cache/translation_db.json b/translation_workdir/cache/translation_db.json
index dda7d46..28081c5 100644
--- a/translation_workdir/cache/translation_db.json
+++ b/translation_workdir/cache/translation_db.json
@@ -4,8 +4,8 @@
     "content": "# Claude Code \u5168\u65b9\u4f4d\u901f\u67e5\u624b\u518c\n\n![\u9875\u7709\uff1aAnthropic \u9ed1\u5ba2\u677e\u83b7\u80dc\u8005 - Claude Code \u63d0\u793a\u4e0e\u6280\u5de7](./assets/images/shortform/00-header.png)\n\n---\n\n**\u81ea 2 \u6708\u4efd\u5b9e\u9a8c\u6027\u63a8\u51fa\u4ee5\u6765\uff0c\u6211\u4e00\u76f4\u662f Claude Code \u7684\u5fe0\u5b9e\u7528\u6237\u3002\u6211\u4e0e [@DRodriguezFX](https://x.com/DRodriguezFX) \u5408\u4f5c\uff0c\u5b8c\u5168\u4f7f\u7528 Claude Code \u5f00\u53d1\u4e86 [zenith.chat](https://zenith.chat)\uff0c\u5e76\u8d62\u5f97\u4e86 Anthropic x Forum Ventures \u9ed1\u5ba2\u677e\u3002**\n\n\u4ee5\u4e0b\u662f\u6211\u5728 10 \u4e2a\u6708\u7684\u65e5\u5e38\u4f7f\u7528\u540e\u603b\u7ed3\u51fa\u7684\u5b8c\u6574\u914d\u7f6e\uff1a\u6280\u80fd\uff08Skills\uff09\u3001\u751f\u547d\u5468\u671f\u94a9\u5b50\uff08Hooks\uff09\u3001\u5b50\u667a\u80fd\u4f53\uff08Subagents\uff09\u3001\u6a21\u578b\u4e0a\u4e0b\u6587\u534f\u8bae\uff08MCPs\uff09\u3001\u63d2\u4ef6\uff08Plugins\uff09\u4ee5\u53ca\u771f\u6b63\u884c\u4e4b\u6709\u6548\u7684\u5b9e\u8df5\u65b9\u6848\u3002\n\n---\n\n## \u6280\u80fd\uff08Skills\uff09\u4e0e\u547d\u4ee4\uff08Commands\uff09\n\n\u6280\u80fd\uff08Skills\uff09\u7c7b\u4f3c\u4e8e\u89c4\u5219\uff0c\u4f46\u88ab\u9650\u5b9a\u5728\u7279\u5b9a\u7684\u4f5c\u7528\u57df\u548c\u5de5\u4f5c\u6d41\u4e2d\u3002\u5f53\u4f60\u9700\u8981\u6267\u884c\u7279\u5b9a\u5de5\u4f5c\u6d41\u65f6\uff0c\u5b83\u4eec\u662f\u63d0\u793a\u8bcd\uff08Prompts\uff09\u7684\u5feb\u6377\u65b9\u5f0f\u3002\n\n\u5728\u4f7f\u7528 Opus 4.5 \u8fdb\u884c\u957f\u65f6\u95f4\u7f16\u7801\u540e\uff0c\u60f3\u8981\u6e05\u7406\u5e9f\u5f03\u4ee3\u7801\u548c\u6563\u843d\u7684 .md \u6587\u4ef6\uff1f\u8fd0\u884c `/refactor-clean`\u3002\u9700\u8981\u6d4b\u8bd5\uff1f\u4f7f\u7528 `/tdd`\u3001`/e2e`\u3001`/test-coverage`\u3002\u6280\u80fd\u8fd8\u53ef\u4ee5\u5305\u542b\u4ee3\u7801\u6620\u5c04\uff08Codemaps\uff09\u2014\u2014\u8fd9\u662f\u4e00\u79cd\u8ba9 Claude \u5feb\u901f\u5bfc\u822a\u4ee3\u7801\u5e93\u7684\u65b9\u6cd5\uff0c\u800c\u4e0d\u4f1a\u5728\u63a2\u7d22\u8fc7\u7a0b\u4e2d\u6d6a\u8d39\u4e0a\u4e0b\u6587\uff08Context\uff09\u3002\n\n![\u7ec8\u7aef\u663e\u793a\u94fe\u5f0f\u547d\u4ee4](./assets/images/shortform/02-chaining-commands.jpeg)\n*\u94fe\u5f0f\u8c03\u7528\u591a\u4e2a\u547d\u4ee4*\n\n\u547d\u4ee4\uff08Commands\uff09\u662f\u901a\u8fc7\u659c\u6760\u547d\u4ee4\uff08Slash Commands\uff09\u6267\u884c\u7684\u6280\u80fd\u3002\u5b83\u4eec\u5728\u529f\u80fd\u4e0a\u6709\u91cd\u53e0\uff0c\u4f46\u5b58\u50a8\u65b9\u5f0f\u4e0d\u540c\uff1a\n\n- **\u6280\u80fd (Skills)**: `~/.claude/skills/` - \u66f4\u5e7f\u6cdb\u7684\u5de5\u4f5c\u6d41\u5b9a\u4e49\n- **\u547d\u4ee4 (Commands)**: `~/.claude/commands/` - \u5feb\u901f\u53ef\u6267\u884c\u7684\u63d0\u793a\u8bcd\n\n```bash\n# \u793a\u4f8b\u6280\u80fd\u7ed3\u6784\n~/.claude/skills/\n  pmx-guidelines.md      # \u9879\u76ee\u7279\u5b9a\u6a21\u5f0f\n  coding-standards.md    # \u8bed\u8a00\u6700\u4f73\u5b9e\u8df5\n  tdd-workflow/          # \u5305\u542b README.md \u7684\u591a\u6587\u4ef6\u6280\u80fd\n  security-review/       # \u57fa\u4e8e\u6e05\u5355\u7684\u6280\u80fd\n```\n\n---\n\n## \u751f\u547d\u5468\u671f\u94a9\u5b50\uff08Hooks\uff09\n\n\u751f\u547d\u5468\u671f\u94a9\u5b50\uff08Hooks\uff09\u662f\u57fa\u4e8e\u89e6\u53d1\u5668\u7684\u81ea\u52a8\u5316\u529f\u80fd\uff0c\u5728\u7279\u5b9a\u4e8b\u4ef6\u53d1\u751f\u65f6\u89e6\u53d1\u3002\u4e0e\u6280\u80fd\u4e0d\u540c\uff0c\u5b83\u4eec\u88ab\u9650\u5236\u5728\u5de5\u5177\u8c03\u7528\uff08Tool Calls\uff09\u548c\u751f\u547d\u5468\u671f\u4e8b\u4ef6\u4e2d\u3002\n\n**\u94a9\u5b50\u7c7b\u578b\uff1a**\n\n1. **PreToolUse** - \u5de5\u5177\u6267\u884c\u524d\uff08\u9a8c\u8bc1\u3001\u63d0\u9192\uff09\n2. **PostToolUse** - \u5de5\u5177\u6267\u884c\u540e\uff08\u683c\u5f0f\u5316\u3001\u53cd\u9988\u5faa\u73af\uff09\n3. **UserPromptSubmit** - \u53d1\u9001\u6d88\u606f\u65f6\n4. **Stop** - Claude \u5b8c\u6210\u54cd\u5e94\u65f6\n5. **PreCompact** - \u4e0a\u4e0b\u6587\u538b\u7f29\u524d\n6. **Notification** - \u6743\u9650\u8bf7\u6c42\n\n**\u793a\u4f8b\uff1a\u5728\u6267\u884c\u8017\u65f6\u547d\u4ee4\u524d\u53d1\u9001 tmux \u63d0\u9192**\n\n```json\n{\n  \"PreToolUse\": [\n    {\n      \"matcher\": \"tool == \\\"Bash\\\" && tool_input.command matches \\\"(npm|pnpm|yarn|cargo|pytest)\\\"\",\n      \"hooks\": [\n        {\n          \"type\": \"command\",\n          \"command\": \"if [ -z \\\"$TMUX\\\" ]; then echo '[Hook] Consider tmux for session persistence' >&2; fi\"\n        }\n      ]\n    }\n  ]\n}\n```\n\n![PostToolUse \u94a9\u5b50\u53cd\u9988](./assets/images/shortform/03-posttooluse-hook.png)\n*\u8fd0\u884c PostToolUse \u94a9\u5b50\u65f6\u5728 Claude Code \u4e2d\u83b7\u5f97\u7684\u53cd\u9988\u793a\u4f8b*\n\n**\u4e13\u5bb6\u63d0\u793a\uff1a** \u4f7f\u7528 `hookify` \u63d2\u4ef6\u53ef\u4ee5\u901a\u8fc7\u5bf9\u8bdd\u65b9\u5f0f\u521b\u5efa\u94a9\u5b50\uff0c\u800c\u65e0\u9700\u624b\u52a8\u7f16\u5199 JSON\u3002\u8fd0\u884c `/hookify` \u5e76\u63cf\u8ff0\u4f60\u7684\u9700\u6c42\u5373\u53ef\u3002\n\n---\n\n## \u5b50\u667a\u80fd\u4f53\uff08Subagents\uff09\n\n\u5b50\u667a\u80fd\u4f53\uff08Subagents\uff09\u662f\u4f60\u7684\u7f16\u6392\u5668\uff08\u4e3b Claude \u5b9e\u4f8b\uff09\u53ef\u4ee5\u59d4\u6d3e\u4efb\u52a1\u7684\u8fdb\u7a0b\uff0c\u5177\u6709\u53d7\u9650\u7684\u4f5c\u7528\u57df\u3002\u5b83\u4eec\u53ef\u4ee5\u5728\u540e\u53f0\u6216\u524d\u53f0\u8fd0\u884c\uff0c\u4ece\u800c\u4e3a\u4e3b\u667a\u80fd\u4f53\u91ca\u653e\u4e0a\u4e0b\u6587\u7a7a\u95f4\u3002\n\n\u5b50\u667a\u80fd\u4f53\u4e0e\u6280\u80fd\u914d\u5408\u5f97\u975e\u5e38\u597d\u2014\u2014\u80fd\u591f\u6267\u884c\u90e8\u5206\u6280\u80fd\u96c6\u7684\u5b50\u667a\u80fd\u4f53\u53ef\u4ee5\u88ab\u59d4\u6d3e\u4efb\u52a1\u5e76\u81ea\u4e3b\u4f7f\u7528\u8fd9\u4e9b\u6280\u80fd\u3002\u5b83\u4eec\u8fd8\u53ef\u4ee5\u901a\u8fc7\u7279\u5b9a\u7684\u5de5\u5177\u6743\u9650\u8fdb\u884c\u6c99\u7bb1\u5316\u5904\u7406\u3002\n\n```bash\n# \u793a\u4f8b\u5b50\u667a\u80fd\u4f53\u7ed3\u6784\n~/.claude/agents/\n  planner.md           # \u529f\u80fd\u5b9e\u73b0\u89c4\u5212\n  architect.md         # \u7cfb\u7edf\u8bbe\u8ba1\u51b3\u7b56\n  tdd-guide.md         # \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\n  code-reviewer.md     # \u8d28\u91cf/\u5b89\u5168\u5ba1\u67e5\n  security-reviewer.md # \u6f0f\u6d1e\u5206\u6790\n  build-error-resolver.md\n  e2e-runner.md\n  refactor-cleaner.md\n```\n\n\u4e3a\u6bcf\u4e2a\u5b50\u667a\u80fd\u4f53\u914d\u7f6e\u5141\u8bb8\u7684\u5de5\u5177\u3001MCP \u548c\u6743\u9650\uff0c\u4ee5\u5b9e\u73b0\u9002\u5f53\u7684\u4f5c\u7528\u57df\u9650\u5b9a\u3002\n\n---\n\n## \u89c4\u5219\uff08Rules\uff09\u4e0e\u8bb0\u5fc6\uff08Memory\uff09\n\n\u4f60\u7684 `.rules` \u6587\u4ef6\u5939\u5b58\u653e\u7740 Claude \u5e94\u8be5\u59cb\u7ec8\u9075\u5faa\u7684\u6700\u4f73\u5b9e\u8df5 `.md` \u6587\u4ef6\u3002\u6709\u4e24\u79cd\u65b9\u6cd5\uff1a\n\n1. **\u5355\u4e2a CLAUDE.md** - \u6240\u6709\u5185\u5bb9\u653e\u5728\u4e00\u4e2a\u6587\u4ef6\u4e2d\uff08\u7528\u6237\u7ea7\u6216\u9879\u76ee\u7ea7\uff09\n2. **Rules \u6587\u4ef6\u5939** - \u6309\u5173\u6ce8\u70b9\u5206\u7ec4\u7684\u6a21\u5757\u5316 `.md` \u6587\u4ef6\n\n```bash\n~/.claude/rules/\n  security.md      # \u7981\u6b62\u786c\u7f16\u7801\u5bc6\u94a5\uff0c\u9a8c\u8bc1\u8f93\u5165\n  coding-style.md  # \u4e0d\u53ef\u53d8\u6027\uff0c\u6587\u4ef6\u7ec4\u7ec7\n  testing.md       # TDD \u5de5\u4f5c\u6d41\uff0c80% \u8986\u76d6\u7387\n  git-workflow.md  # \u63d0\u4ea4\u683c\u5f0f\uff0cPR \u6d41\u7a0b\n  agents.md        # \u4f55\u65f6\u59d4\u6d3e\u7ed9\u5b50\u667a\u80fd\u4f53\n  performance.md   # \u6a21\u578b\u9009\u62e9\uff0c\u4e0a\u4e0b\u6587\u7ba1\u7406\n```\n\n**\u793a\u4f8b\u89c4\u5219\uff1a**\n\n- \u4ee3\u7801\u5e93\u4e2d\u4e25\u7981\u4f7f\u7528\u8868\u60c5\u7b26\u53f7 (Emojis)\n- \u524d\u7aef\u907f\u514d\u4f7f\u7528\u7d2b\u8272\u8c03\n- \u90e8\u7f72\u524d\u59cb\u7ec8\u6d4b\u8bd5\u4ee3\u7801\n- \u4f18\u5148\u91c7\u7528\u6a21\u5757\u5316\u4ee3\u7801\u800c\u975e\u8d85\u5927\u6587\u4ef6\n- \u4e25\u7981\u63d0\u4ea4 `console.log`\n\n---\n\n## \u6a21\u578b\u4e0a\u4e0b\u6587\u534f\u8bae\uff08MCPs\uff09\n\n\u6a21\u578b\u4e0a\u4e0b\u6587\u534f\u8bae\uff08MCPs\uff09\u5c06 Claude \u76f4\u63a5\u8fde\u63a5\u5230\u5916\u90e8\u670d\u52a1\u3002\u5b83\u4e0d\u662f API \u7684\u66ff\u4ee3\u54c1\uff0c\u800c\u662f\u56f4\u7ed5 API \u7684\u63d0\u793a\u8bcd\u9a71\u52a8\u5c01\u88c5\uff0c\u5141\u8bb8\u5728\u5bfc\u822a\u4fe1\u606f\u65f6\u5177\u6709\u66f4\u9ad8\u7684\u7075\u6d3b\u6027\u3002\n\n**\u793a\u4f8b\uff1a** Supabase MCP \u8ba9 Claude \u80fd\u591f\u62c9\u53d6\u7279\u5b9a\u6570\u636e\uff0c\u76f4\u63a5\u5728\u4e0a\u6e38\u8fd0\u884c SQL\uff0c\u65e0\u9700\u590d\u5236\u7c98\u8d34\u3002\u6570\u636e\u5e93\u3001\u90e8\u7f72\u5e73\u53f0\u7b49\u540c\u7406\u3002\n\n![Supabase MCP \u5217\u51fa\u6570\u636e\u8868](./assets/images/shortform/04-supabase-mcp.jpeg)\n*Supabase MCP \u5217\u51fa public \u6a21\u5f0f\u4e0b\u6570\u636e\u8868\u7684\u793a\u4f8b*\n\n**Claude \u5185\u90e8\u7684 Chrome\uff1a** \u662f\u4e00\u4e2a\u5185\u7f6e\u7684 MCP \u63d2\u4ef6\uff0c\u5141\u8bb8 Claude \u81ea\u4e3b\u63a7\u5236\u6d4f\u89c8\u5668\u2014\u2014\u901a\u8fc7\u70b9\u51fb\u6765\u67e5\u770b\u529f\u80fd\u8fd0\u884c\u60c5\u51b5\u3002\n\n**\u5173\u952e\u70b9\uff1a\u4e0a\u4e0b\u6587\u7a97\u53e3\uff08Context Window\uff09\u7ba1\u7406**\n\n\u5bf9 MCP \u8981\u7cbe\u6311\u7ec6\u9009\u3002\u6211\u5c06\u6240\u6709 MCP \u4fdd\u7559\u5728\u7528\u6237\u914d\u7f6e\u4e2d\uff0c\u4f46**\u7981\u7528\u6240\u6709\u4e0d\u4f7f\u7528\u7684 MCP**\u3002\u5bfc\u822a\u81f3 `/plugins` \u5e76\u5411\u4e0b\u6eda\u52a8\u6216\u8fd0\u884c `/mcp`\u3002\n\n![/plugins \u754c\u9762](./assets/images/shortform/05-plugins-interface.jpeg)\n*\u4f7f\u7528 /plugins \u5bfc\u822a\u81f3 MCP\uff0c\u67e5\u770b\u5f53\u524d\u5df2\u5b89\u88c5\u7684 MCP \u53ca\u5176\u72b6\u6001*\n\n\u7531\u4e8e\u542f\u7528\u4e86\u8fc7\u591a\u5de5\u5177\uff0c\u4f60\u5728\u538b\u7f29\u524d\u7684 200k \u4e0a\u4e0b\u6587\u7a97\u53e3\u53ef\u80fd\u5b9e\u9645\u4e0a\u53ea\u5269 70k\u3002\u6027\u80fd\u4f1a\u663e\u8457\u4e0b\u964d\u3002\n\n**\u7ecf\u9a8c\u6cd5\u5219\uff1a** \u914d\u7f6e\u4e2d\u4fdd\u7559 20-30 \u4e2a MCP\uff0c\u4f46\u4fdd\u6301\u542f\u7528\u7684\u5c11\u4e8e 10 \u4e2a / \u6d3b\u8dc3\u5de5\u5177\u5c11\u4e8e 80 \u4e2a\u3002\n\n```bash\n# \u68c0\u67e5\u5df2\u542f\u7528\u7684 MCP\n/mcp\n\n# \u5728 ~/.claude.json \u7684 projects.disabledMcpServers \u4e2d\u7981\u7528\u4e0d\u4f7f\u7528\u7684 MCP\n```\n\n---\n\n## \u63d2\u4ef6\uff08Plugins\uff09\n\n\u63d2\u4ef6\uff08Plugins\uff09\u5c01\u88c5\u4e86\u5de5\u5177\u4ee5\u4fbf\u4e8e\u5b89\u88c5\uff0c\u907f\u514d\u7e41\u7410\u7684\u624b\u52a8\u8bbe\u7f6e\u3002\u4e00\u4e2a\u63d2\u4ef6\u53ef\u4ee5\u662f\u6280\u80fd\uff08Skill\uff09\u4e0e MCP \u7684\u7ec4\u5408\uff0c\u4e5f\u53ef\u4ee5\u662f\u7ed1\u5b9a\u5728\u4e00\u8d77\u7684\u94a9\u5b50\uff08Hooks\uff09/\u5de5\u5177\uff08Tools\uff09\u3002\n\n**\u5b89\u88c5\u63d2\u4ef6\uff1a**\n\n```bash\n# \u6dfb\u52a0\u5e02\u573a\nclaude plugin marketplace add https://github.com/mixedbread-ai/mgrep\n\n# \u6253\u5f00 Claude\uff0c\u8fd0\u884c /plugins\uff0c\u627e\u5230\u65b0\u5e02\u573a\uff0c\u5e76\u4ece\u4e2d\u5b89\u88c5\n```\n\n![\u663e\u793a mgrep \u7684\u5e02\u573a\u6807\u7b7e\u9875](./assets/images/shortform/06-marketplaces-mgrep.jpeg)\n*\u663e\u793a\u65b0\u5b89\u88c5\u7684 Mixedbread-Grep \u5e02\u573a*\n\n\u5982\u679c\u4f60\u7ecf\u5e38\u5728\u7f16\u8f91\u5668\u4e4b\u5916\u8fd0\u884c Claude Code\uff0c**LSP \u63d2\u4ef6**\u7279\u522b\u6709\u7528\u3002\u8bed\u8a00\u670d\u52a1\u5668\u534f\u8bae\uff08Language Server Protocol\uff09\u4e3a Claude \u63d0\u4f9b\u4e86\u5b9e\u65f6\u7c7b\u578b\u68c0\u67e5\u3001\u8f6c\u5230\u5b9a\u4e49\u548c\u667a\u80fd\u8865\u5168\u529f\u80fd\uff0c\u65e0\u9700\u6253\u5f00 IDE\u3002\n\n```bash\n# \u5df2\u542f\u7528\u63d2\u4ef6\u793a\u4f8b\ntypescript-lsp@claude-plugins-official  # TypeScript \u667a\u80fd\u63d0\u793a\npyright-lsp@claude-plugins-official     # Python \u7c7b\u578b\u68c0\u67e5\nhookify@claude-plugins-official         # \u5bf9\u8bdd\u5f0f\u521b\u5efa\u94a9\u5b50\nmgrep@Mixedbread-Grep                   # \u6bd4 ripgrep \u66f4\u597d\u7684\u641c\u7d22\n```\n\n\u4e0e MCP \u540c\u6837\u7684\u8b66\u544a\u2014\u2014\u6ce8\u610f\u4f60\u7684\u4e0a\u4e0b\u6587\u7a97\u53e3\u3002\n\n---\n\n## \u6280\u5de7\u4e0e\u5efa\u8bae\n\n### \u952e\u76d8\u5feb\u6377\u952e\n\n- `Ctrl+U` - \u5220\u9664\u6574\u884c\uff08\u6bd4\u72c2\u6309\u9000\u683c\u952e\u5feb\uff09\n- `!` - \u5feb\u901f Bash \u547d\u4ee4\u524d\u7f00\n- `@` - \u641c\u7d22\u6587\u4ef6\n- `/` - \u542f\u52a8\u659c\u6760\u547d\u4ee4\n- `Shift+Enter` - \u591a\u884c\u8f93\u5165\n- `Tab` - \u5207\u6362\u601d\u8003\u8fc7\u7a0b\u663e\u793a\n- `Esc Esc` - \u4e2d\u65ad Claude / \u6062\u590d\u4ee3\u7801\n\n### \u5e76\u884c\u5de5\u4f5c\u6d41\n\n- **\u6d3e\u751f** (`/fork`) - \u6d3e\u751f\u5bf9\u8bdd\u4ee5\u5e76\u884c\u6267\u884c\u4e0d\u91cd\u53e0\u7684\u4efb\u52a1\uff0c\u800c\u4e0d\u662f\u8ba9\u6392\u961f\u7684\u8bf7\u6c42\u5806\u79ef\n- **Git \u5de5\u4f5c\u6811 (Worktrees)** - \u7528\u4e8e\u5e76\u884c\u8fd0\u884c\u591a\u4e2a Claude \u5b9e\u4f8b\u800c\u4e0d\u4f1a\u4ea7\u751f\u51b2\u7a81\u3002\u6bcf\u4e2a\u5de5\u4f5c\u6811\u90fd\u662f\u4e00\u4e2a\u72ec\u7acb\u7684\u68c0\u51fa\u76ee\u5f55\n\n```bash\ngit worktree add ../feature-branch feature-branch\n# \u73b0\u5728\u5728\u6bcf\u4e2a\u5de5\u4f5c\u6811\u4e2d\u8fd0\u884c\u72ec\u7acb\u7684 Claude \u5b9e\u4f8b\n```\n\n### \u4f7f\u7528 tmux \u5904\u7406\u8017\u65f6\u547d\u4ee4\n\n\u4e32\u6d41\u5e76\u89c2\u5bdf Claude \u8fd0\u884c\u7684\u65e5\u5fd7/Bash \u8fdb\u7a0b\uff1a\n\nhttps://github.com/user-attachments/assets/shortform/07-tmux-video.mp4\n\n```bash\ntmux new -s dev\n# Claude \u5728\u8fd9\u91cc\u8fd0\u884c\u547d\u4ee4\uff0c\u4f60\u53ef\u4ee5\u968f\u65f6\u5206\u79bb (detach) \u548c\u91cd\u65b0\u8fde\u63a5 (reattach)\ntmux attach -t dev\n```\n\n### mgrep > grep\n\n`mgrep` \u662f\u5bf9 ripgrep/grep \u7684\u91cd\u5927\u6539\u8fdb\u3002\u901a\u8fc7\u63d2\u4ef6\u5e02\u573a\u5b89\u88c5\uff0c\u7136\u540e\u4f7f\u7528 `/mgrep` \u6280\u80fd\u3002\u540c\u65f6\u652f\u6301\u672c\u5730\u641c\u7d22\u548c\u7f51\u7edc\u641c\u7d22\u3002\n\n```bash\nmgrep \"function handleSubmit\"  # \u672c\u5730\u641c\u7d22\nmgrep --web \"Next.js 15 app router changes\"  # \u7f51\u7edc\u641c\u7d22\n```\n\n### \u5176\u4ed6\u6709\u7528\u547d\u4ee4\n\n- `/rewind` - \u56de\u9000\u5230\u4e4b\u524d\u7684\u72b6\u6001\n- `/statusline` - \u81ea\u5b9a\u4e49\u663e\u793a\u5206\u652f\u3001\u4e0a\u4e0b\u6587\u5360\u6bd4\u3001\u5f85\u529e\u4e8b\u9879 (Todos)\n- `/checkpoints` - \u6587\u4ef6\u7ea7\u64a4\u9500\u70b9\n- `/compact` - \u624b\u52a8\u89e6\u53d1\u4e0a\u4e0b\u6587\u538b\u7f29\n\n### GitHub Actions CI/CD\n\n\u4f7f\u7528 GitHub Actions \u5728 PR \u4e0a\u8bbe\u7f6e\u4ee3\u7801\u5ba1\u67e5\u3002\u914d\u7f6e\u5b8c\u6210\u540e\uff0cClaude \u53ef\u4ee5\u81ea\u52a8\u5ba1\u67e5 PR\u3002\n\n![Claude \u673a\u5668\u4eba\u6279\u51c6 PR](./assets/images/shortform/08-github-pr-review.jpeg)\n*Claude \u6279\u51c6\u4e86\u4e00\u4e2a\u6f0f\u6d1e\u4fee\u590d PR*\n\n### \u6c99\u7bb1\u5316\uff08Sandboxing\uff09\n\n\u5bf9\u98ce\u9669\u64cd\u4f5c\u4f7f\u7528\u6c99\u7bb1\u6a21\u5f0f\u2014\u2014Claude \u5728\u53d7\u9650\u73af\u5883\u4e2d\u8fd0\u884c\uff0c\u4e0d\u4f1a\u5f71\u54cd\u4f60\u7684\u5b9e\u9645\u7cfb\u7edf\u3002\n\n---\n\n## \u5173\u4e8e\u7f16\u8f91\u5668\n\n\u7f16\u8f91\u5668\u7684\u9009\u62e9\u4f1a\u663e\u8457\u5f71\u54cd Claude Code \u7684\u5de5\u4f5c\u6d41\u3002\u867d\u7136 Claude Code \u53ef\u4ee5\u4ece\u4efb\u4f55\u7ec8\u7aef\u8fd0\u884c\uff0c\u4f46\u914d\u5408\u529f\u80fd\u5f3a\u5927\u7684\u7f16\u8f91\u5668\u53ef\u4ee5\u89e3\u9501\u5b9e\u65f6\u6587\u4ef6\u8ddf\u8e2a\u3001\u5feb\u901f\u5bfc\u822a\u548c\u96c6\u6210\u547d\u4ee4\u6267\u884c\u3002\n\n### Zed\uff08\u6211\u7684\u9996\u9009\uff09\n\n\u6211\u4f7f\u7528 [Zed](https://zed.dev) \u2014\u2014 \u7528 Rust \u7f16\u5199\uff0c\u901f\u5ea6\u6781\u5feb\u3002\u77ac\u95f4\u6253\u5f00\uff0c\u5904\u7406\u5e9e\u5927\u7684\u4ee3\u7801\u5e93\u4e5f\u6e38\u5203\u6709\u4f59\uff0c\u4e14\u51e0\u4e4e\u4e0d\u5360\u7528\u7cfb\u7edf\u8d44\u6e90\u3002\n\n**\u4e3a\u4ec0\u4e48 Zed + Claude Code \u662f\u7edd\u4f73\u7ec4\u5408\uff1a**\n\n- **\u901f\u5ea6** - \u57fa\u4e8e Rust \u7684\u6027\u80fd\u610f\u5473\u7740\u5f53 Claude \u5feb\u901f\u7f16\u8f91\u6587\u4ef6\u65f6\u4e0d\u4f1a\u6709\u5ef6\u8fdf\u3002\u4f60\u7684\u7f16\u8f91\u5668\u80fd\u8ddf\u4e0a\u8282\u594f\n- **\u667a\u80fd\u4f53\u9762\u677f\u96c6\u6210** - Zed \u7684 Claude \u96c6\u6210\u8ba9\u4f60\u5728 Claude \u7f16\u8f91\u65f6\u5b9e\u65f6\u8ddf\u8e2a\u6587\u4ef6\u66f4\u6539\u3002\u65e0\u9700\u79bb\u5f00\u7f16\u8f91\u5668\u5373\u53ef\u5728 Claude \u5f15\u7528\u7684\u6587\u4ef6\u95f4\u8df3\u8f6c\n- **CMD+Shift+R \u547d\u4ee4\u9762\u677f** - \u5728\u53ef\u641c\u7d22\u7684 UI \u4e2d\u5feb\u901f\u8bbf\u95ee\u6240\u6709\u81ea\u5b9a\u4e49\u659c\u6760\u547d\u4ee4\u3001\u8c03\u8bd5\u5668\u548c\u6784\u5efa\u811a\u672c\n- **\u6781\u4f4e\u7684\u8d44\u6e90\u5360\u7528** - \u5728\u6267\u884c\u7e41\u91cd\u64cd\u4f5c\u65f6\u4e0d\u4f1a\u4e0e Claude \u4e89\u593a RAM/CPU\u3002\u8fd0\u884c Opus \u65f6\u8fd9\u4e00\u70b9\u5f88\u91cd\u8981\n- **Vim \u6a21\u5f0f** - \u5982\u679c\u4f60\u4e60\u60ef Vim\uff0c\u5b83\u6709\u5b8c\u6574\u7684 Vim \u952e\u7ed1\u5b9a\u652f\u6301\n\n![\u5e26\u6709\u81ea\u5b9a\u4e49\u547d\u4ee4\u7684 Zed \u7f16\u8f91\u5668](./assets/images/shortform/09-zed-editor.jpeg)\n*\u4f7f\u7528 CMD+Shift+R \u5f39\u51fa\u81ea\u5b9a\u4e49\u547d\u4ee4\u4e0b\u62c9\u5217\u8868\u7684 Zed \u7f16\u8f91\u5668\u3002\u53f3\u4e0b\u89d2\u7684\u725b\u773c\u56fe\u6807\u663e\u793a\u4e86\u8ddf\u968f\u6a21\u5f0f (Following mode)\u3002*\n\n**\u7f16\u8f91\u5668\u901a\u7528\u6280\u5de7\uff1a**\n\n1. **\u5206\u5c4f\u663e\u793a** - \u4e00\u4fa7\u662f\u8fd0\u884c Claude Code \u7684\u7ec8\u7aef\uff0c\u53e6\u4e00\u4fa7\u662f\u7f16\u8f91\u5668\n2. **Ctrl + G** - \u5728 Zed \u4e2d\u5feb\u901f\u6253\u5f00 Claude \u5f53\u524d\u6b63\u5728\u5904\u7406\u7684\u6587\u4ef6\n3. **\u81ea\u52a8\u4fdd\u5b58** - \u5f00\u542f\u81ea\u52a8\u4fdd\u5b58\uff0c\u786e\u4fdd Claude \u8bfb\u53d6\u7684\u6587\u4ef6\u59cb\u7ec8\u662f\u6700\u65b0\u7684\n4. **Git \u96c6\u6210** - \u4f7f\u7528\u7f16\u8f91\u5668\u7684 Git \u529f\u80fd\u5728\u63d0\u4ea4\u524d\u5ba1\u67e5 Claude \u7684\u66f4\u6539\n5. **\u6587\u4ef6\u76d1\u542c\u5668** - \u5927\u591a\u6570\u7f16\u8f91\u5668\u4f1a\u81ea\u52a8\u91cd\u8f7d\u66f4\u6539\u540e\u7684\u6587\u4ef6\uff0c\u8bf7\u786e\u8ba4\u8be5\u529f\u80fd\u5df2\u542f\u7528\n\n### VSCode / Cursor\n\n\u8fd9\u4e5f\u662f\u4e00\u4e2a\u53ef\u884c\u7684\u9009\u62e9\uff0c\u5e76\u4e14\u4e0e Claude Code \u914d\u5408\u826f\u597d\u3002\u4f60\u53ef\u4ee5\u901a\u8fc7\u7ec8\u7aef\u5f62\u5f0f\u4f7f\u7528\u5b83\uff0c\u5229\u7528 `\\ide` \u81ea\u52a8\u4e0e\u7f16\u8f91\u5668\u540c\u6b65\u5e76\u542f\u7528 LSP \u529f\u80fd\uff08\u73b0\u5728\u5728\u67d0\u79cd\u7a0b\u5ea6\u4e0a\u4e0e\u63d2\u4ef6\u529f\u80fd\u91cd\u53e0\uff09\u3002\u6216\u8005\u4f60\u53ef\u4ee5\u9009\u62e9\u6269\u5c55\u7a0b\u5e8f\uff0c\u5b83\u4e0e\u7f16\u8f91\u5668\u96c6\u6210\u5ea6\u66f4\u9ad8\uff0c\u5e76\u62e5\u6709\u5339\u914d\u7684 UI\u3002\n\n![VS Code Claude Code \u6269\u5c55](./assets/images/shortform/10-vscode-extension.jpeg)\n*VS Code \u6269\u5c55\u4e3a Claude Code \u63d0\u4f9b\u4e86\u539f\u751f\u56fe\u5f62\u754c\u9762\uff0c\u76f4\u63a5\u96c6\u6210\u5230\u4f60\u7684 IDE \u4e2d\u3002*\n\n---\n\n## \u6211\u7684\u914d\u7f6e\n\n### \u63d2\u4ef6 (Plugins)\n\n**\u5df2\u5b89\u88c5\uff1a**\uff08\u6211\u901a\u5e38\u4e00\u6b21\u53ea\u542f\u7528 4-5 \u4e2a\uff09\n\n```markdown\nralph-wiggum@claude-code-plugins       # \u5faa\u73af\u81ea\u52a8\u5316\nfrontend-design@claude-code-plugins    # UI/UX \u6a21\u5f0f\ncommit-commands@claude-code-plugins    # Git \u5de5\u4f5c\u6d41\nsecurity-guidance@claude-code-plugins  # \u5b89\u5168\u68c0\u67e5\npr-review-toolkit@claude-code-plugins  # PR \u81ea\u52a8\u5316\ntypescript-lsp@claude-plugins-official # TS \u667a\u80fd\u63d0\u793a\nhookify@claude-plugins-official        # \u94a9\u5b50\u521b\u5efa\ncode-simplifier@claude-plugins-official\nfeature-dev@claude-code-plugins\nexplanatory-output-style@claude-plugins-official\ncode-review@claude-code-plugins\ncontext7@claude-plugins-official       # \u5b9e\u65f6\u6587\u6863\npyright-lsp@claude-plugins-official    # Python \u7c7b\u578b\nmgrep@Mixedbread-Grep                  # \u66f4\u597d\u7684\u641c\u7d22\n```\n\n### MCP \u670d\u52a1\u5668\n\n**\u5df2\u914d\u7f6e\uff08\u7528\u6237\u7ea7\uff09\uff1a**\n\n```json\n{\n  \"github\": { \"command\": \"npx\", \"args\": [\"-y\", \"@modelcontextprotocol/server-github\"] },\n  \"firecrawl\": { \"command\": \"npx\", \"args\": [\"-y\", \"firecrawl-mcp\"] },\n  \"supabase\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@supabase/mcp-server-supabase@latest\", \"--project-ref=YOUR_REF\"]\n  },\n  \"memory\": { \"command\": \"npx\", \"args\": [\"-y\", \"@modelcontextprotocol/server-memory\"] },\n  \"sequential-thinking\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@modelcontextprotocol/server-sequential-thinking\"]\n  },\n  \"vercel\": { \"type\": \"http\", \"url\": \"https://mcp.vercel.com\" },\n  \"railway\": { \"command\": \"npx\", \"args\": [\"-y\", \"@railway/mcp-server\"] },\n  \"cloudflare-docs\": { \"type\": \"http\", \"url\": \"https://docs.mcp.cloudflare.com/mcp\" },\n  \"cloudflare-workers-bindings\": {\n    \"type\": \"http\",\n    \"url\": \"https://bindings.mcp.cloudflare.com/mcp\"\n  },\n  \"clickhouse\": { \"type\": \"http\", \"url\": \"https://mcp.clickhouse.cloud/mcp\" },\n  \"AbletonMCP\": { \"command\": \"uvx\", \"args\": [\"ableton-mcp\"] },\n  \"magic\": { \"command\": \"npx\", \"args\": [\"-y\", \"@magicuidesign/mcp@latest\"] }\n}\n```\n\n\u5173\u952e\u5728\u4e8e\uff1a\u6211\u914d\u7f6e\u4e86 14 \u4e2a MCP\uff0c\u4f46\u6bcf\u4e2a\u9879\u76ee\u53ea\u542f\u7528 ~5-6 \u4e2a\u3002\u8fd9\u80fd\u4fdd\u6301\u4e0a\u4e0b\u6587\u7a97\u53e3\u7684\u5065\u5eb7\u3002\n\n### \u5173\u952e\u94a9\u5b50 (Key Hooks)\n\n```json\n{\n  \"PreToolUse\": [\n    { \"matcher\": \"npm|pnpm|yarn|cargo|pytest\", \"hooks\": [\"tmux reminder\"] },\n    { \"matcher\": \"Write && .md file\", \"hooks\": [\"block unless README/CLAUDE\"] },\n    { \"matcher\": \"git push\", \"hooks\": [\"open editor for review\"] }\n  ],\n  \"PostToolUse\": [\n    { \"matcher\": \"Edit && .ts/.tsx/.js/.jsx\", \"hooks\": [\"prettier --write\"] },\n    { \"matcher\": \"Edit && .ts/.tsx\", \"hooks\": [\"tsc --noEmit\"] },\n    { \"matcher\": \"Edit\", \"hooks\": [\"grep console.log warning\"] }\n  ],\n  \"Stop\": [\n    { \"matcher\": \"*\", \"hooks\": [\"check modified files for console.log\"] }\n  ]\n}\n```\n\n### \u81ea\u5b9a\u4e49\u72b6\u6001\u680f (Custom Status Line)\n\n\u663e\u793a\u7528\u6237\u3001\u76ee\u5f55\u3001\u5e26\u810f\u6807\u8bb0\u7684 Git \u5206\u652f\u3001\u5269\u4f59\u4e0a\u4e0b\u6587 %\u3001\u6a21\u578b\u3001\u65f6\u95f4\u548c\u5f85\u529e\u4e8b\u9879\u8ba1\u6570\uff1a\n\n![\u81ea\u5b9a\u4e49\u72b6\u6001\u680f](./assets/images/shortform/11-statusline.jpeg)\n*\u6211\u7684 Mac \u6839\u76ee\u5f55\u4e0b\u7684\u72b6\u6001\u680f\u793a\u4f8b*\n\n```\naffoon:~ ctx:65% Opus 4.5 19:52\n\u258c\u258c \u89c4\u5212\u6a21\u5f0f\u5df2\u5f00\u542f (\u6309 shift+tab \u5207\u6362)\n```\n\n### \u89c4\u5219\u7ed3\u6784 (Rules Structure)\n\n```\n~/.claude/rules/\n  security.md      # \u5f3a\u5236\u6027\u5b89\u5168\u68c0\u67e5\n  coding-style.md  # \u4e0d\u53ef\u53d8\u6027\uff0c\u6587\u4ef6\u5927\u5c0f\u9650\u5236\n  testing.md       # TDD\uff0c80% \u8986\u76d6\u7387\n  git-workflow.md  # \u7ea6\u5b9a\u5f0f\u63d0\u4ea4 (Conventional commits)\n  agents.md        # \u5b50\u667a\u80fd\u4f53\u59d4\u6d3e\u89c4\u5219\n  patterns.md      # API \u54cd\u5e94\u683c\u5f0f\n  performance.md   # \u6a21\u578b\u9009\u62e9 (Haiku vs Sonnet vs Opus)\n  hooks.md         # \u94a9\u5b50\u6587\u6863\u8bf4\u660e\n```\n\n### \u5b50\u667a\u80fd\u4f53 (Subagents)\n\n```\n~/.claude/agents/\n  planner.md           # \u5206\u89e3\u529f\u80fd\u9700\u6c42\n  architect.md         # \u7cfb\u7edf\u8bbe\u8ba1\n  tdd-guide.md         # \u6d4b\u8bd5\u5148\u884c\n  code-reviewer.md     # \u8d28\u91cf\u5ba1\u67e5\n  security-reviewer.md # \u6f0f\u6d1e\u626b\u63cf\n  build-error-resolver.md\n  e2e-runner.md        # Playwright \u6d4b\u8bd5\n  refactor-cleaner.md  # \u5e9f\u5f03\u4ee3\u7801\u6e05\u7406\n  doc-updater.md       # \u4fdd\u6301\u6587\u6863\u540c\u6b65\n```\n\n---\n\n## \u6838\u5fc3\u8981\u70b9\n\n1. **\u4e0d\u8981\u8fc7\u5ea6\u590d\u6742\u5316** - \u5c06\u914d\u7f6e\u89c6\u4e3a\u5fae\u8c03\uff0c\u800c\u975e\u67b6\u6784\u8bbe\u8ba1\n2. **\u4e0a\u4e0b\u6587\u7a97\u53e3\u6781\u5176\u73cd\u8d35** - \u7981\u7528\u4e0d\u4f7f\u7528\u7684 MCP \u548c\u63d2\u4ef6\n3. **\u5e76\u884c\u6267\u884c** - \u6d3e\u751f\u5bf9\u8bdd\uff0c\u5229\u7528 Git \u5de5\u4f5c\u6811\n4. **\u81ea\u52a8\u5316\u91cd\u590d\u6027\u4efb\u52a1** - \u4e3a\u683c\u5f0f\u5316\u3001\u4ee3\u7801\u68c0\u67e5\u3001\u63d0\u9192\u8bbe\u7f6e\u94a9\u5b50\n5. **\u660e\u786e\u5b50\u667a\u80fd\u4f53\u7684\u4f5c\u7528\u57df** - \u53d7\u9650\u7684\u5de5\u5177 = \u4e13\u6ce8\u7684\u6267\u884c\n\n---\n\n## \u53c2\u8003\u8d44\u6599\n\n- [\u63d2\u4ef6\u53c2\u8003 (Plugins Reference)](https://code.claude.com/docs/en/plugins-reference)\n- [\u94a9\u5b50\u6587\u6863 (Hooks Documentation)](https://code.claude.com/docs/en/hooks)\n- [\u68c0\u67e5\u70b9\u529f\u80fd (Checkpointing)](https://code.claude.com/docs/en/checkpointing)\n- [\u4ea4\u4e92\u6a21\u5f0f (Interactive Mode)](https://code.claude.com/docs/en/interactive-mode)\n- [\u8bb0\u5fc6\u7cfb\u7edf (Memory System)](https://code.claude.com/docs/en/memory)\n- [\u5b50\u667a\u80fd\u4f53 (Subagents)](https://code.claude.com/docs/en/sub-agents)\n- [MCP \u6982\u89c8 (MCP Overview)](https://code.claude.com/docs/en/mcp-overview)\n\n---\n\n**\u6ce8\uff1a** \u4ee5\u4e0a\u4ec5\u4e3a\u90e8\u5206\u7ec6\u8282\u3002\u8fdb\u9636\u6a21\u5f0f\u8bf7\u53c2\u9605 [\u957f\u7bc7\u6307\u5357 (Longform Guide)](./the-longform-guide.md)\u3002\n\n---\n\n*\u4e0e [@DRodriguezFX](https://x.com/DRodriguezFX) \u5728\u7ebd\u7ea6\u5171\u540c\u5f00\u53d1 [zenith.chat](https://zenith.chat)\uff0c\u5e76\u8d62\u5f97 Anthropic x Forum Ventures \u9ed1\u5ba2\u677e\u3002*\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/README.md": {
-    "md5": "cedc12b4caa63f6ddeb8fbbb7cf84949",
-    "content": "# Everything Claude Code (Claude Code \u5168\u96c6)\n\n[![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)\n![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)\n![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)\n![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)\n\n**\u6765\u81ea Anthropic \u9ed1\u5ba2\u677e\u83b7\u80dc\u8005\u7684 Claude Code \u914d\u7f6e\u5b8c\u6574\u5408\u96c6\u3002**\n\n\u5305\u542b\u751f\u4ea7\u7ea7\u667a\u80fd\u4f53\uff08Agents\uff09\u3001\u6280\u80fd\uff08Skills\uff09\u3001\u94a9\u5b50\uff08Hooks\uff09\u3001\u547d\u4ee4\uff08Commands\uff09\u3001\u89c4\u7ea6\uff08Rules\uff09\u4ee5\u53ca MCP \u914d\u7f6e\uff0c\u8fd9\u4e9b\u90fd\u662f\u5728\u8d85\u8fc7 10 \u4e2a\u6708\u7684\u771f\u5b9e\u4ea7\u54c1\u5f00\u53d1\u4e0e\u6df1\u5ea6\u65e5\u5e38\u4f7f\u7528\u4e2d\u6f14\u8fdb\u51fa\u6765\u7684\u3002\n\n---\n\n## \u6307\u5357\u6587\u6863\n\n\u672c\u4ed3\u5e93\u4ec5\u5305\u542b\u539f\u59cb\u4ee3\u7801\u3002\u4ee5\u4e0b\u6307\u5357\u5c06\u89e3\u91ca\u4e00\u5207\u3002\n\n<table>\n<tr>\n<td width=\"50%\">\n<a href=\"https://x.com/affaanmustafa/status/2012378465664745795\">\n<img src=\"https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef\" alt=\"The Shorthand Guide to Everything Claude Code\" />\n</a>\n</td>\n<td width=\"50%\">\n<a href=\"https://x.com/affaanmustafa/status/2014040193557471352\">\n<img src=\"https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0\" alt=\"The Longform Guide to Everything Claude Code\" />\n</a>\n</td>\n</tr>\n<tr>\n<td align=\"center\"><b>\u7b80\u660e\u6307\u5357 (Shorthand Guide)</b><br/>\u5b89\u88c5\u8bbe\u7f6e\u3001\u57fa\u7840\u6982\u5ff5\u4e0e\u54f2\u5b66\u3002<b>\u8bf7\u5148\u9605\u8bfb\u6b64\u7bc7\u3002</b></td>\n<td align=\"center\"><b>\u6df1\u5ea6\u6307\u5357 (Longform Guide)</b><br/>Token \u4f18\u5316\u3001\u5185\u5b58\u6301\u4e45\u5316\u3001\u8bc4\u6d4b\uff08Evals\uff09\u4e0e\u5e76\u884c\u5316\u3002</td>\n</tr>\n</table>\n\n| \u4e3b\u9898 | \u4f60\u5c06\u5b66\u5230\u4ec0\u4e48 |\n|-------|-------------------|\n| Token \u4f18\u5316 | \u6a21\u578b\u9009\u62e9\u3001\u7cfb\u7edf\u63d0\u793a\u8bcd\u7626\u8eab\u3001\u540e\u53f0\u8fdb\u7a0b |\n| \u5185\u5b58\u6301\u4e45\u5316 | \u81ea\u52a8\u8de8\u4f1a\u8bdd\u4fdd\u5b58/\u52a0\u8f7d\u4e0a\u4e0b\u6587\u7684\u94a9\u5b50\uff08Hooks\uff09 |\n| \u6301\u7eed\u5b66\u4e60 | \u4ece\u4f1a\u8bdd\u4e2d\u81ea\u52a8\u63d0\u53d6\u6a21\u5f0f\u5e76\u8f6c\u5316\u4e3a\u53ef\u590d\u7528\u7684\u6280\u80fd\uff08Skills\uff09 |\n| \u9a8c\u8bc1\u5faa\u73af | \u68c0\u67e5\u70b9 vs \u6301\u7eed\u8bc4\u6d4b\u3001\u6253\u5206\u5668\u7c7b\u578b\u3001pass@k \u6307\u6807 |\n| \u5e76\u884c\u5316 | Git worktrees\u3001\u7ea7\u8054\u6cd5\uff08Cascade method\uff09\u3001\u4f55\u65f6\u6269\u5c55\u5b9e\u4f8b |\n| \u5b50\u667a\u80fd\u4f53\u7f16\u6392 | \u4e0a\u4e0b\u6587\u95ee\u9898\u3001\u8fed\u4ee3\u68c0\u7d22\u6a21\u5f0f\uff08Iterative retrieval pattern\uff09 |\n\n---\n\n## \u8de8\u5e73\u53f0\u652f\u6301\n\n\u672c\u63d2\u4ef6\u73b0\u5df2\u5168\u9762\u652f\u6301 **Windows\u3001macOS \u548c Linux**\u3002\u6240\u6709\u94a9\u5b50\u548c\u811a\u672c\u5747\u5df2\u4f7f\u7528 Node.js \u91cd\u5199\uff0c\u4ee5\u5b9e\u73b0\u6700\u5927\u517c\u5bb9\u6027\u3002\n\n### \u5305\u7ba1\u7406\u5668\u68c0\u6d4b\n\n\u63d2\u4ef6\u4f1a\u81ea\u52a8\u68c0\u6d4b\u4f60\u504f\u597d\u7684\u5305\u7ba1\u7406\u5668\uff08npm, pnpm, yarn, \u6216 bun\uff09\uff0c\u4f18\u5148\u7ea7\u5982\u4e0b\uff1a\n\n1. **\u73af\u5883\u53d8\u91cf**\uff1a`CLAUDE_PACKAGE_MANAGER`\n2. **\u9879\u76ee\u914d\u7f6e**\uff1a`.claude/package-manager.json`\n3. **package.json**\uff1a`packageManager` \u5b57\u6bb5\n4. **\u9501\u6587\u4ef6**\uff1a\u6839\u636e package-lock.json, yarn.lock, pnpm-lock.yaml, \u6216 bun.lockb \u68c0\u6d4b\n5. **\u5168\u5c40\u914d\u7f6e**\uff1a`~/.claude/package-manager.json`\n6. **\u5907\u9009\u9879**\uff1a\u7b2c\u4e00\u4e2a\u53ef\u7528\u7684\u5305\u7ba1\u7406\u5668\n\n\u8bbe\u7f6e\u4f60\u504f\u597d\u7684\u5305\u7ba1\u7406\u5668\uff1a\n\n```bash\n# \u901a\u8fc7\u73af\u5883\u53d8\u91cf\nexport CLAUDE_PACKAGE_MANAGER=pnpm\n\n# \u901a\u8fc7\u5168\u5c40\u914d\u7f6e\nnode scripts/setup-package-manager.js --global pnpm\n\n# \u901a\u8fc7\u9879\u76ee\u914d\u7f6e\nnode scripts/setup-package-manager.js --project bun\n\n# \u68c0\u6d4b\u5f53\u524d\u8bbe\u7f6e\nnode scripts/setup-package-manager.js --detect\n```\n\n\u6216\u8005\u5728 Claude Code \u4e2d\u4f7f\u7528 `/setup-pm` \u547d\u4ee4\u3002\n\n---\n\n## \u6838\u5fc3\u5185\u5bb9\n\n\u672c\u4ed3\u5e93\u662f\u4e00\u4e2a **Claude Code \u63d2\u4ef6** \u2014\u2014 \u4f60\u53ef\u4ee5\u76f4\u63a5\u5b89\u88c5\uff0c\u4e5f\u53ef\u4ee5\u624b\u52a8\u590d\u5236\u7ec4\u4ef6\u3002\n\n```\neverything-claude-code/\n|-- .claude-plugin/   # \u63d2\u4ef6\u4e0e\u5e02\u573a\u6e05\u5355\n|   |-- plugin.json         # \u63d2\u4ef6\u5143\u6570\u636e\u4e0e\u7ec4\u4ef6\u8def\u5f84\n|   |-- marketplace.json    # \u7528\u4e8e /plugin marketplace add \u7684\u5e02\u573a\u76ee\u5f55\n|\n|-- agents/           # \u7528\u4e8e\u4efb\u52a1\u59d4\u6d3e\u7684\u4e13\u7528\u5b50\u667a\u80fd\u4f53\n|   |-- planner.md           # \u529f\u80fd\u5b9e\u73b0\u89c4\u5212\n|   |-- architect.md         # \u7cfb\u7edf\u8bbe\u8ba1\u51b3\u7b56\n|   |-- tdd-guide.md         # \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1 (TDD)\n|   |-- code-reviewer.md     # \u8d28\u91cf\u4e0e\u5b89\u5168\u5ba1\u67e5\n|   |-- security-reviewer.md # \u6f0f\u6d1e\u5206\u6790\n|   |-- build-error-resolver.md # \u6784\u5efa\u9519\u8bef\u4fee\u590d\n|   |-- e2e-runner.md        # Playwright E2E \u6d4b\u8bd5\n|   |-- refactor-cleaner.md  # \u5197\u4f59\u4ee3\u7801\u6e05\u7406\n|   |-- doc-updater.md       # \u6587\u6863\u540c\u6b65\n|   |-- go-reviewer.md       # Go \u4ee3\u7801\u5ba1\u67e5 (\u65b0\u589e)\n|   |-- go-build-resolver.md # Go \u6784\u5efa\u9519\u8bef\u89e3\u51b3 (\u65b0\u589e)\n|\n|-- skills/           # \u5de5\u4f5c\u6d41\u5b9a\u4e49\u4e0e\u9886\u57df\u77e5\u8bc6\n|   |-- coding-standards/           # \u7f16\u7a0b\u8bed\u8a00\u6700\u4f73\u5b9e\u8df5\n|   |-- backend-patterns/           # API\u3001\u6570\u636e\u5e93\u3001\u7f13\u5b58\u6a21\u5f0f\n|   |-- frontend-patterns/          # React, Next.js \u6a21\u5f0f\n|   |-- continuous-learning/        # \u4ece\u4f1a\u8bdd\u4e2d\u81ea\u52a8\u63d0\u53d6\u6a21\u5f0f (\u6df1\u5ea6\u6307\u5357)\n|   |-- continuous-learning-v2/     # \u57fa\u4e8e\u672c\u80fd (Instinct) \u7684\u5b66\u4e60\u4e0e\u7f6e\u4fe1\u5ea6\u8bc4\u5206\n|   |-- iterative-retrieval/        # \u4e3a\u5b50\u667a\u80fd\u4f53\u63d0\u4f9b\u6e10\u8fdb\u5f0f\u4e0a\u4e0b\u6587\u7cbe\u70bc\n|   |-- strategic-compact/          # \u624b\u52a8\u538b\u7f29\u5efa\u8bae (\u6df1\u5ea6\u6307\u5357)\n|   |-- tdd-workflow/               # TDD \u65b9\u6cd5\u8bba\n|   |-- security-review/            # \u5b89\u5168\u68c0\u67e5\u6e05\u5355\n|   |-- eval-harness/               # \u9a8c\u8bc1\u5faa\u73af\u8bc4\u4f30 (\u6df1\u5ea6\u6307\u5357)\n|   |-- verification-loop/          # \u6301\u7eed\u9a8c\u8bc1 (\u6df1\u5ea6\u6307\u5357)\n|   |-- golang-patterns/            # Go \u60ef\u7528\u6cd5\u4e0e\u6700\u4f73\u5b9e\u8df5 (\u65b0\u589e)\n|   |-- golang-testing/             # Go \u6d4b\u8bd5\u6a21\u5f0f\u3001TDD\u3001\u57fa\u51c6\u6d4b\u8bd5 (\u65b0\u589e)\n|\n|-- commands/         # \u7528\u4e8e\u5feb\u901f\u6267\u884c\u7684\u659c\u6760\u547d\u4ee4 (/\u547d\u4ee4)\n|   |-- tdd.md              # /tdd - \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\n|   |-- plan.md             # /plan - \u5b9e\u73b0\u89c4\u5212\n|   |-- e2e.md              # /e2e - E2E \u6d4b\u8bd5\u751f\u6210\n|   |-- code-review.md      # /code-review - \u8d28\u91cf\u5ba1\u67e5\n|   |-- build-fix.md        # /build-fix - \u4fee\u590d\u6784\u5efa\u9519\u8bef\n|   |-- refactor-clean.md   # /refactor-clean - \u5197\u4f59\u4ee3\u7801\u79fb\u9664\n|   |-- learn.md            # /learn - \u4f1a\u8bdd\u4e2d\u9014\u63d0\u53d6\u6a21\u5f0f (\u6df1\u5ea6\u6307\u5357)\n|   |-- checkpoint.md       # /checkpoint - \u4fdd\u5b58\u9a8c\u8bc1\u72b6\u6001 (\u6df1\u5ea6\u6307\u5357)\n|   |-- verify.md           # /verify - \u8fd0\u884c\u9a8c\u8bc1\u5faa\u73af (\u6df1\u5ea6\u6307\u5357)\n|   |-- setup-pm.md         # /setup-pm - \u914d\u7f6e\u5305\u7ba1\u7406\u5668\n|   |-- go-review.md        # /go-review - Go \u4ee3\u7801\u5ba1\u67e5 (\u65b0\u589e)\n|   |-- go-test.md          # /go-test - Go TDD \u5de5\u4f5c\u6d41 (\u65b0\u589e)\n|   |-- go-build.md         # /go-build - \u4fee\u590d Go \u6784\u5efa\u9519\u8bef (\u65b0\u589e)\n|\n|-- rules/            # \u5fc5\u987b\u9075\u5b88\u7684\u6307\u5357 (\u590d\u5236\u5230 ~/.claude/rules/)\n|   |-- security.md         # \u5f3a\u5236\u6027\u5b89\u5168\u68c0\u67e5\n|   |-- coding-style.md     # \u4e0d\u53ef\u53d8\u6027\u3001\u6587\u4ef6\u7ec4\u7ec7\u7ed3\u6784\n|   |-- testing.md          # TDD\u300180% \u8986\u76d6\u7387\u8981\u6c42\n|   |-- git-workflow.md     # Commit \u683c\u5f0f\u3001PR \u6d41\u7a0b\n|   |-- agents.md           # \u4f55\u65f6\u59d4\u6d3e\u7ed9\u5b50\u667a\u80fd\u4f53\n|   |-- performance.md      # \u6a21\u578b\u9009\u62e9\u3001\u4e0a\u4e0b\u6587\u7ba1\u7406\n|\n|-- hooks/            # \u57fa\u4e8e\u89e6\u53d1\u5668\u7684\u81ea\u52a8\u5316\n|   |-- hooks.json                # \u6240\u6709\u94a9\u5b50\u914d\u7f6e (PreToolUse, PostToolUse, Stop \u7b49)\n|   |-- memory-persistence/       # \u4f1a\u8bdd\u751f\u547d\u5468\u671f\u94a9\u5b50 (\u6df1\u5ea6\u6307\u5357)\n|   |-- strategic-compact/        # \u538b\u7f29\u5efa\u8bae (\u6df1\u5ea6\u6307\u5357)\n|\n|-- scripts/          # \u8de8\u5e73\u53f0 Node.js \u811a\u672c (\u65b0\u589e)\n|   |-- lib/                     # \u5171\u4eab\u5b9e\u7528\u7a0b\u5e8f\n|   |   |-- utils.js             # \u8de8\u5e73\u53f0\u6587\u4ef6/\u8def\u5f84/\u7cfb\u7edf\u5de5\u5177\n|   |   |-- package-manager.js   # \u5305\u7ba1\u7406\u5668\u68c0\u6d4b\u4e0e\u9009\u62e9\n|   |-- hooks/                   # \u94a9\u5b50\u5b9e\u73b0\n|   |   |-- session-start.js     # \u4f1a\u8bdd\u542f\u52a8\u65f6\u52a0\u8f7d\u4e0a\u4e0b\u6587\n|   |   |-- session-end.js       # \u4f1a\u8bdd\u7ed3\u675f\u65f6\u4fdd\u5b58\u72b6\u6001\n|   |   |-- pre-compact.js       # \u538b\u7f29\u524d\u7684\u72b6\u6001\u4fdd\u5b58\n|   |   |-- suggest-compact.js   # \u7b56\u7565\u6027\u538b\u7f29\u5efa\u8bae\n|   |   |-- evaluate-session.js  # \u4ece\u4f1a\u8bdd\u4e2d\u63d0\u53d6\u6a21\u5f0f\n|   |-- setup-package-manager.js # \u4ea4\u4e92\u5f0f\u5305\u7ba1\u7406\u5668\u8bbe\u7f6e\n|\n|-- tests/            # \u6d4b\u8bd5\u5957\u4ef6 (\u65b0\u589e)\n|   |-- lib/                     # \u5e93\u6d4b\u8bd5\n|   |-- hooks/                   # \u94a9\u5b50\u6d4b\u8bd5\n|   |-- run-all.js               # \u8fd0\u884c\u6240\u6709\u6d4b\u8bd5\n|\n|-- contexts/         # \u52a8\u6001\u7cfb\u7edf\u63d0\u793a\u8bcd\u6ce8\u5165\u4e0a\u4e0b\u6587 (\u6df1\u5ea6\u6307\u5357)\n|   |-- dev.md              # \u5f00\u53d1\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|   |-- review.md           # \u4ee3\u7801\u5ba1\u67e5\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|   |-- research.md         # \u7814\u7a76/\u63a2\u7d22\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|\n|-- examples/         # \u793a\u4f8b\u914d\u7f6e\u4e0e\u4f1a\u8bdd\n|   |-- CLAUDE.md           # \u9879\u76ee\u7ea7\u914d\u7f6e\u793a\u4f8b\n|   |-- user-CLAUDE.md      # \u7528\u6237\u7ea7\u914d\u7f6e\u793a\u4f8b\n|\n|-- mcp-configs/      # MCP \u670d\u52a1\u5668\u914d\u7f6e\n|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway \u7b49\n|\n|-- marketplace.json  # \u81ea\u6258\u7ba1\u5e02\u573a\u914d\u7f6e (\u7528\u4e8e /plugin marketplace add)\n```\n\n---\n\n## \u751f\u6001\u5de5\u5177\n\n### ecc.tools - \u6280\u80fd\u751f\u6210\u5668 (Skill Creator)\n\n\u81ea\u52a8\u6839\u636e\u4f60\u7684\u4ed3\u5e93\u751f\u6210 Claude Code \u6280\u80fd\uff08Skills\uff09\u3002\n\n[\u5b89\u88c5 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)\n\n\u5206\u6790\u4f60\u7684\u4ed3\u5e93\u5e76\u521b\u5efa\uff1a\n- **SKILL.md \u6587\u4ef6** - \u5f00\u7bb1\u5373\u7528\u7684 Claude Code \u6280\u80fd\n- **\u672c\u80fd (Instinct) \u96c6\u5408** - \u9002\u7528\u4e8e continuous-learning-v2\n- **\u6a21\u5f0f\u63d0\u53d6** - \u4ece\u4f60\u7684 commit \u5386\u53f2\u4e2d\u5b66\u4e60\n\n```bash\n# \u5b89\u88c5 GitHub App \u540e\uff0c\u6280\u80fd\u5c06\u51fa\u73b0\u5728\uff1a\n~/.claude/skills/generated/\n```\n\n\u4e0e `continuous-learning-v2` \u6280\u80fd\u5b8c\u7f8e\u914d\u5408\uff0c\u5b9e\u73b0\u9057\u4f20\u5f0f\u7684\u672c\u80fd\u5b66\u4e60\u3002\n\n---\n\n## \u5b89\u88c5\u65b9\u6cd5\n\n### \u65b9\u6848 1\uff1a\u4f5c\u4e3a\u63d2\u4ef6\u5b89\u88c5\uff08\u63a8\u8350\uff09\n\n\u4f7f\u7528\u672c\u4ed3\u5e93\u6700\u7b80\u5355\u7684\u65b9\u6cd5 \u2014\u2014 \u4f5c\u4e3a Claude Code \u63d2\u4ef6\u5b89\u88c5\uff1a\n\n```bash\n# \u5c06\u6b64\u4ed3\u5e93\u6dfb\u52a0\u4e3a\u5e02\u573a\n/plugin marketplace add affaan-m/everything-claude-code\n\n# \u5b89\u88c5\u63d2\u4ef6\n/plugin install everything-claude-code@everything-claude-code\n```\n\n\u6216\u8005\u76f4\u63a5\u6dfb\u52a0\u5230\u4f60\u7684 `~/.claude/settings.json` \u4e2d\uff1a\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"everything-claude-code\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"affaan-m/everything-claude-code\"\n      }\n    }\n  },\n  \"enabledPlugins\": {\n    \"everything-claude-code@everything-claude-code\": true\n  }\n}\n```\n\n\u5b89\u88c5\u540e\u4f60\u5373\u53ef\u7acb\u5373\u4f7f\u7528\u6240\u6709\u547d\u4ee4\u3001\u667a\u80fd\u4f53\u3001\u6280\u80fd\u548c\u94a9\u5b50\u3002\n\n> **\u6ce8\u610f\uff1a** Claude Code \u63d2\u4ef6\u7cfb\u7edf\u76ee\u524d\u4e0d\u652f\u6301\u901a\u8fc7\u63d2\u4ef6\u5206\u53d1 `rules`\uff08[\u4e0a\u6e38\u9650\u5236](https://code.claude.com/docs/en/plugins-reference)\uff09\u3002\u4f60\u9700\u8981\u624b\u52a8\u5b89\u88c5\u89c4\u7ea6\uff08Rules\uff09\uff1a\n> \n> ```bash\n> # \u5148\u514b\u9686\u4ed3\u5e93\n> git clone https://github.com/affaan-m/everything-claude-code.git\n> \n> # \u9009\u9879 A\uff1a\u7528\u6237\u7ea7\u89c4\u7ea6 (\u9002\u7528\u4e8e\u6240\u6709\u9879\u76ee)\n> cp -r everything-claude-code/rules/* ~/.claude/rules/\n> \n> # \u9009\u9879 B\uff1a\u9879\u76ee\u7ea7\u89c4\u7ea6 (\u4ec5\u9002\u7528\u4e8e\u5f53\u524d\u9879\u76ee)\n> mkdir -p .claude/rules\n> cp -r everything-claude-code/rules/* .claude/rules/\n> ```\n\n---\n\n### \u65b9\u6848 2\uff1a\u624b\u52a8\u5b89\u88c5\n\n\u5982\u679c\u4f60\u66f4\u559c\u6b22\u624b\u52a8\u63a7\u5236\u5b89\u88c5\u5185\u5bb9\uff1a\n\n```bash\n# \u514b\u9686\u4ed3\u5e93\ngit clone https://github.com/affaan-m/everything-claude-code.git\n\n# \u5c06\u667a\u80fd\u4f53\u590d\u5236\u5230\u4f60\u7684 Claude \u914d\u7f6e\u76ee\u5f55\ncp everything-claude-code/agents/*.md ~/.claude/agents/\n\n# \u590d\u5236\u89c4\u7ea6 (Rules)\ncp everything-claude-code/rules/*.md ~/.claude/rules/\n\n# \u590d\u5236\u547d\u4ee4 (Commands)\ncp everything-claude-code/commands/*.md ~/.claude/commands/\n\n# \u590d\u5236\u6280\u80fd (Skills)\ncp -r everything-claude-code/skills/* ~/.claude/skills/\n```\n\n#### \u5c06\u94a9\u5b50 (Hooks) \u6dfb\u52a0\u5230 settings.json\n\n\u5c06 `hooks/hooks.json` \u4e2d\u7684\u94a9\u5b50\u914d\u7f6e\u590d\u5236\u5230\u4f60\u7684 `~/.claude/settings.json`\u3002\n\n#### \u914d\u7f6e MCP\n\n\u5c06 `mcp-configs/mcp-servers.json` \u4e2d\u9700\u8981\u7684 MCP \u670d\u52a1\u5668\u914d\u7f6e\u590d\u5236\u5230\u4f60\u7684 `~/.claude.json`\u3002\n\n**\u91cd\u8981\uff1a** \u8bf7\u5c06 `YOUR_*_HERE` \u5360\u4f4d\u7b26\u66ff\u6362\u4e3a\u4f60\u5b9e\u9645\u7684 API \u5bc6\u94a5\u3002\n\n---\n\n## \u6838\u5fc3\u6982\u5ff5\n\n### \u667a\u80fd\u4f53 (Agents)\n\n\u5b50\u667a\u80fd\u4f53\u8d1f\u8d23\u5904\u7406\u5177\u6709\u7279\u5b9a\u8303\u56f4\u7684\u59d4\u6d3e\u4efb\u52a1\u3002\u793a\u4f8b\uff1a\n\n```markdown\n---\nname: code-reviewer\ndescription: \u5ba1\u67e5\u4ee3\u7801\u7684\u8d28\u91cf\u3001\u5b89\u5168\u6027\u4e0e\u53ef\u7ef4\u62a4\u6027\ntools: [\"Read\", \"Grep\", \"Glob\", \"Bash\"]\nmodel: opus\n---\n\n\u4f60\u662f\u4e00\u4e2a\u8d44\u6df1\u4ee3\u7801\u5ba1\u67e5\u5458...\n```\n\n### \u6280\u80fd (Skills)\n\n\u6280\u80fd\u662f\u7531\u547d\u4ee4\u6216\u667a\u80fd\u4f53\u8c03\u7528\u7684\u5de5\u4f5c\u6d41\u5b9a\u4e49\uff1a\n\n```markdown\n# TDD \u5de5\u4f5c\u6d41\n\n1. \u9996\u5148\u5b9a\u4e49\u63a5\u53e3\n2. \u7f16\u5199\u5931\u8d25\u7684\u6d4b\u8bd5 (RED)\n3. \u5b9e\u73b0\u6700\u7b80\u4ee3\u7801 (GREEN)\n4. \u91cd\u6784 (IMPROVE)\n5. \u9a8c\u8bc1 80% \u4ee5\u4e0a\u7684\u8986\u76d6\u7387\n```\n\n### \u94a9\u5b50 (Hooks)\n\n\u94a9\u5b50\u5728\u5de5\u5177\u4e8b\u4ef6\u4e0a\u89e6\u53d1\u3002\u793a\u4f8b \u2014\u2014 \u8b66\u544a\u5173\u4e8e console.log \u7684\u4f7f\u7528\uff1a\n\n```json\n{\n  \"matcher\": \"tool == \\\"Edit\\\" && tool_input.file_path matches \\\"\\\\.(ts|tsx|js|jsx)$\\\"\",\n  \"hooks\": [{\n    \"type\": \"command\",\n    \"command\": \"#!/bin/bash\\ngrep -n 'console\\.log' \\\"$file_path\\\" && echo '[Hook] \u79fb\u9664 console.log' >&2\"\n  }]\n}\n```\n\n### \u89c4\u7ea6 (Rules)\n\n\u89c4\u7ea6\u662f\u5fc5\u987b\u59cb\u7ec8\u9075\u5faa\u7684\u6307\u5357\u3002\u4fdd\u6301\u6a21\u5757\u5316\uff1a\n\n```\n~/.claude/rules/\n  security.md      # \u7981\u6b62\u786c\u7f16\u7801\u5bc6\u94a5\n  coding-style.md  # \u4e0d\u53ef\u53d8\u6027\u3001\u6587\u4ef6\u9650\u5236\n  testing.md       # TDD\u3001\u8986\u76d6\u7387\u8981\u6c42\n```\n\n---\n\n## \u8fd0\u884c\u6d4b\u8bd5\n\n\u672c\u63d2\u4ef6\u5305\u542b\u5b8c\u6574\u7684\u6d4b\u8bd5\u5957\u4ef6\uff1a\n\n```bash\n# \u8fd0\u884c\u6240\u6709\u6d4b\u8bd5\nnode tests/run-all.js\n\n# \u8fd0\u884c\u5355\u4e2a\u6d4b\u8bd5\u6587\u4ef6\nnode tests/lib/utils.test.js\nnode tests/lib/package-manager.test.js\nnode tests/hooks/hooks.test.js\n```\n\n---\n\n## \u8d21\u732e\u6307\u5357\n\n**\u6b22\u8fce\u5e76\u9f13\u52b1\u5927\u5bb6\u505a\u51fa\u8d21\u732e\u3002**\n\n\u672c\u4ed3\u5e93\u65e8\u5728\u4f5c\u4e3a\u4e00\u4e2a\u793e\u533a\u8d44\u6e90\u3002\u5982\u679c\u4f60\u6709\uff1a\n- \u6709\u7528\u7684\u667a\u80fd\u4f53\u6216\u6280\u80fd\n- \u5de7\u5999\u7684\u94a9\u5b50\n- \u66f4\u597d\u7684 MCP \u914d\u7f6e\n- \u6539\u8fdb\u540e\u7684\u89c4\u7ea6\n\n\u8bf7\u63d0\u4ea4\u8d21\u732e\uff01\u53c2\u89c1 [CONTRIBUTING.md](CONTRIBUTING.md) \u83b7\u53d6\u6307\u5357\u3002\n\n### \u8d21\u732e\u601d\u8def\n\n- \u7279\u5b9a\u8bed\u8a00\u7684\u6280\u80fd (Python, Rust \u6a21\u5f0f) \u2014\u2014 Go \u5df2\u5305\u542b\uff01\n- \u7279\u5b9a\u6846\u67b6\u7684\u914d\u7f6e (Django, Rails, Laravel)\n- DevOps \u667a\u80fd\u4f53 (Kubernetes, Terraform, AWS)\n- \u6d4b\u8bd5\u7b56\u7565 (\u9488\u5bf9\u4e0d\u540c\u6846\u67b6)\n- \u9886\u57df\u7279\u5b9a\u77e5\u8bc6 (\u673a\u5668\u5b66\u4e60, \u6570\u636e\u5de5\u7a0b, \u79fb\u52a8\u7aef)\n\n---\n\n## \u80cc\u666f\u6545\u4e8b\n\n\u81ea\u5b9e\u9a8c\u6027\u63a8\u51fa\u4ee5\u6765\uff0c\u6211\u4e00\u76f4\u5728\u4f7f\u7528 Claude Code\u3002\u5728 2025 \u5e74 9 \u6708\u7684 Anthropic x Forum Ventures \u9ed1\u5ba2\u677e\u4e2d\uff0c\u6211\u4e0e [@DRodriguezFX](https://x.com/DRodriguezFX) \u5408\u4f5c\u6784\u5efa\u4e86 [zenith.chat](https://zenith.chat)\uff0c\u5e76\u6700\u7ec8\u83b7\u80dc \u2014\u2014 \u6574\u4e2a\u8fc7\u7a0b\u5b8c\u5168\u4f7f\u7528\u4e86 Claude Code\u3002\n\n\u8fd9\u4e9b\u914d\u7f6e\u5728\u591a\u4e2a\u751f\u4ea7\u7ea7\u5e94\u7528\u4e2d\u7ecf\u8fc7\u4e86\u5b9e\u6218\u6d4b\u8bd5\u3002\n\n---\n\n## \u91cd\u8981\u6ce8\u610f\u4e8b\u9879\n\n### \u4e0a\u4e0b\u6587\u7a97\u53e3\u7ba1\u7406\n\n**\u5173\u952e\uff1a** \u4e0d\u8981\u4e00\u6b21\u6027\u542f\u7528\u6240\u6709 MCP\u3002\u5f00\u542f\u8fc7\u591a\u5de5\u5177\u4f1a\u5c06\u4f60 200k \u7684\u4e0a\u4e0b\u6587\u7a97\u53e3\u538b\u7f29\u5230 70k\u3002\n\n\u7ecf\u9a8c\u6cd5\u5219\uff1a\n- \u914d\u7f6e 20-30 \u4e2a MCP\n- \u6bcf\u4e2a\u9879\u76ee\u4fdd\u6301\u542f\u7528 10 \u4e2a\u4ee5\u4e0b\n- \u6d3b\u8dc3\u5de5\u5177\u603b\u6570\u4fdd\u6301\u5728 80 \u4e2a\u4ee5\u4e0b\n\n\u5728\u9879\u76ee\u914d\u7f6e\u4e2d\u4f7f\u7528 `disabledMcpServers` \u6765\u7981\u7528\u4e0d\u5e38\u7528\u7684\u670d\u52a1\u5668\u3002\n\n### \u81ea\u5b9a\u4e49\n\n\u8fd9\u4e9b\u914d\u7f6e\u9002\u5408\u6211\u7684\u5de5\u4f5c\u6d41\u3002\u4f60\u5e94\u8be5\uff1a\n1. \u4ece\u4ea7\u751f\u5171\u9e23\u7684\u5185\u5bb9\u5f00\u59cb\n2. \u6839\u636e\u4f60\u7684\u6280\u672f\u6808\u8fdb\u884c\u4fee\u6539\n3. \u79fb\u9664\u4f60\u4e0d\u4f7f\u7528\u7684\u90e8\u5206\n4. \u6dfb\u52a0\u4f60\u81ea\u5df1\u7684\u6a21\u5f0f\n\n---\n\n## Star \u5386\u53f2\n\n[![Star History Chart](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code&type=Date)](https://star-history.com/#affaan-m/everything-claude-code&Date)\n\n---\n\n## \u76f8\u5173\u94fe\u63a5\n\n- **\u7b80\u660e\u6307\u5357 (\u4ece\u8fd9\u91cc\u5f00\u59cb)\uff1a** [The Shorthand Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2012378465664745795)\n- **\u6df1\u5ea6\u6307\u5357 (\u8fdb\u9636)\uff1a** [The Longform Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2014040193557471352)\n- **\u5173\u6ce8\uff1a** [@affaanmustafa](https://x.com/affaanmustafa)\n- **zenith.chat:** [zenith.chat](https://zenith.chat)\n\n---\n\n## \u8bb8\u53ef\u8bc1\n\nMIT - \u81ea\u7531\u4f7f\u7528\uff0c\u6839\u636e\u9700\u8981\u4fee\u6539\uff0c\u5982\u679c\u53ef\u4ee5\u8bf7\u56de\u9988\u793e\u533a\u3002\n\n---\n\n**\u5982\u679c\u5bf9\u4f60\u6709\u5e2e\u52a9\uff0c\u8bf7\u7ed9\u672c\u4ed3\u5e93\u70b9\u4e2a Star\u3002\u9605\u8bfb\u4e24\u7bc7\u6307\u5357\u3002\u6784\u5efa\u4f1f\u5927\u7684\u4ea7\u54c1\u3002**\n"
+    "md5": "1d090c2531031d817553cd6b1e0b9b6d",
+    "content": "**\u8bed\u8a00\uff1a** [English](README.md) | \u7e41\u9ad4\u4e2d\u6587\n\n# Everything Claude Code\n\n[![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)\n![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)\n![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)\n![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)\n\n<p align=\"left\">\n  <a href=\"README.md\">English</a> |\n  <span>\u7b80\u4f53\u4e2d\u6587</span>\n</p>\n\n**\u7531 Anthropic \u9ed1\u5ba2\u677e\u83b7\u80dc\u8005\u6574\u7406\u7684 Claude Code \u914d\u7f6e\u5b8c\u6574\u5408\u96c6\u3002**\n\n\u8fd9\u662f\u5728 10 \u4e2a\u6708\u4ee5\u4e0a\u9ad8\u5f3a\u5ea6\u65e5\u5e38\u5f00\u53d1\u771f\u5b9e\u4ea7\u54c1\u7684\u8fc7\u7a0b\u4e2d\uff0c\u4e0d\u65ad\u6f14\u8fdb\u51fa\u7684\u751f\u4ea7\u7ea7\u667a\u80fd\u4f53\uff08Agents\uff09\u3001\u6280\u80fd\uff08Skills\uff09\u3001\u94a9\u5b50\uff08Hooks\uff09\u3001\u547d\u4ee4\uff08Commands\uff09\u3001\u89c4\u5219\uff08Rules\uff09\u4ee5\u53ca MCP \u914d\u7f6e\u3002\n\n---\n\n## \u6307\u5357\uff08The Guides\uff09\n\n\u672c\u4ed3\u5e93\u4ec5\u5305\u542b\u539f\u59cb\u4ee3\u7801\u3002\u4ee5\u4e0b\u6307\u5357\u5c06\u89e3\u91ca\u6240\u6709\u7ec6\u8282\u3002\n\n<table>\n<tr>\n<td width=\"50%\">\n<a href=\"the-shortform-guide_zh.md\">\n<img src=\"https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef\" alt=\"Everything Claude Code \u7b80\u660e\u6307\u5357\" />\n</a>\n</td>\n<td width=\"50%\">\n<a href=\"the-longform-guide.md\">\n<img src=\"https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0\" alt=\"Everything Claude Code \u6df1\u5ea6\u6307\u5357\" />\n</a>\n</td>\n</tr>\n<tr>\n<td align=\"center\"><b>\u7b80\u660e\u6307\u5357 (Shorthand Guide)</b><br/>\u5b89\u88c5\u3001\u57fa\u7840\u3001\u54f2\u5b66\u3002<b>\u8bf7\u5148\u9605\u8bfb\u6b64\u7bc7\u3002</b></td>\n<td align=\"center\"><b>\u6df1\u5ea6\u6307\u5357 (Longform Guide)</b><br/>Token \u4f18\u5316\u3001\u5185\u5b58\u6301\u4e45\u5316\u3001\u8bc4\u6d4b\uff08Evals\uff09\u3001\u5e76\u884c\u5316\u3002</td>\n</tr>\n</table>\n\n| \u4e3b\u9898 | \u4f60\u5c06\u5b66\u5230\u4ec0\u4e48 |\n|-------|-------------------|\n| Token \u4f18\u5316 | \u6a21\u578b\u9009\u62e9\u3001\u7cfb\u7edf\u63d0\u793a\u8bcd\u7cbe\u7b80\u3001\u540e\u53f0\u8fdb\u7a0b |\n| \u5185\u5b58\u6301\u4e45\u5316 | \u8de8\u4f1a\u8bdd\uff08Session\uff09\u81ea\u52a8\u4fdd\u5b58/\u52a0\u8f7d\u4e0a\u4e0b\u6587\u7684\u94a9\u5b50\uff08Hooks\uff09 |\n| \u6301\u7eed\u5b66\u4e60 | \u4ece\u4f1a\u8bdd\u4e2d\u81ea\u52a8\u63d0\u53d6\u6a21\u5f0f\u5e76\u8f6c\u5316\u4e3a\u53ef\u590d\u7528\u7684\u6280\u80fd\uff08Skills\uff09 |\n| \u9a8c\u8bc1\u5faa\u73af | \u68c0\u67e5\u70b9\uff08Checkpoint\uff09\u4e0e\u6301\u7eed\u8bc4\u6d4b\uff08Evals\uff09\u3001\u8bc4\u5206\u5668\u7c7b\u578b\u3001pass@k \u6307\u6807 |\n| \u5e76\u884c\u5316 | Git worktrees\u3001\u7ea7\u8054\u65b9\u6cd5\u3001\u4f55\u65f6\u6269\u5c55\u5b9e\u4f8b |\n| \u5b50\u667a\u80fd\u4f53\u7f16\u6392 | \u4e0a\u4e0b\u6587\u95ee\u9898\u3001\u8fed\u4ee3\u68c0\u7d22\u6a21\u5f0f |\n\n---\n\n## \u8de8\u5e73\u53f0\u652f\u6301\n\n\u8be5\u63d2\u4ef6\u73b0\u5df2\u5168\u9762\u652f\u6301 **Windows\u3001macOS \u548c Linux**\u3002\u6240\u6709\u94a9\u5b50\uff08Hooks\uff09\u548c\u811a\u672c\u90fd\u5df2\u4f7f\u7528 Node.js \u91cd\u5199\uff0c\u4ee5\u5b9e\u73b0\u6700\u5927\u7684\u517c\u5bb9\u6027\u3002\n\n### \u5305\u7ba1\u7406\u5668\u68c0\u6d4b\n\n\u63d2\u4ef6\u4f1a\u81ea\u52a8\u68c0\u6d4b\u4f60\u504f\u597d\u7684\u5305\u7ba1\u7406\u5668\uff08npm, pnpm, yarn, \u6216 bun\uff09\uff0c\u4f18\u5148\u7ea7\u5982\u4e0b\uff1a\n\n1. **\u73af\u5883\u53d8\u91cf**\uff1a`CLAUDE_PACKAGE_MANAGER`\n2. **\u9879\u76ee\u914d\u7f6e**\uff1a`.claude/package-manager.json`\n3. **package.json**\uff1a`packageManager` \u5b57\u6bb5\n4. **\u9501\u6587\u4ef6**\uff1a\u6839\u636e package-lock.json, yarn.lock, pnpm-lock.yaml \u6216 bun.lockb \u68c0\u6d4b\n5. **\u5168\u5c40\u914d\u7f6e**\uff1a`~/.claude/package-manager.json`\n6. **\u5907\u9009\u9879**\uff1a\u7b2c\u4e00\u4e2a\u53ef\u7528\u7684\u5305\u7ba1\u7406\u5668\n\n\u8bbe\u7f6e\u4f60\u504f\u597d\u7684\u5305\u7ba1\u7406\u5668\uff1a\n\n```bash\n# \u901a\u8fc7\u73af\u5883\u53d8\u91cf\nexport CLAUDE_PACKAGE_MANAGER=pnpm\n\n# \u901a\u8fc7\u5168\u5c40\u914d\u7f6e\nnode scripts/setup-package-manager.js --global pnpm\n\n# \u901a\u8fc7\u9879\u76ee\u914d\u7f6e\nnode scripts/setup-package-manager.js --project bun\n\n# \u68c0\u6d4b\u5f53\u524d\u8bbe\u7f6e\nnode scripts/setup-package-manager.js --detect\n```\n\n\u6216\u8005\u5728 Claude Code \u4e2d\u4f7f\u7528 `/setup-pm` \u547d\u4ee4\u3002\n\n---\n\n## \u5305\u542b\u5185\u5bb9\n\n\u672c\u4ed3\u5e93\u662f\u4e00\u4e2a **Claude Code \u63d2\u4ef6** \u2014\u2014 \u4f60\u53ef\u4ee5\u76f4\u63a5\u5b89\u88c5\u5b83\uff0c\u6216\u8005\u624b\u52a8\u590d\u5236\u7ec4\u4ef6\u3002\n\n```\neverything-claude-code/\n|-- .claude-plugin/   # \u63d2\u4ef6\u4e0e\u5e02\u573a\u6e05\u5355\n|   |-- plugin.json         # \u63d2\u4ef6\u5143\u6570\u636e\u4e0e\u7ec4\u4ef6\u8def\u5f84\n|   |-- marketplace.json    # \u7528\u4e8e /plugin marketplace add \u7684\u5e02\u573a\u76ee\u5f55\n|\n|-- agents/           # \u7528\u4e8e\u4efb\u52a1\u59d4\u6d3e\u7684\u4e13\u7528\u5b50\u667a\u80fd\u4f53\uff08Subagents\uff09\n|   |-- planner.md           # \u529f\u80fd\u5b9e\u73b0\u89c4\u5212\n|   |-- architect.md         # \u7cfb\u7edf\u8bbe\u8ba1\u51b3\u7b56\n|   |-- tdd-guide.md         # \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\uff08TDD\uff09\n|   |-- code-reviewer.md     # \u4ee3\u7801\u8d28\u91cf\u4e0e\u5b89\u5168\u8bc4\u5ba1\n|   |-- security-reviewer.md # \u6f0f\u6d1e\u5206\u6790\n|   |-- build-error-resolver.md # \u6784\u5efa\u9519\u8bef\u89e3\u51b3\n|   |-- e2e-runner.md        # Playwright \u7aef\u5230\u7aef\u6d4b\u8bd5\n|   |-- refactor-cleaner.md  # \u6b7b\u4ee3\u7801\u6e05\u7406\n|   |-- doc-updater.md       # \u6587\u6863\u540c\u6b65\n|   |-- go-reviewer.md       # Go \u4ee3\u7801\u8bc4\u5ba1\uff08\u65b0\u589e\uff09\n|   |-- go-build-resolver.md # Go \u6784\u5efa\u9519\u8bef\u89e3\u51b3\uff08\u65b0\u589e\uff09\n|\n|-- skills/           # \u5de5\u4f5c\u6d41\uff08Workflow\uff09\u5b9a\u4e49\u4e0e\u9886\u57df\u77e5\u8bc6\n|   |-- coding-standards/           # \u8bed\u8a00\u6700\u4f73\u5b9e\u8df5\n|   |-- backend-patterns/           # API\u3001\u6570\u636e\u5e93\u3001\u7f13\u5b58\u6a21\u5f0f\n|   |-- frontend-patterns/          # React\u3001Next.js \u6a21\u5f0f\n|   |-- continuous-learning/        # \u4ece\u4f1a\u8bdd\u4e2d\u81ea\u52a8\u63d0\u53d6\u6a21\u5f0f\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- continuous-learning-v2/     # \u57fa\u4e8e\u76f4\u89c9\uff08Instinct\uff09\u7684\u5e26\u7f6e\u4fe1\u5ea6\u8bc4\u5206\u5b66\u4e60\u7cfb\u7edf\n|   |-- iterative-retrieval/        # \u5b50\u667a\u80fd\u4f53\u7684\u6e10\u8fdb\u5f0f\u4e0a\u4e0b\u6587\u7cbe\u70bc\n|   |-- strategic-compact/          # \u624b\u52a8\u538b\u7f29\u5efa\u8bae\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- tdd-workflow/               # TDD \u65b9\u6cd5\u8bba\n|   |-- security-review/            # \u5b89\u5168\u81ea\u67e5\u8868\n|   |-- eval-harness/               # \u9a8c\u8bc1\u5faa\u73af\u8bc4\u6d4b\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- verification-loop/          # \u6301\u7eed\u9a8c\u8bc1\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- golang-patterns/            # Go \u60ef\u7528\u6cd5\u4e0e\u6700\u4f73\u5b9e\u8df5\uff08\u65b0\u589e\uff09\n|   |-- golang-testing/             # Go \u6d4b\u8bd5\u6a21\u5f0f\u3001TDD\u3001\u57fa\u51c6\u6d4b\u8bd5\uff08\u65b0\u589e\uff09\n|\n|-- commands/         # \u7528\u4e8e\u5feb\u901f\u6267\u884c\u7684\u659c\u6760\u547d\u4ee4\uff08Slash Commands\uff09\n|   |-- tdd.md              # /tdd - \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\n|   |-- plan.md             # /plan - \u5b9e\u73b0\u89c4\u5212\n|   |-- e2e.md              # /e2e - \u7aef\u5230\u7aef\u6d4b\u8bd5\u751f\u6210\n|   |-- code-review.md      # /code-review - \u8d28\u91cf\u8bc4\u5ba1\n|   |-- build-fix.md        # /build-fix - \u4fee\u590d\u6784\u5efa\u9519\u8bef\n|   |-- refactor-clean.md   # /refactor-clean - \u79fb\u9664\u6b7b\u4ee3\u7801\n|   |-- learn.md            # /learn - \u4f1a\u8bdd\u4e2d\u9014\u63d0\u53d6\u6a21\u5f0f\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- checkpoint.md       # /checkpoint - \u4fdd\u5b58\u9a8c\u8bc1\u72b6\u6001\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- verify.md           # /verify - \u8fd0\u884c\u9a8c\u8bc1\u5faa\u73af\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- setup-pm.md         # /setup-pm - \u914d\u7f6e\u5305\u7ba1\u7406\u5668\n|   |-- go-review.md        # /go-review - Go \u4ee3\u7801\u8bc4\u5ba1\uff08\u65b0\u589e\uff09\n|   |-- go-test.md          # /go-test - Go TDD \u5de5\u4f5c\u6d41\uff08\u65b0\u589e\uff09\n|   |-- go-build.md         # /go-build - \u4fee\u590d Go \u6784\u5efa\u9519\u8bef\uff08\u65b0\u589e\uff09\n|   |-- skill-create.md     # /skill-create - \u4ece git \u5386\u53f2\u751f\u6210\u6280\u80fd\uff08\u65b0\u589e\uff09\n|   |-- instinct-status.md  # /instinct-status - \u67e5\u770b\u5df2\u5b66\u4e60\u7684\u76f4\u89c9\uff08\u65b0\u589e\uff09\n|   |-- instinct-import.md  # /instinct-import - \u5bfc\u5165\u76f4\u89c9\uff08\u65b0\u589e\uff09\n|   |-- instinct-export.md  # /instinct-export - \u5bfc\u51fa\u76f4\u89c9\uff08\u65b0\u589e\uff09\n|   |-- evolve.md           # /evolve - \u5c06\u76f8\u5173\u76f4\u89c9\u805a\u7c7b\u4e3a\u6280\u80fd\uff08\u65b0\u589e\uff09\n|\n|-- rules/            # \u5fc5\u987b\u9075\u5b88\u7684\u51c6\u5219\uff08\u590d\u5236\u5230 ~/.claude/rules/\uff09\n|   |-- security.md         # \u5f3a\u5236\u6027\u5b89\u5168\u68c0\u67e5\n|   |-- coding-style.md     # \u4e0d\u53ef\u53d8\u6027\u3001\u6587\u4ef6\u7ec4\u7ec7\n|   |-- testing.md          # TDD\u300180% \u8986\u76d6\u7387\u8981\u6c42\n|   |-- git-workflow.md     # \u63d0\u4ea4\u683c\u5f0f\u3001PR \u6d41\u7a0b\n|   |-- agents.md           # \u4f55\u65f6\u59d4\u6d3e\u7ed9\u5b50\u667a\u80fd\u4f53\n|   |-- performance.md      # \u6a21\u578b\u9009\u62e9\u3001\u4e0a\u4e0b\u6587\u7ba1\u7406\n|\n|-- hooks/            # \u57fa\u4e8e\u89e6\u53d1\u5668\u7684\u81ea\u52a8\u5316\n|   |-- hooks.json                # \u6240\u6709\u94a9\u5b50\u914d\u7f6e\uff08PreToolUse, PostToolUse, Stop \u7b49\uff09\n|   |-- memory-persistence/       # \u4f1a\u8bdd\u751f\u547d\u5468\u671f\u94a9\u5b50\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- strategic-compact/        # \u538b\u7f29\u5efa\u8bae\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|\n|-- scripts/          # \u8de8\u5e73\u53f0 Node.js \u811a\u672c\uff08\u65b0\u589e\uff09\n|   |-- lib/                     # \u5171\u4eab\u5b9e\u7528\u7a0b\u5e8f\n|   |   |-- utils.js             # \u8de8\u5e73\u53f0\u6587\u4ef6/\u8def\u5f84/\u7cfb\u7edf\u5de5\u5177\n|   |   |-- package-manager.js   # \u5305\u7ba1\u7406\u5668\u68c0\u6d4b\u4e0e\u9009\u62e9\n|   |-- hooks/                   # \u94a9\u5b50\u5b9e\u73b0\n|   |   |-- session-start.js     # \u4f1a\u8bdd\u5f00\u59cb\u65f6\u52a0\u8f7d\u4e0a\u4e0b\u6587\n|   |   |-- session-end.js       # \u4f1a\u8bdd\u7ed3\u675f\u65f6\u4fdd\u5b58\u72b6\u6001\n|   |   |-- pre-compact.js       # \u538b\u7f29\u524d\u72b6\u6001\u4fdd\u5b58\n|   |   |-- suggest-compact.js   # \u6218\u7565\u6027\u538b\u7f29\u5efa\u8bae\n|   |   |-- evaluate-session.js  # \u4ece\u4f1a\u8bdd\u4e2d\u63d0\u53d6\u6a21\u5f0f\n|   |-- setup-package-manager.js # \u4ea4\u4e92\u5f0f\u5305\u7ba1\u7406\u5668\u8bbe\u7f6e\n|\n|-- tests/            # \u6d4b\u8bd5\u5957\u4ef6\uff08\u65b0\u589e\uff09\n|   |-- lib/                     # \u5e93\u6d4b\u8bd5\n|   |-- hooks/                   # \u94a9\u5b50\u6d4b\u8bd5\n|   |-- run-all.js               # \u8fd0\u884c\u6240\u6709\u6d4b\u8bd5\n|\n|-- contexts/         # \u52a8\u6001\u7cfb\u7edf\u63d0\u793a\u8bcd\u6ce8\u5165\u4e0a\u4e0b\u6587\uff08\u6df1\u5ea6\u6307\u5357\u5185\u5bb9\uff09\n|   |-- dev.md              # \u5f00\u53d1\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|   |-- review.md           # \u4ee3\u7801\u8bc4\u5ba1\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|   |-- research.md         # \u7814\u7a76/\u63a2\u7d22\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|\n|-- examples/         # \u914d\u7f6e\u4e0e\u4f1a\u8bdd\u793a\u4f8b\n|   |-- CLAUDE.md           # \u9879\u76ee\u7ea7\u914d\u7f6e\u793a\u4f8b\n|   |-- user-CLAUDE.md      # \u7528\u6237\u7ea7\u914d\u7f6e\u793a\u4f8b\n|\n|-- mcp-configs/      # MCP \u670d\u52a1\u914d\u7f6e\n|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway \u7b49\n|\n|-- marketplace.json  # \u81ea\u6258\u7ba1\u5e02\u573a\u914d\u7f6e\uff08\u7528\u4e8e /plugin marketplace add\uff09\n```\n\n---\n\n## \u751f\u6001\u5de5\u5177\n\n### \u6280\u80fd\u521b\u5efa\u5668\uff08Skill Creator\uff09\n\n\u6709\u4e24\u79cd\u65b9\u6cd5\u53ef\u4ee5\u4ece\u4f60\u7684\u4ed3\u5e93\u751f\u6210 Claude Code \u6280\u80fd\uff1a\n\n#### \u65b9\u6848 A\uff1a\u672c\u5730\u5206\u6790\uff08\u5185\u7f6e\uff09\n\n\u4f7f\u7528 `/skill-create` \u547d\u4ee4\u8fdb\u884c\u672c\u5730\u5206\u6790\uff0c\u65e0\u9700\u5916\u90e8\u670d\u52a1\uff1a\n\n```bash\n/skill-create                    # \u5206\u6790\u5f53\u524d\u4ed3\u5e93\n/skill-create --instincts        # \u540c\u65f6\u4e3a\u6301\u7eed\u5b66\u4e60\uff08continuous-learning\uff09\u751f\u6210\u76f4\u89c9\uff08instincts\uff09\n```\n\n\u8be5\u547d\u4ee4\u4f1a\u5728\u672c\u5730\u5206\u6790\u4f60\u7684 git \u5386\u53f2\u5e76\u751f\u6210 SKILL.md \u6587\u4ef6\u3002\n\n#### \u65b9\u6848 B\uff1aGitHub App\uff08\u9ad8\u7ea7\uff09\n\n\u9002\u7528\u4e8e\u9ad8\u7ea7\u529f\u80fd\uff081\u4e07+ commit\u3001\u81ea\u52a8 PR\u3001\u56e2\u961f\u5171\u4eab\uff09\uff1a\n\n[\u5b89\u88c5 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)\n\n```bash\n# \u5728\u4efb\u4f55 issue \u4e0b\u7559\u8a00\uff1a\n/skill-creator analyze\n\n# \u6216\u8005\u5728 push \u5230\u9ed8\u8ba4\u5206\u652f\u65f6\u81ea\u52a8\u89e6\u53d1\n```\n\n\u4e24\u79cd\u65b9\u6848\u90fd\u4f1a\u521b\u5efa\uff1a\n- **SKILL.md \u6587\u4ef6** - \u53ef\u76f4\u63a5\u7528\u4e8e Claude Code \u7684\u6280\u80fd\n- **\u76f4\u89c9\u96c6\u5408\uff08Instinct collections\uff09** - \u7528\u4e8e continuous-learning-v2\n- **\u6a21\u5f0f\u63d0\u53d6\uff08Pattern extraction\uff09** - \u4ece\u4f60\u7684\u63d0\u4ea4\u5386\u53f2\u4e2d\u5b66\u4e60\n\n### \u6301\u7eed\u5b66\u4e60\uff08Continuous Learning\uff09v2\n\n\u57fa\u4e8e\u76f4\u89c9\uff08instinct\uff09\u7684\u5b66\u4e60\u7cfb\u7edf\u4f1a\u81ea\u52a8\u5b66\u4e60\u4f60\u7684\u5f00\u53d1\u6a21\u5f0f\uff1a\n\n```bash\n/instinct-status        # \u663e\u793a\u5e26\u6709\u7f6e\u4fe1\u5ea6\u7684\u5df2\u5b66\u4e60\u76f4\u89c9\n/instinct-import <file> # \u5bfc\u5165\u4ed6\u4eba\u7684\u76f4\u89c9\n/instinct-export        # \u5bfc\u51fa\u4f60\u7684\u76f4\u89c9\u4ee5\u4fbf\u5206\u4eab\n/evolve                 # \u5c06\u76f8\u5173\u7684\u76f4\u89c9\u805a\u7c7b\u4e3a\u6280\u80fd\uff08skills\uff09\n```\n\n\u8be6\u89c1 `skills/continuous-learning-v2/` \u7684\u5b8c\u6574\u6587\u6863\u3002\n\n---\n\n## \u8981\u6c42\n\n### Claude Code CLI \u7248\u672c\n\n**\u6700\u4f4e\u7248\u672c\uff1av2.1.0 \u6216\u66f4\u9ad8**\n\n\u7531\u4e8e\u63d2\u4ef6\u7cfb\u7edf\u5904\u7406\u94a9\u5b50\uff08hooks\uff09\u65b9\u5f0f\u7684\u53d8\u66f4\uff0c\u672c\u63d2\u4ef6\u8981\u6c42 Claude Code CLI v2.1.0+\u3002\n\n\u68c0\u67e5\u4f60\u7684\u7248\u672c\uff1a\n```bash\nclaude --version\n```\n\n### \u91cd\u8981\uff1a\u94a9\u5b50\uff08Hooks\uff09\u81ea\u52a8\u52a0\u8f7d\u884c\u4e3a\n\n> \u26a0\ufe0f **\u5bf9\u8d21\u732e\u8005\u7684\u63d0\u9192\uff1a** \u8bf7\u52ff\u5728 `.claude-plugin/plugin.json` \u4e2d\u6dfb\u52a0 `\"hooks\"` \u5b57\u6bb5\u3002\u8fd9\u662f\u7531\u56de\u5f52\u6d4b\u8bd5\u5f3a\u5236\u6267\u884c\u7684\u3002\n\nClaude Code v2.1+ \u4f1a**\u81ea\u52a8\u52a0\u8f7d**\u5df2\u5b89\u88c5\u63d2\u4ef6\u4e2d\u7ea6\u5b9a\u7684 `hooks/hooks.json`\u3002\u5728 `plugin.json` \u4e2d\u663e\u5f0f\u58f0\u660e\u4f1a\u5bfc\u81f4\u91cd\u590d\u68c0\u6d4b\u9519\u8bef\uff1a\n\n```\nDuplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file\n```\n\n**\u5386\u53f2\u80cc\u666f\uff1a** \u6b64\u95ee\u9898\u5728\u672c\u4ed3\u5e93\u4e2d\u66fe\u591a\u6b21\u51fa\u73b0\u4fee\u590d/\u56de\u9000\u5faa\u73af\uff08[#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)\uff09\u3002Claude Code \u7248\u672c\u95f4\u7684\u884c\u4e3a\u5dee\u5f02\u5bfc\u81f4\u4e86\u6df7\u6dc6\u3002\u6211\u4eec\u73b0\u5728\u5df2\u52a0\u5165\u56de\u5f52\u6d4b\u8bd5\u4ee5\u9632\u6b62\u6b64\u7c7b\u95ee\u9898\u518d\u6b21\u53d1\u751f\u3002\n\n---\n\n## \u5b89\u88c5\n\n### \u65b9\u6848 1\uff1a\u4f5c\u4e3a\u63d2\u4ef6\u5b89\u88c5\uff08\u63a8\u8350\uff09\n\n\u8fd9\u662f\u4f7f\u7528\u672c\u4ed3\u5e93\u6700\u7b80\u5355\u7684\u65b9\u6cd5 \u2014\u2014 \u4f5c\u4e3a Claude Code \u63d2\u4ef6\u5b89\u88c5\uff1a\n\n```bash\n# \u5c06\u6b64\u4ed3\u5e93\u6dfb\u52a0\u4e3a\u5e02\u573a\uff08marketplace\uff09\n/plugin marketplace add affaan-m/everything-claude-code\n\n# \u5b89\u88c5\u63d2\u4ef6\n/plugin install everything-claude-code@everything-claude-code\n```\n\n\u6216\u8005\u76f4\u63a5\u6dfb\u52a0\u5230\u4f60\u7684 `~/.claude/settings.json`\uff1a\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"everything-claude-code\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"affaan-m/everything-claude-code\"\n      }\n    }\n  },\n  \"enabledPlugins\": {\n    \"everything-claude-code@everything-claude-code\": true\n  }\n}\n```\n\n\u5b89\u88c5\u540e\u5373\u53ef\u7acb\u5373\u4f7f\u7528\u6240\u6709\u547d\u4ee4\uff08commands\uff09\u3001\u667a\u80fd\u4f53\uff08agents\uff09\u3001\u6280\u80fd\uff08skills\uff09\u548c\u94a9\u5b50\uff08hooks\uff09\u3002\n\n> **\u6ce8\u610f\uff1a** Claude Code \u63d2\u4ef6\u7cfb\u7edf\u76ee\u524d\u4e0d\u652f\u6301\u901a\u8fc7\u63d2\u4ef6\u5206\u53d1\u89c4\u5219\uff08`rules`\uff09\uff08\u8fd9\u662f [\u4e0a\u6e38\u9650\u5236](https://code.claude.com/docs/en/plugins-reference)\uff09\u3002\u4f60\u9700\u8981\u624b\u52a8\u5b89\u88c5\u89c4\u5219\uff1a\n>\n> ```bash\n> # \u9996\u5148\u514b\u9686\u4ed3\u5e93\n> git clone https://github.com/affaan-m/everything-claude-code.git\n>\n> # \u65b9\u6848 A\uff1a\u7528\u6237\u7ea7\u89c4\u5219\uff08\u5e94\u7528\u4e8e\u6240\u6709\u9879\u76ee\uff09\n> cp -r everything-claude-code/rules/* ~/.claude/rules/\n>\n> # \u65b9\u6848 B\uff1a\u9879\u76ee\u7ea7\u89c4\u5219\uff08\u4ec5\u5e94\u7528\u4e8e\u5f53\u524d\u9879\u76ee\uff09\n> mkdir -p .claude/rules\n> cp -r everything-claude-code/rules/* .claude/rules/\n> ```\n\n---\n\n### \u65b9\u6848 2\uff1a\u624b\u52a8\u5b89\u88c5\n\n\u5982\u679c\u4f60\u66f4\u503e\u5411\u4e8e\u624b\u52a8\u63a7\u5236\u5b89\u88c5\u7684\u5185\u5bb9\uff1a\n\n```bash\n# \u514b\u9686\u4ed3\u5e93\ngit clone https://github.com/affaan-m/everything-claude-code.git\n\n# \u590d\u5236\u667a\u80fd\u4f53\uff08agents\uff09\u5230\u4f60\u7684 Claude \u914d\u7f6e\u76ee\u5f55\ncp everything-claude-code/agents/*.md ~/.claude/agents/\n\n# \u590d\u5236\u89c4\u5219\uff08rules\uff09\ncp everything-claude-code/rules/*.md ~/.claude/rules/\n\n# \u590d\u5236\u547d\u4ee4\uff08commands\uff09\ncp everything-claude-code/commands/*.md ~/.claude/commands/\n\n# \u590d\u5236\u6280\u80fd\uff08skills\uff09\ncp -r everything-claude-code/skills/* ~/.claude/skills/\n```\n\n#### \u5c06\u94a9\u5b50\uff08hooks\uff09\u6dfb\u52a0\u5230 settings.json\n\n\u5c06 `hooks/hooks.json` \u4e2d\u7684\u94a9\u5b50\u914d\u7f6e\u590d\u5236\u5230\u4f60\u7684 `~/.claude/settings.json` \u4e2d\u3002\n\n#### \u914d\u7f6e MCPs\n\n\u5c06 `mcp-configs/mcp-servers.json` \u4e2d\u4f60\u9700\u8981\u7684 MCP \u670d\u52a1\u914d\u7f6e\u590d\u5236\u5230\u4f60\u7684 `~/.claude.json`\u3002\n\n**\u91cd\u8981\uff1a** \u8bf7\u5c06 `YOUR_*_HERE` \u5360\u4f4d\u7b26\u66ff\u6362\u4e3a\u4f60\u771f\u5b9e\u7684 API \u5bc6\u94a5\u3002\n\n---\n\n## \u6838\u5fc3\u6982\u5ff5\n\n### \u667a\u80fd\u4f53\uff08Agents\uff09\n\n\u5b50\u667a\u80fd\u4f53\uff08Subagents\uff09\u8d1f\u8d23\u5904\u7406\u53d7\u9650\u8303\u56f4\u5185\u7684\u59d4\u6d3e\u4efb\u52a1\u3002\u793a\u4f8b\uff1a\n\n```markdown\n---\nname: code-reviewer\ndescription: \u8bc4\u5ba1\u4ee3\u7801\u8d28\u91cf\u3001\u5b89\u5168\u6027\u4e0e\u53ef\u7ef4\u62a4\u6027\ntools: [\"Read\", \"Grep\", \"Glob\", \"Bash\"]\nmodel: opus\n---\n\n\u4f60\u662f\u4e00\u540d\u8d44\u6df1\u4ee3\u7801\u8bc4\u5ba1\u5458...\n```\n\n### \u6280\u80fd\uff08Skills\uff09\n\n\u6280\u80fd\uff08Skills\uff09\u662f\u53ef\u7531\u547d\u4ee4\u6216\u667a\u80fd\u4f53\u8c03\u7528\u7684\u5de5\u4f5c\u6d41\u5b9a\u4e49\uff1a\n\n```markdown\n# TDD \u5de5\u4f5c\u6d41\n\n1. \u9996\u5148\u5b9a\u4e49\u63a5\u53e3\n2. \u7f16\u5199\u5931\u8d25\u7684\u6d4b\u8bd5\uff08RED\uff09\n3. \u5b9e\u73b0\u6700\u7b80\u4ee3\u7801\uff08GREEN\uff09\n4. \u91cd\u6784\uff08IMPROVE\uff09\n5. \u9a8c\u8bc1\u8986\u76d6\u7387\u662f\u5426\u8fbe\u5230 80% \u4ee5\u4e0a\n```\n\n### \u94a9\u5b50\uff08Hooks\uff09\n\n\u94a9\u5b50\uff08Hooks\uff09\u5728\u5de5\u5177\u4e8b\u4ef6\u53d1\u751f\u65f6\u89e6\u53d1\u3002\u793a\u4f8b \u2014\u2014 \u9488\u5bf9 console.log \u53d1\u51fa\u8b66\u544a\uff1a\n\n```json\n{\n  \"matcher\": \"tool == \\\"Edit\\\" && tool_input.file_path matches \\\"\\\\.(ts|tsx|js|jsx)$\\\"\",\n  \"hooks\": [{\n    \"type\": \"command\",\n    \"command\": \"#!/bin/bash\\ngrep -n 'console\\\\.log' \\\"$file_path\\\" && echo '[Hook] Remove console.log' >&2\"\n  }]\n}\n```\n\n### \u89c4\u5219\uff08Rules\uff09\n\n\u89c4\u5219\uff08Rules\uff09\u662f\u5fc5\u987b\u59cb\u7ec8\u9075\u5b88\u7684\u51c6\u5219\u3002\u8bf7\u4fdd\u6301\u5b83\u4eec\u7684\u6a21\u5757\u5316\uff1a\n\n```\n~/.claude/rules/\n  security.md      # \u7981\u6b62\u786c\u7f16\u7801\u5bc6\u94a5\n  coding-style.md  # \u4e0d\u53ef\u53d8\u6027\u3001\u6587\u4ef6\u9650\u5236\n  testing.md       # TDD\u3001\u8986\u76d6\u7387\u8981\u6c42\n```\n\n---\n\n## \u8fd0\u884c\u6d4b\u8bd5\n\n\u672c\u63d2\u4ef6\u5305\u542b\u4e00\u4e2a\u5168\u9762\u7684\u6d4b\u8bd5\u5957\u4ef6\uff1a\n\n```bash\n# \u8fd0\u884c\u6240\u6709\u6d4b\u8bd5\nnode tests/run-all.js\n\n# \u8fd0\u884c\u5355\u4e2a\u6d4b\u8bd5\u6587\u4ef6\nnode tests/lib/utils.test.js\nnode tests/lib/package-manager.test.js\nnode tests/hooks/hooks.test.js\n```\n\n---\n\n## \u8d21\u732e\n\n**\u975e\u5e38\u6b22\u8fce\u5e76\u9f13\u52b1\u8d21\u732e\u3002**\n\n\u672c\u4ed3\u5e93\u65e8\u5728\u6210\u4e3a\u4e00\u4e2a\u793e\u533a\u8d44\u6e90\u3002\u5982\u679c\u4f60\u6709\uff1a\n- \u6709\u7528\u7684\u667a\u80fd\u4f53\u6216\u6280\u80fd\n- \u5de7\u5999\u7684\u94a9\u5b50\n- \u66f4\u597d\u7684 MCP \u914d\u7f6e\n- \u6539\u8fdb\u540e\u7684\u89c4\u5219\n\n\u8bf7\u63d0\u4ea4\u4f60\u7684\u8d21\u732e\uff01\u53c2\u8003 [CONTRIBUTING.md](CONTRIBUTING.md) \u4e86\u89e3\u6307\u5357\u3002\n\n### \u8d21\u732e\u601d\u8def\n\n- \u8bed\u8a00\u4e13\u7528\u6280\u80fd\uff08Python, Rust \u6a21\u5f0f\uff09\u2014\u2014 \u5df2\u5305\u542b Go\uff01\n- \u6846\u67b6\u4e13\u7528\u914d\u7f6e\uff08Django, Rails, Laravel\uff09\n- DevOps \u667a\u80fd\u4f53\uff08Kubernetes, Terraform, AWS\uff09\n- \u6d4b\u8bd5\u7b56\u7565\uff08\u4e0d\u540c\u6846\u67b6\uff09\n- \u9886\u57df\u7279\u5b9a\u77e5\u8bc6\uff08\u673a\u5668\u5b66\u4e60\u3001\u6570\u636e\u5de5\u7a0b\u3001\u79fb\u52a8\u5f00\u53d1\uff09\n\n---\n\n## \u80cc\u666f\n\n\u6211\u4ece Claude Code \u5b9e\u9a8c\u9636\u6bb5\u5c31\u5f00\u59cb\u4f7f\u7528\u4e86\u3002\u5728 2025 \u5e74 9 \u6708\u7684 Anthropic x Forum Ventures \u9ed1\u5ba2\u677e\u4e2d\uff0c\u6211\u4e0e [@DRodriguezFX](https://x.com/DRodriguezFX) \u5408\u4f5c\u5f00\u53d1\u4e86 [zenith.chat](https://zenith.chat)\uff0c\u5e76\u83b7\u5f97\u4e86\u51a0\u519b \u2014\u2014 \u8be5\u9879\u76ee\u5b8c\u5168\u4f7f\u7528 Claude Code \u6784\u5efa\u3002\n\n\u8fd9\u4e9b\u914d\u7f6e\u5728\u591a\u4e2a\u751f\u4ea7\u7ea7\u5e94\u7528\u4e2d\u7ecf\u8fc7\u4e86\u5b9e\u6218\u68c0\u9a8c\u3002\n\n---\n\n## \u91cd\u8981\u63d0\u793a\n\n### \u4e0a\u4e0b\u6587\u7a97\u53e3\u7ba1\u7406\n\n**\u81f3\u5173\u91cd\u8981\uff1a** \u4e0d\u8981\u4e00\u6b21\u6027\u542f\u7528\u6240\u6709 MCP\u3002\u5982\u679c\u542f\u7528\u7684\u5de5\u5177\u8fc7\u591a\uff0c\u4f60\u7684 200k \u4e0a\u4e0b\u6587\u7a97\u53e3\u53ef\u80fd\u4f1a\u7f29\u51cf\u5230 70k\u3002\n\n\u7ecf\u9a8c\u6cd5\u5219\uff1a\n- \u914d\u7f6e 20-30 \u4e2a MCP\n- \u6bcf\u4e2a\u9879\u76ee\u4fdd\u6301\u542f\u7528 10 \u4e2a\u4ee5\u5185\n- \u6d3b\u8dc3\u5de5\u5177\u603b\u6570\u63a7\u5236\u5728 80 \u4e2a\u4ee5\u5185\n\n\u5728\u9879\u76ee\u914d\u7f6e\u4e2d\u4f7f\u7528 `disabledMcpServers` \u6765\u7981\u7528\u4e0d\u9700\u8981\u7684\u670d\u52a1\u3002\n\n### \u81ea\u5b9a\u4e49\n\n\u8fd9\u4e9b\u914d\u7f6e\u9002\u7528\u4e8e\u6211\u7684\u5de5\u4f5c\u6d41\u3002\u4f60\u5e94\u8be5\uff1a\n1. \u4ece\u4f60\u4ea7\u751f\u5171\u9e23\u7684\u5185\u5bb9\u5f00\u59cb\n2. \u6839\u636e\u4f60\u7684\u6280\u672f\u6808\u8fdb\u884c\u4fee\u6539\n3. \u79fb\u9664\u4f60\u4e0d\u9700\u8981\u7684\u5185\u5bb9\n4. \u52a0\u5165\u4f60\u81ea\u5df1\u7684\u6a21\u5f0f\n\n---\n\n## Star \u5386\u53f2\n\n[![Star History Chart](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code&type=Date)](https://star-history.com/#affaan-m/everything-claude-code&Date)\n\n---\n\n## \u76f8\u5173\u94fe\u63a5\n\n- **\u7b80\u660e\u6307\u5357\uff08\u5165\u95e8\u5fc5\u8bfb\uff09\uff1a** [Everything Claude Code \u7b80\u660e\u6307\u5357](https://x.com/affaanmustafa/status/2012378465664745795)\n- **\u6df1\u5ea6\u6307\u5357\uff08\u8fdb\u9636\u53c2\u8003\uff09\uff1a** [Everything Claude Code \u6df1\u5ea6\u6307\u5357](https://x.com/affaanmustafa/status/2014040193557471352)\n- **\u5173\u6ce8\u6211\uff1a** [@affaanmustafa](https://x.com/affaanmustafa)\n- **zenith.chat\uff1a** [zenith.chat](https://zenith.chat)\n\n---\n\n## \u8bb8\u53ef\u8bc1\n\nMIT - \u81ea\u7531\u4f7f\u7528\uff0c\u6309\u9700\u4fee\u6539\uff0c\u5982\u679c\u53ef\u4ee5\u8bf7\u56de\u9988\u793e\u533a\u3002\n\n---\n\n**\u5982\u679c\u5bf9\u4f60\u6709\u5e2e\u52a9\uff0c\u8bf7\u7ed9\u672c\u4ed3\u5e93\u70b9\u4e2a Star\u3002\u9605\u8bfb\u4e24\u4efd\u6307\u5357\u3002\u6784\u5efa\u4f1f\u5927\u7684\u4ea7\u54c1\u3002**\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/CONTRIBUTING.md": {
     "md5": "eccf62e6ed292589dc5661a208902ddb",
@@ -88,8 +88,8 @@
     "content": "---\nname: build-error-resolver\ndescription: \u6784\u5efa\u4e0e TypeScript \u9519\u8bef\u4fee\u590d\u4e13\u5bb6\u3002\u5f53\u6784\u5efa\u5931\u8d25\u6216\u51fa\u73b0\u7c7b\u578b\u9519\u8bef\u65f6\u4e3b\u52a8\u4f7f\u7528\u3002\u4ec5\u4ee5\u6700\u5c0f\u5dee\u5f02\u4fee\u6539\uff08minimal diffs\uff09\u4fee\u590d\u6784\u5efa/\u7c7b\u578b\u9519\u8bef\uff0c\u4e0d\u8fdb\u884c\u67b6\u6784\u5c42\u9762\u7684\u7f16\u8f91\u3002\u4e13\u6ce8\u4e8e\u5feb\u901f\u6062\u590d\u7eff\u8272\u6784\u5efa\u72b6\u6001\u3002\ntools: [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Grep\", \"Glob\"]\nmodel: opus\n---\n\n# \u6784\u5efa\u9519\u8bef\u4fee\u590d\u4e13\u5bb6 (Build Error Resolver)\n\n\u4f60\u662f\u4e00\u540d\u8d44\u6df1\u7684\u6784\u5efa\u9519\u8bef\u4fee\u590d\u4e13\u5bb6\uff0c\u4e13\u6ce8\u4e8e\u5feb\u901f\u9ad8\u6548\u5730\u4fee\u590d TypeScript\u3001\u7f16\u8bd1\u548c\u6784\u5efa\u9519\u8bef\u3002\u4f60\u7684\u4f7f\u547d\u662f\u4f7f\u7528\u6700\u5c0f\u7684\u6539\u52a8\u8ba9\u6784\u5efa\u901a\u8fc7\uff0c\u4e0d\u6d89\u53ca\u4efb\u4f55\u67b6\u6784\u4fee\u6539\u3002\n\n## \u6838\u5fc3\u804c\u8d23\n\n1.  **TypeScript \u9519\u8bef\u89e3\u51b3** - \u4fee\u590d\u7c7b\u578b\u9519\u8bef\u3001\u63a8\u65ad\u95ee\u9898\u3001\u6cdb\u578b\u7ea6\u675f\u3002\n2.  **\u6784\u5efa\u9519\u8bef\u4fee\u590d** - \u89e3\u51b3\u7f16\u8bd1\u5931\u8d25\u3001\u6a21\u5757\u89e3\u6790\uff08Module Resolution\uff09\u95ee\u9898\u3002\n3.  **\u4f9d\u8d56\u95ee\u9898** - \u4fee\u590d\u5bfc\u5165\u9519\u8bef\u3001\u7f3a\u5931\u7684\u5305\u3001\u7248\u672c\u51b2\u7a81\u3002\n4.  **\u914d\u7f6e\u9519\u8bef** - \u89e3\u51b3 `tsconfig.json`\u3001webpack\u3001Next.js \u914d\u7f6e\u95ee\u9898\u3002\n5.  **\u6700\u5c0f\u5dee\u5f02\u4fee\u6539 (Minimal Diffs)** - \u5c3d\u53ef\u80fd\u901a\u8fc7\u6700\u5c0f\u7684\u6539\u52a8\u6765\u4fee\u590d\u9519\u8bef\u3002\n6.  **\u7981\u6b62\u67b6\u6784\u66f4\u6539** - \u4ec5\u4fee\u590d\u9519\u8bef\uff0c\u4e0d\u8fdb\u884c\u91cd\u6784\u6216\u91cd\u65b0\u8bbe\u8ba1\u3002\n\n## \u53ef\u7528\u5de5\u5177\n\n### \u6784\u5efa\u4e0e\u7c7b\u578b\u68c0\u67e5\u5de5\u5177\n- **tsc** - \u7528\u4e8e\u7c7b\u578b\u68c0\u67e5\u7684 TypeScript \u7f16\u8bd1\u5668\u3002\n- **npm/yarn** - \u5305\u7ba1\u7406\u3002\n- **eslint** - \u4ee3\u7801\u68c0\u67e5\uff08\u53ef\u80fd\u5bfc\u81f4\u6784\u5efa\u5931\u8d25\uff09\u3002\n- **next build** - Next.js \u751f\u4ea7\u73af\u5883\u6784\u5efa\u3002\n\n### \u8bca\u65ad\u547d\u4ee4\n```bash\n# TypeScript \u7c7b\u578b\u68c0\u67e5\uff08\u4e0d\u8f93\u51fa\u6587\u4ef6\uff09\nnpx tsc --noEmit\n\n# \u5e26\u6709\u7f8e\u5316\u8f93\u51fa\u7684 TypeScript \u68c0\u67e5\nnpx tsc --noEmit --pretty\n\n# \u663e\u793a\u6240\u6709\u9519\u8bef\uff08\u4e0d\u5728\u7b2c\u4e00\u4e2a\u9519\u8bef\u5904\u505c\u6b62\uff09\nnpx tsc --noEmit --pretty --incremental false\n\n# \u68c0\u67e5\u7279\u5b9a\u6587\u4ef6\nnpx tsc --noEmit path/to/file.ts\n\n# ESLint \u68c0\u67e5\nnpx eslint . --ext .ts,.tsx,.js,.jsx\n\n# Next.js \u6784\u5efa\uff08\u751f\u4ea7\u73af\u5883\uff09\nnpm run build\n\n# \u5e26\u6709\u8c03\u8bd5\u4fe1\u606f\u7684 Next.js \u6784\u5efa\nnpm run build -- --debug\n```\n\n## \u9519\u8bef\u5904\u7406\u5de5\u4f5c\u6d41\n\n### 1. \u6536\u96c6\u6240\u6709\u9519\u8bef\n```\na) \u8fd0\u884c\u5b8c\u6574\u7684\u7c7b\u578b\u68c0\u67e5\n   - npx tsc --noEmit --pretty\n   - \u6355\u83b7\u6240\u6709\u9519\u8bef\uff0c\u800c\u4e0d\u53ea\u662f\u7b2c\u4e00\u4e2a\n\nb) \u6309\u7c7b\u578b\u5bf9\u9519\u8bef\u8fdb\u884c\u5206\u7c7b\n   - \u7c7b\u578b\u63a8\u65ad\u5931\u8d25\n   - \u7f3a\u5931\u7c7b\u578b\u5b9a\u4e49\n   - \u5bfc\u5165/\u5bfc\u51fa\u9519\u8bef\n   - \u914d\u7f6e\u9519\u8bef\n   - \u4f9d\u8d56\u95ee\u9898\n\nc) \u6309\u5f71\u54cd\u7a0b\u5ea6\u6392\u5e8f\n   - \u963b\u585e\u6784\u5efa\u7684\u95ee\u9898\uff1a\u4f18\u5148\u4fee\u590d\n   - \u7c7b\u578b\u9519\u8bef\uff1a\u6309\u987a\u5e8f\u4fee\u590d\n   - \u8b66\u544a\uff1a\u65f6\u95f4\u5141\u8bb8\u65f6\u4fee\u590d\n```\n\n### 2. \u4fee\u590d\u7b56\u7565\uff08\u6700\u5c0f\u6539\u52a8\uff09\n```\n\u9488\u5bf9\u6bcf\u4e2a\u9519\u8bef\uff1a\n\n1. \u7406\u89e3\u9519\u8bef\n   - \u4ed4\u7ec6\u9605\u8bfb\u9519\u8bef\u4fe1\u606f\n   - \u68c0\u67e5\u6587\u4ef6\u548c\u884c\u53f7\n   - \u7406\u89e3\u201c\u9884\u671f\u7c7b\u578b\u201d\u4e0e\u201c\u5b9e\u9645\u7c7b\u578b\u201d\u7684\u533a\u522b\n\n2. \u5bfb\u627e\u6700\u5c0f\u4fee\u590d\u65b9\u6848\n   - \u6dfb\u52a0\u7f3a\u5931\u7684\u7c7b\u578b\u6ce8\u89e3\n   - \u4fee\u590d\u5bfc\u5165\u8bed\u53e5\n   - \u6dfb\u52a0\u7a7a\u503c\u68c0\u67e5\uff08Null check\uff09\n   - \u4f7f\u7528\u7c7b\u578b\u65ad\u8a00\uff08\u4ec5\u4f5c\u4e3a\u6700\u540e\u624b\u6bb5\uff09\n\n3. \u9a8c\u8bc1\u4fee\u590d\u662f\u5426\u7834\u574f\u4e86\u5176\u4ed6\u4ee3\u7801\n   - \u6bcf\u6b21\u4fee\u590d\u540e\u518d\u6b21\u8fd0\u884c tsc\n   - \u68c0\u67e5\u76f8\u5173\u6587\u4ef6\n   - \u786e\u4fdd\u6ca1\u6709\u5f15\u5165\u65b0\u7684\u9519\u8bef\n\n4. \u8fed\u4ee3\u76f4\u81f3\u6784\u5efa\u901a\u8fc7\n   - \u4e00\u6b21\u53ea\u4fee\u590d\u4e00\u4e2a\u9519\u8bef\n   - \u6bcf\u6b21\u4fee\u590d\u540e\u91cd\u65b0\u7f16\u8bd1\n   - \u8ddf\u8e2a\u8fdb\u5ea6\uff08\u5df2\u4fee\u590d X/Y \u4e2a\u9519\u8bef\uff09\n```\n\n### 3. \u5e38\u89c1\u9519\u8bef\u6a21\u5f0f\u4e0e\u4fee\u590d\n\n**\u6a21\u5f0f 1\uff1a\u7c7b\u578b\u63a8\u65ad\u5931\u8d25**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u53c2\u6570 'x' \u9690\u5f0f\u5177\u6709 'any' \u7c7b\u578b\nfunction add(x, y) {\n  return x + y\n}\n\n// \u2705 \u4fee\u590d\uff1a\u6dfb\u52a0\u7c7b\u578b\u6ce8\u89e3\nfunction add(x: number, y: number): number {\n  return x + y\n}\n```\n\n**\u6a21\u5f0f 2\uff1aNull/Undefined \u9519\u8bef**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u5bf9\u8c61\u53ef\u80fd\u4e3a 'undefined'\nconst name = user.name.toUpperCase()\n\n// \u2705 \u4fee\u590d\uff1a\u53ef\u9009\u94fe (Optional chaining)\nconst name = user?.name?.toUpperCase()\n\n// \u2705 \u6216\u8005\uff1a\u7a7a\u503c\u68c0\u67e5\nconst name = user && user.name ? user.name.toUpperCase() : ''\n```\n\n**\u6a21\u5f0f 3\uff1a\u7f3a\u5931\u5c5e\u6027**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u7c7b\u578b 'User' \u4e0a\u4e0d\u5b58\u5728\u5c5e\u6027 'age'\ninterface User {\n  name: string\n}\nconst user: User = { name: 'John', age: 30 }\n\n// \u2705 \u4fee\u590d\uff1a\u5728\u63a5\u53e3\u4e2d\u6dfb\u52a0\u5c5e\u6027\ninterface User {\n  name: string\n  age?: number // \u5982\u679c\u4e0d\u603b\u662f\u5b58\u5728\uff0c\u5219\u8bbe\u4e3a\u53ef\u9009\n}\n```\n\n**\u6a21\u5f0f 4\uff1a\u5bfc\u5165\u9519\u8bef**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u627e\u4e0d\u5230\u6a21\u5757 '@/lib/utils'\nimport { formatDate } from '@/lib/utils'\n\n// \u2705 \u4fee\u590d 1\uff1a\u68c0\u67e5 tsconfig \u8def\u5f84\u914d\u7f6e\u662f\u5426\u6b63\u786e\n{\n  \"compilerOptions\": {\n    \"paths\": {\n      \"@/*\": [\"./src/*\"]\n    }\n  }\n}\n\n// \u2705 \u4fee\u590d 2\uff1a\u4f7f\u7528\u76f8\u5bf9\u8def\u5f84\u5bfc\u5165\nimport { formatDate } from '../lib/utils'\n\n// \u2705 \u4fee\u590d 3\uff1a\u5b89\u88c5\u7f3a\u5931\u7684\u5305\nnpm install @/lib/utils\n```\n\n**\u6a21\u5f0f 5\uff1a\u7c7b\u578b\u4e0d\u5339\u914d**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u7c7b\u578b 'string' \u4e0d\u80fd\u8d4b\u503c\u7ed9\u7c7b\u578b 'number'\nconst age: number = \"30\"\n\n// \u2705 \u4fee\u590d\uff1a\u5c06\u5b57\u7b26\u4e32\u89e3\u6790\u4e3a\u6570\u5b57\nconst age: number = parseInt(\"30\", 10)\n\n// \u2705 \u6216\u8005\uff1a\u66f4\u6539\u7c7b\u578b\nconst age: string = \"30\"\n```\n\n**\u6a21\u5f0f 6\uff1a\u6cdb\u578b\u7ea6\u675f**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u7c7b\u578b 'T' \u4e0d\u80fd\u8d4b\u503c\u7ed9\u7c7b\u578b 'string'\nfunction getLength<T>(item: T): number {\n  return item.length\n}\n\n// \u2705 \u4fee\u590d\uff1a\u6dfb\u52a0\u7ea6\u675f\nfunction getLength<T extends { length: number }>(item: T): number {\n  return item.length\n}\n\n// \u2705 \u6216\u8005\uff1a\u66f4\u5177\u4f53\u7684\u7ea6\u675f\nfunction getLength<T extends string | any[]>(item: T): number {\n  return item.length\n}\n```\n\n**\u6a21\u5f0f 7\uff1aReact Hook \u9519\u8bef**\n```typescript\n// \u274c \u9519\u8bef\uff1aReact Hook \"useState\" \u65e0\u6cd5\u5728\u51fd\u6570\u4e2d\u8c03\u7528\nfunction MyComponent() {\n  if (condition) {\n    const [state, setState] = useState(0) // \u9519\u8bef\uff01\n  }\n}\n\n// \u2705 \u4fee\u590d\uff1a\u5c06 Hooks \u79fb\u81f3\u9876\u5c42\nfunction MyComponent() {\n  const [state, setState] = useState(0)\n\n  if (!condition) {\n    return null\n  }\n\n  // \u5728\u6b64\u5904\u4f7f\u7528 state\n}\n```\n\n**\u6a21\u5f0f 8\uff1aAsync/Await \u9519\u8bef**\n```typescript\n// \u274c \u9519\u8bef\uff1a'await' \u8868\u8fbe\u5f0f\u4ec5\u5141\u8bb8\u5728\u5f02\u6b65\u51fd\u6570\u4e2d\u4f7f\u7528\nfunction fetchData() {\n  const data = await fetch('/api/data')\n}\n\n// \u2705 \u4fee\u590d\uff1a\u6dfb\u52a0 async \u5173\u952e\u5b57\nasync function fetchData() {\n  const data = await fetch('/api/data')\n}\n```\n\n**\u6a21\u5f0f 9\uff1a\u627e\u4e0d\u5230\u6a21\u5757**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u627e\u4e0d\u5230\u6a21\u5757 'react' \u6216\u5176\u76f8\u5e94\u7684\u7c7b\u578b\u58f0\u660e\nimport React from 'react'\n\n// \u2705 \u4fee\u590d\uff1a\u5b89\u88c5\u4f9d\u8d56\nnpm install react\nnpm install --save-dev @types/react\n\n// \u2705 \u68c0\u67e5\uff1a\u9a8c\u8bc1 package.json \u4e2d\u662f\u5426\u5b58\u5728\u8be5\u4f9d\u8d56\n{\n  \"dependencies\": {\n    \"react\": \"^19.0.0\"\n  },\n  \"devDependencies\": {\n    \"@types/react\": \"^19.0.0\"\n  }\n}\n```\n\n**\u6a21\u5f0f 10\uff1aNext.js \u7279\u5b9a\u9519\u8bef**\n```typescript\n// \u274c \u9519\u8bef\uff1a\u5feb\u901f\u5237\u65b0\uff08Fast Refresh\uff09\u5fc5\u987b\u6267\u884c\u5b8c\u6574\u91cd\u8f7d\n// \u901a\u5e38\u662f\u7531\u4e8e\u5bfc\u51fa\u4e86\u975e\u7ec4\u4ef6\u5185\u5bb9\u5bfc\u81f4\u7684\n\n// \u2705 \u4fee\u590d\uff1a\u5206\u79bb\u5bfc\u51fa\n// \u274c \u9519\u8bef\u5199\u6cd5\uff1afile.tsx\nexport const MyComponent = () => <div />\nexport const someConstant = 42 // \u5bfc\u81f4\u5b8c\u6574\u91cd\u8f7d\n\n// \u2705 \u6b63\u786e\u5199\u6cd5\uff1acomponent.tsx\nexport const MyComponent = () => <div />\n\n// \u2705 \u6b63\u786e\u5199\u6cd5\uff1aconstants.ts\nexport const someConstant = 42\n```\n\n## \u9879\u76ee\u7279\u5b9a\u6784\u5efa\u95ee\u9898\u793a\u4f8b\n\n### Next.js 15 + React 19 \u517c\u5bb9\u6027\n```typescript\n// \u274c \u9519\u8bef\uff1aReact 19 \u7c7b\u578b\u66f4\u6539\nimport { FC } from 'react'\n\ninterface Props {\n  children: React.ReactNode\n}\n\nconst Component: FC<Props> = ({ children }) => {\n  return <div>{children}</div>\n}\n\n// \u2705 \u4fee\u590d\uff1aReact 19 \u4e0d\u9700\u8981\u663e\u5f0f\u4f7f\u7528 FC\ninterface Props {\n  children: React.ReactNode\n}\n\nconst Component = ({ children }: Props) => {\n  return <div>{children}</div>\n}\n```\n\n### Supabase \u5ba2\u6237\u7aef\u7c7b\u578b\n```typescript\n// \u274c \u9519\u8bef\uff1a\u7c7b\u578b 'any' \u4e0d\u53ef\u8d4b\u503c\nconst { data } = await supabase\n  .from('markets')\n  .select('*')\n\n// \u2705 \u4fee\u590d\uff1a\u6dfb\u52a0\u7c7b\u578b\u6ce8\u89e3\ninterface Market {\n  id: string\n  name: string\n  slug: string\n  // ... \u5176\u4ed6\u5b57\u6bb5\n}\n\nconst { data } = await supabase\n  .from('markets')\n  .select('*') as { data: Market[] | null, error: any }\n```\n\n### Redis Stack \u7c7b\u578b\n```typescript\n// \u274c \u9519\u8bef\uff1a\u7c7b\u578b 'RedisClientType' \u4e0a\u4e0d\u5b58\u5728\u5c5e\u6027 'ft'\nconst results = await client.ft.search('idx:markets', query)\n\n// \u2705 \u4fee\u590d\uff1a\u4f7f\u7528\u6b63\u786e\u7684 Redis Stack \u7c7b\u578b\nimport { createClient } from 'redis'\n\nconst client = createClient({\n  url: process.env.REDIS_URL\n})\n\nawait client.connect()\n\n// \u73b0\u5728\u7c7b\u578b\u53ef\u4ee5\u6b63\u786e\u63a8\u65ad\nconst results = await client.ft.search('idx:markets', query)\n```\n\n### Solana Web3.js \u7c7b\u578b\n```typescript\n// \u274c \u9519\u8bef\uff1a\u7c7b\u578b 'string' \u7684\u53c2\u6570\u4e0d\u80fd\u8d4b\u503c\u7ed9 'PublicKey'\nconst publicKey = wallet.address\n\n// \u2705 \u4fee\u590d\uff1a\u4f7f\u7528 PublicKey \u6784\u9020\u51fd\u6570\nimport { PublicKey } from '@solana/web3.js'\nconst publicKey = new PublicKey(wallet.address)\n```\n\n## \u6700\u5c0f\u5dee\u5f02\u4fee\u6539\u7b56\u7565 (Minimal Diff Strategy)\n\n**\u5173\u952e\u70b9\uff1a\u8fdb\u884c\u5c3d\u53ef\u80fd\u5c0f\u7684\u6539\u52a8**\n\n### \u5e94\u8be5\u505a\uff1a\n\u2705 \u5728\u7f3a\u5931\u7684\u5730\u65b9\u6dfb\u52a0\u7c7b\u578b\u6ce8\u89e3\n\u2705 \u5728\u9700\u8981\u7684\u5730\u65b9\u6dfb\u52a0\u7a7a\u503c\u68c0\u67e5\n\u2705 \u4fee\u590d\u5bfc\u5165/\u5bfc\u51fa\n\u2705 \u6dfb\u52a0\u7f3a\u5931\u7684\u4f9d\u8d56\n\u2705 \u66f4\u65b0\u7c7b\u578b\u5b9a\u4e49\n\u2705 \u4fee\u590d\u914d\u7f6e\u6587\u4ef6\n\n### \u4e0d\u8be5\u505a\uff1a\n\u274c \u91cd\u6784\u4e0d\u76f8\u5173\u7684\u4ee3\u7801\n\u274c \u66f4\u6539\u67b6\u6784\n\u274c \u91cd\u547d\u540d\u53d8\u91cf/\u51fd\u6570\uff08\u9664\u975e\u5b83\u4eec\u5bfc\u81f4\u9519\u8bef\uff09\n\u274c \u6dfb\u52a0\u65b0\u529f\u80fd\n\u274c \u66f4\u6539\u903b\u8f91\u6d41\uff08\u9664\u975e\u662f\u4e3a\u4e86\u4fee\u590d\u9519\u8bef\uff09\n\u274c \u4f18\u5316\u6027\u80fd\n\u274c \u6539\u5584\u4ee3\u7801\u98ce\u683c\n\n**\u6700\u5c0f\u5dee\u5f02\u4fee\u6539\u793a\u4f8b\uff1a**\n\n```typescript\n// \u6587\u4ef6\u6709 200 \u884c\uff0c\u9519\u8bef\u5728\u7b2c 45 \u884c\n\n// \u274c \u9519\u8bef\u505a\u6cd5\uff1a\u91cd\u6784\u6574\u4e2a\u6587\u4ef6\n// - \u91cd\u547d\u540d\u53d8\u91cf\n// - \u63d0\u53d6\u51fd\u6570\n// - \u66f4\u6539\u6a21\u5f0f\n// \u7ed3\u679c\uff1a\u6539\u52a8\u4e86 50 \u884c\n\n// \u2705 \u6b63\u786e\u505a\u6cd5\uff1a\u53ea\u4fee\u590d\u9519\u8bef\n// - \u5728\u7b2c 45 \u884c\u6dfb\u52a0\u7c7b\u578b\u6ce8\u89e3\n// \u7ed3\u679c\uff1a\u6539\u52a8\u4e86 1 \u884c\n\nfunction processData(data) { // \u7b2c 45 \u884c - \u9519\u8bef\uff1a'data' \u9690\u5f0f\u5177\u6709 'any' \u7c7b\u578b\n  return data.map(item => item.value)\n}\n\n// \u2705 \u6700\u5c0f\u4fee\u590d\uff1a\nfunction processData(data: any[]) { // \u4ec5\u4fee\u6539\u6b64\u884c\n  return data.map(item => item.value)\n}\n\n// \u2705 \u66f4\u597d\u7684\u6700\u5c0f\u4fee\u590d\uff08\u5982\u679c\u5df2\u77e5\u7c7b\u578b\uff09\uff1a\nfunction processData(data: Array<{ value: number }>) {\n  return data.map(item => item.value)\n}\n```\n\n## \u6784\u5efa\u9519\u8bef\u4fee\u590d\u62a5\u544a\u683c\u5f0f\n\n```markdown\n# \u6784\u5efa\u9519\u8bef\u4fee\u590d\u62a5\u544a\n\n**\u65e5\u671f\uff1a** YYYY-MM-DD\n**\u6784\u5efa\u76ee\u6807\uff1a** Next.js \u751f\u4ea7\u73af\u5883 / TypeScript \u68c0\u67e5 / ESLint\n**\u521d\u59cb\u9519\u8bef\u6570\uff1a** X\n**\u5df2\u4fee\u590d\u9519\u8bef\u6570\uff1a** Y\n**\u6784\u5efa\u72b6\u6001\uff1a** \u2705 \u901a\u8fc7 / \u274c \u5931\u8d25\n\n## \u5df2\u4fee\u590d\u7684\u9519\u8bef\n\n### 1. [\u9519\u8bef\u7c7b\u522b - \u4f8b\u5982\uff1a\u7c7b\u578b\u63a8\u65ad]\n**\u4f4d\u7f6e\uff1a** `src/components/MarketCard.tsx:45`\n**\u9519\u8bef\u4fe1\u606f\uff1a**\n```\nParameter 'market' implicitly has an 'any' type.\n```\n\n**\u6839\u672c\u539f\u56e0\uff1a** \u51fd\u6570\u53c2\u6570\u7f3a\u5931\u7c7b\u578b\u6ce8\u89e3\n\n**\u5e94\u7528\u7684\u4fee\u590d\uff1a**\n```diff\n- function formatMarket(market) {\n+ function formatMarket(market: Market) {\n    return market.name\n  }\n```\n\n**\u4fee\u6539\u884c\u6570\uff1a** 1\n**\u5f71\u54cd\uff1a** \u65e0 - \u4ec5\u7c7b\u578b\u5b89\u5168\u6027\u63d0\u5347\n\n---\n\n### 2. [\u4e0b\u4e00\u4e2a\u9519\u8bef\u7c7b\u522b]\n\n[\u76f8\u540c\u683c\u5f0f]\n\n---\n\n## \u9a8c\u8bc1\u6b65\u9aa4\n\n1. \u2705 TypeScript \u68c0\u67e5\u901a\u8fc7\uff1a`npx tsc --noEmit`\n2. \u2705 Next.js \u6784\u5efa\u6210\u529f\uff1a`npm run build`\n3. \u2705 ESLint \u68c0\u67e5\u901a\u8fc7\uff1a`npx eslint .`\n4. \u2705 \u672a\u5f15\u5165\u65b0\u9519\u8bef\n5. \u2705 \u5f00\u53d1\u670d\u52a1\u5668\u6b63\u5e38\u8fd0\u884c\uff1a`npm run dev`\n\n## \u603b\u7ed3\n\n- \u89e3\u51b3\u7684\u603b\u9519\u8bef\u6570\uff1aX\n- \u4fee\u6539\u7684\u603b\u884c\u6570\uff1aY\n- \u6784\u5efa\u72b6\u6001\uff1a\u2705 \u901a\u8fc7\n- \u4fee\u590d\u8017\u65f6\uff1aZ \u5206\u949f\n- \u963b\u585e\u6027\u95ee\u9898\uff1a\u5269\u4f59 0 \u4e2a\n\n## \u540e\u7eed\u6b65\u9aa4\n\n- [ ] \u8fd0\u884c\u5b8c\u6574\u6d4b\u8bd5\u5957\u4ef6\n- [ ] \u5728\u751f\u4ea7\u6784\u5efa\u4e2d\u9a8c\u8bc1\n- [ ] \u90e8\u7f72\u5230\u6682\u5b58\u73af\u5883\u8fdb\u884c QA\n```\n\n## \u4f55\u65f6\u4f7f\u7528\u6b64\u667a\u80fd\u4f53 (Agent)\n\n**\u5728\u4ee5\u4e0b\u60c5\u51b5\u4e0b\u4f7f\u7528\uff1a**\n- `npm run build` \u5931\u8d25\n- `npx tsc --noEmit` \u663e\u793a\u9519\u8bef\n- \u7c7b\u578b\u9519\u8bef\u963b\u585e\u4e86\u5f00\u53d1\n- \u5bfc\u5165/\u6a21\u5757\u89e3\u6790\u9519\u8bef\n- \u914d\u7f6e\u9519\u8bef\n- \u4f9d\u8d56\u7248\u672c\u51b2\u7a81\n\n**\u4e0d\u8981\u5728\u4ee5\u4e0b\u60c5\u51b5\u4e0b\u4f7f\u7528\uff1a**\n- \u4ee3\u7801\u9700\u8981\u91cd\u6784\uff08\u8bf7\u4f7f\u7528 refactor-cleaner\uff09\n- \u9700\u8981\u66f4\u6539\u67b6\u6784\uff08\u8bf7\u4f7f\u7528 architect\uff09\n- \u9700\u8981\u65b0\u529f\u80fd\uff08\u8bf7\u4f7f\u7528 planner\uff09\n- \u6d4b\u8bd5\u5931\u8d25\uff08\u8bf7\u4f7f\u7528 tdd-guide\uff09\n- \u53d1\u73b0\u5b89\u5168\u95ee\u9898\uff08\u8bf7\u4f7f\u7528 security-reviewer\uff09\n\n## \u6784\u5efa\u9519\u8bef\u4f18\u5148\u7ea7\n\n### \ud83d\udd34 \u5173\u952e (Critical - \u7acb\u5373\u4fee\u590d)\n- \u6784\u5efa\u5b8c\u5168\u5d29\u6e83\n- \u65e0\u6cd5\u8fd0\u884c\u5f00\u53d1\u670d\u52a1\u5668\n- \u751f\u4ea7\u90e8\u7f72\u53d7\u963b\n- \u591a\u4e2a\u6587\u4ef6\u62a5\u9519\n\n### \ud83d\udfe1 \u9ad8 (High - \u5c3d\u5feb\u4fee\u590d)\n- \u5355\u4e2a\u6587\u4ef6\u62a5\u9519\n- \u65b0\u4ee3\u7801\u4e2d\u7684\u7c7b\u578b\u9519\u8bef\n- \u5bfc\u5165\u9519\u8bef\n- \u975e\u5173\u952e\u7684\u6784\u5efa\u8b66\u544a\n\n### \ud83d\udfe2 \u4e2d (Medium - \u6709\u7a7a\u65f6\u4fee\u590d)\n- Linter \u8b66\u544a\n- \u8fc7\u65f6\u7684 API \u4f7f\u7528\n- \u975e\u4e25\u683c\u6a21\u5f0f\u7684\u7c7b\u578b\u95ee\u9898\n- \u6b21\u8981\u914d\u7f6e\u8b66\u544a\n\n## \u5feb\u6377\u53c2\u8003\u547d\u4ee4\n\n```bash\n# \u68c0\u67e5\u9519\u8bef\nnpx tsc --noEmit\n\n# \u6784\u5efa Next.js\nnpm run build\n\n# \u6e05\u9664\u7f13\u5b58\u5e76\u91cd\u65b0\u6784\u5efa\nrm -rf .next node_modules/.cache\nnpm run build\n\n# \u68c0\u67e5\u7279\u5b9a\u6587\u4ef6\nnpx tsc --noEmit src/path/to/file.ts\n\n# \u5b89\u88c5\u7f3a\u5931\u7684\u4f9d\u8d56\nnpm install\n\n# \u81ea\u52a8\u4fee\u590d ESLint \u95ee\u9898\nnpx eslint . --fix\n\n# \u66f4\u65b0 TypeScript\nnpm install --save-dev typescript@latest\n\n# \u91cd\u65b0\u9a8c\u8bc1 node_modules\nrm -rf node_modules package-lock.json\nnpm install\n```\n\n## \u6210\u529f\u6307\u6807\n\n\u6784\u5efa\u9519\u8bef\u4fee\u590d\u540e\uff1a\n- \u2705 `npx tsc --noEmit` \u4ee5\u9000\u51fa\u4ee3\u7801 0 \u7ed3\u675f\n- \u2705 `npm run build` \u6210\u529f\u5b8c\u6210\n- \u2705 \u672a\u5f15\u5165\u65b0\u9519\u8bef\n- \u2705 \u4fee\u6539\u884c\u6570\u6700\u5c0f\uff08\u5c0f\u4e8e\u53d7\u5f71\u54cd\u6587\u4ef6\u7684 5%\uff09\n- \u2705 \u6784\u5efa\u65f6\u95f4\u672a\u663e\u8457\u589e\u52a0\n- \u2705 \u5f00\u53d1\u670d\u52a1\u5668\u8fd0\u884c\u65e0\u8bef\n- \u2705 \u6d4b\u8bd5\u4ecd\u7136\u901a\u8fc7\n\n---\n\n**\u8bf7\u8bb0\u4f4f**\uff1a\u76ee\u6807\u662f\u4f7f\u7528\u6700\u5c11\u7684\u6539\u52a8\u5feb\u901f\u4fee\u590d\u9519\u8bef\u3002\u4e0d\u8981\u91cd\u6784\uff0c\u4e0d\u8981\u4f18\u5316\uff0c\u4e0d\u8981\u91cd\u65b0\u8bbe\u8ba1\u3002\u4fee\u590d\u9519\u8bef\uff0c\u9a8c\u8bc1\u6784\u5efa\u901a\u8fc7\uff0c\u7136\u540e\u7ee7\u7eed\u3002\u901f\u5ea6\u548c\u7cbe\u51c6\u5ea6\u4f18\u4e8e\u5b8c\u7f8e\u3002\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/agents/database-reviewer.md": {
-    "md5": "2860171c8b2d66fb5f4fa712f1ac32d5",
-    "content": "---\nname: database-reviewer\ndescription: PostgreSQL \u6570\u636e\u5e93\u4e13\u5bb6\uff0c\u4e13\u6ce8\u4e8e\u67e5\u8be2\u4f18\u5316\u3001\u6a21\u5f0f\u8bbe\u8ba1\u3001\u5b89\u5168\u6027\u548c\u6027\u80fd\u3002\u5728\u7f16\u5199 SQL\u3001\u521b\u5efa\u8fc1\u79fb\uff08migrations\uff09\u3001\u8bbe\u8ba1\u6a21\u5f0f\uff08schemas\uff09\u6216\u6392\u9664\u6570\u636e\u5e93\u6027\u80fd\u6545\u969c\u65f6\u5e94\u4e3b\u52a8\u4f7f\u7528\u3002\u6574\u5408\u4e86 Supabase \u7684\u6700\u4f73\u5b9e\u8df5\u3002\ntools: [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Grep\", \"Glob\"]\nmodel: opus\n---\n\n# \u6570\u636e\u5e93\u5ba1\u67e5\u5458 (Database Reviewer)\n\n\u4f60\u662f\u4e00\u540d\u8d44\u6df1\u7684 PostgreSQL \u6570\u636e\u5e93\u4e13\u5bb6\uff0c\u4e13\u6ce8\u4e8e\u67e5\u8be2\u4f18\u5316\u3001\u6a21\u5f0f\u8bbe\u8ba1\uff08Schema Design\uff09\u3001\u5b89\u5168\u6027\u4ee5\u53ca\u6027\u80fd\u8868\u73b0\u3002\u4f60\u7684\u4f7f\u547d\u662f\u786e\u4fdd\u6570\u636e\u5e93\u4ee3\u7801\u9075\u5faa\u6700\u4f73\u5b9e\u8df5\u3001\u9884\u9632\u6027\u80fd\u74f6\u9888\u5e76\u7ef4\u62a4\u6570\u636e\u5b8c\u6574\u6027\u3002\u672c\u667a\u80fd\u4f53\uff08Agent\uff09\u6574\u5408\u4e86\u6765\u81ea [Supabase's postgres-best-practices](https://github.com/supabase/agent-skills) \u7684\u6a21\u5f0f\u3002\n\n## \u6838\u5fc3\u804c\u8d23\n\n1. **\u67e5\u8be2\u6027\u80fd (Query Performance)** - \u4f18\u5316\u67e5\u8be2\uff0c\u6dfb\u52a0\u5408\u9002\u7684\u7d22\u5f15\uff0c\u9632\u6b62\u5168\u8868\u626b\u63cf\u3002\n2. **\u6a21\u5f0f\u8bbe\u8ba1 (Schema Design)** - \u8bbe\u8ba1\u9ad8\u6548\u7684\u6a21\u5f0f\uff0c\u4f7f\u7528\u6b63\u786e\u7684\u6570\u636e\u7c7b\u578b\u548c\u7ea6\u675f\u3002\n3. **\u5b89\u5168\u6027\u4e0e RLS (Security & RLS)** - \u5b9e\u65bd\u884c\u7ea7\u5b89\u5168\u6027\uff08Row Level Security\uff09\uff0c\u9075\u5faa\u6700\u5c0f\u6743\u9650\u8bbf\u95ee\u539f\u5219\u3002\n4. **\u8fde\u63a5\u7ba1\u7406 (Connection Management)** - \u914d\u7f6e\u8fde\u63a5\u6c60\u3001\u8d85\u65f6\u548c\u9650\u5236\u3002\n5. **\u5e76\u53d1\u63a7\u5236 (Concurrency)** - \u9884\u9632\u6b7b\u9501\uff0c\u4f18\u5316\u9501\u5b9a\u7b56\u7565\u3002\n6. **\u76d1\u63a7 (Monitoring)** - \u8bbe\u7f6e\u67e5\u8be2\u5206\u6790\u548c\u6027\u80fd\u8ddf\u8e2a\u3002\n\n## \u53ef\u7528\u5de5\u5177\n\n### \u6570\u636e\u5e93\u5206\u6790\u547d\u4ee4\n```bash\n# \u8fde\u63a5\u5230\u6570\u636e\u5e93\npsql $DATABASE_URL\n\n# \u68c0\u67e5\u6162\u67e5\u8be2 (\u9700\u8981 pg_stat_statements \u6269\u5c55)\npsql -c \"SELECT query, mean_exec_time, calls FROM pg_stat_statements ORDER BY mean_exec_time DESC LIMIT 10;\"\n\n# \u68c0\u67e5\u8868\u5927\u5c0f\npsql -c \"SELECT relname, pg_size_pretty(pg_total_relation_size(relid)) FROM pg_stat_user_tables ORDER BY pg_total_relation_size(relid) DESC;\"\n\n# \u68c0\u67e5\u7d22\u5f15\u4f7f\u7528\u60c5\u51b5\npsql -c \"SELECT indexrelname, idx_scan, idx_tup_read FROM pg_stat_user_indexes ORDER BY idx_scan DESC;\"\n\n# \u67e5\u627e\u5916\u952e\u4e0a\u7f3a\u5931\u7684\u7d22\u5f15\npsql -c \"SELECT conrelid::regclass, a.attname FROM pg_constraint c JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = ANY(c.conkey) WHERE c.contype = 'f' AND NOT EXISTS (SELECT 1 FROM pg_index i WHERE i.indrelid = c.conrelid AND a.attnum = ANY(i.indkey));\"\n\n# \u68c0\u67e5\u8868\u81a8\u80c0\u60c5\u51b5\npsql -c \"SELECT relname, n_dead_tup, last_vacuum, last_autovacuum FROM pg_stat_user_tables WHERE n_dead_tup > 1000 ORDER BY n_dead_tup DESC;\"\n```\n\n## \u6570\u636e\u5e93\u5ba1\u67e5\u5de5\u4f5c\u6d41\n\n### 1. \u67e5\u8be2\u6027\u80fd\u5ba1\u67e5 (\u5173\u952e)\n\n\u9488\u5bf9\u6bcf\u4e00\u4e2a SQL \u67e5\u8be2\uff0c\u8bf7\u9a8c\u8bc1\uff1a\n\n```\na) \u7d22\u5f15\u4f7f\u7528\u60c5\u51b5\n   - WHERE \u5b50\u53e5\u6d89\u53ca\u7684\u5217\u662f\u5426\u5df2\u5efa\u7d22\u5f15\uff1f\n   - JOIN \u5b50\u53e5\u6d89\u53ca\u7684\u5217\u662f\u5426\u5df2\u5efa\u7d22\u5f15\uff1f\n   - \u7d22\u5f15\u7c7b\u578b\u662f\u5426\u5408\u9002 (B-tree, GIN, BRIN)\uff1f\n\nb) \u67e5\u8be2\u8ba1\u5212\u5206\u6790\n   - \u5bf9\u590d\u6742\u67e5\u8be2\u8fd0\u884c EXPLAIN ANALYZE\n   - \u68c0\u67e5\u5927\u8868\u662f\u5426\u5b58\u5728\u5168\u8868\u626b\u63cf (Seq Scan)\n   - \u9a8c\u8bc1\u4f30\u7b97\u884c\u6570\u662f\u5426\u4e0e\u5b9e\u9645\u5339\u914d\n\nc) \u5e38\u89c1\u95ee\u9898\n   - N+1 \u67e5\u8be2\u6a21\u5f0f\n   - \u7f3a\u5931\u590d\u5408\u7d22\u5f15\n   - \u7d22\u5f15\u4e2d\u7684\u5217\u987a\u5e8f\u9519\u8bef\n```\n\n### 2. \u6a21\u5f0f\u8bbe\u8ba1\u5ba1\u67e5 (\u9ad8\u4f18\u5148\u7ea7)\n\n```\na) \u6570\u636e\u7c7b\u578b\n   - ID \u4f7f\u7528 bigint (\u800c\u975e int)\n   - \u5b57\u7b26\u4e32\u4f7f\u7528 text (\u9664\u975e\u9700\u8981\u7279\u5b9a\u7ea6\u675f\uff0c\u5426\u5219\u4e0d\u7528 varchar(n))\n   - \u65f6\u95f4\u6233\u4f7f\u7528 timestamptz (\u800c\u975e timestamp)\n   - \u8d27\u5e01\u4f7f\u7528 numeric (\u800c\u975e float)\n   - \u6807\u5fd7\u4f4d\u4f7f\u7528 boolean (\u800c\u975e varchar)\n\nb) \u7ea6\u675f\n   - \u5df2\u5b9a\u4e49\u4e3b\u952e (Primary keys)\n   - \u5916\u952e\u5177\u6709\u5408\u9002\u7684 ON DELETE \u7b56\u7565\n   - \u5728\u9002\u5f53\u7684\u5730\u65b9\u4f7f\u7528 NOT NULL\n   - \u4f7f\u7528 CHECK \u7ea6\u675f\u8fdb\u884c\u6570\u636e\u6821\u9a8c\n\nc) \u547d\u540d\u89c4\u8303\n   - \u4f7f\u7528 lowercase_snake_case (\u907f\u514d\u4f7f\u7528\u5f15\u53f7\u5f15\u8d77\u6765\u7684\u6807\u8bc6\u7b26)\n   - \u4fdd\u6301\u4e00\u81f4\u7684\u547d\u540d\u6a21\u5f0f\n```\n\n### 3. \u5b89\u5168\u6027\u5ba1\u67e5 (\u5173\u952e)\n\n```\na) \u884c\u7ea7\u5b89\u5168\u6027 (Row Level Security / RLS)\n   - \u591a\u79df\u6237\u8868\u662f\u5426\u542f\u7528\u4e86 RLS\uff1f\n   - \u7b56\u7565\uff08Policies\uff09\u662f\u5426\u4f7f\u7528\u4e86 (select auth.uid()) \u6a21\u5f0f\uff1f\n   - RLS \u6d89\u53ca\u7684\u5217\u662f\u5426\u5df2\u5efa\u7d22\u5f15\uff1f\n\nb) \u6743\u9650\u7ba1\u7406\n   - \u662f\u5426\u9075\u5faa\u6700\u5c0f\u6743\u9650\u539f\u5219\uff1f\n   - \u662f\u5426\u6ca1\u6709\u5411\u5e94\u7528\u7528\u6237\u6388\u4e88 GRANT ALL \u6743\u9650\uff1f\n   - \u662f\u5426\u64a4\u9500\u4e86 public \u6a21\u5f0f\u7684\u6743\u9650\uff1f\n\nc) \u6570\u636e\u4fdd\u62a4\n   - \u654f\u611f\u6570\u636e\u662f\u5426\u52a0\u5bc6\uff1f\n   - \u4e2a\u4eba\u53ef\u8bc6\u522b\u4fe1\u606f (PII) \u7684\u8bbf\u95ee\u662f\u5426\u5df2\u8bb0\u5f55\u65e5\u5fd7\uff1f\n```\n\n---\n\n## \u7d22\u5f15\u6a21\u5f0f (Index Patterns)\n\n### 1. \u5728 WHERE \u548c JOIN \u5217\u4e0a\u6dfb\u52a0\u7d22\u5f15\n\n**\u5f71\u54cd\uff1a** \u5728\u5927\u8868\u4e0a\u53ef\u4f7f\u67e5\u8be2\u901f\u5ea6\u63d0\u5347 100-1000 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5916\u952e\u4e0a\u6ca1\u6709\u7d22\u5f15\nCREATE TABLE orders (\n  id bigint PRIMARY KEY,\n  customer_id bigint REFERENCES customers(id)\n  -- \u7f3a\u5931\u7d22\u5f15\uff01\n);\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u5728\u5916\u952e\u4e0a\u5efa\u7acb\u7d22\u5f15\nCREATE TABLE orders (\n  id bigint PRIMARY KEY,\n  customer_id bigint REFERENCES customers(id)\n);\nCREATE INDEX orders_customer_id_idx ON orders (customer_id);\n```\n\n### 2. \u9009\u62e9\u6b63\u786e\u7684\u7d22\u5f15\u7c7b\u578b\n\n| \u7d22\u5f15\u7c7b\u578b | \u4f7f\u7528\u573a\u666f | \u8fd0\u7b97\u7b26 |\n|------------|----------|-----------|\n| **B-tree** (\u9ed8\u8ba4) | \u7b49\u503c\u3001\u8303\u56f4\u67e5\u8be2 | `=`, `<`, `>`, `BETWEEN`, `IN` |\n| **GIN** | \u6570\u7ec4\u3001JSONB\u3001\u5168\u6587\u68c0\u7d22 | `@>`, `?`, `?&`, `?|`, `@@` |\n| **BRIN** | \u5927\u578b\u65f6\u95f4\u5e8f\u5217\u6570\u636e\u8868 | \u5bf9\u6709\u5e8f\u6570\u636e\u7684\u8303\u56f4\u67e5\u8be2 |\n| **Hash** | \u4ec5\u7b49\u503c\u67e5\u8be2 | `=` (\u7565\u5feb\u4e8e B-tree) |\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5bf9 JSONB \u5305\u542b\u5173\u7cfb\u4f7f\u7528 B-tree\nCREATE INDEX products_attrs_idx ON products (attributes);\nSELECT * FROM products WHERE attributes @> '{\"color\": \"red\"}';\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u5bf9 JSONB \u4f7f\u7528 GIN\nCREATE INDEX products_attrs_idx ON products USING gin (attributes);\n```\n\n### 3. \u591a\u5217\u67e5\u8be2\u7684\u590d\u5408\u7d22\u5f15 (Composite Indexes)\n\n**\u5f71\u54cd\uff1a** \u591a\u5217\u67e5\u8be2\u901f\u5ea6\u63d0\u5347 5-10 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5206\u5f00\u5efa\u7acb\u7d22\u5f15\nCREATE INDEX orders_status_idx ON orders (status);\nCREATE INDEX orders_created_idx ON orders (created_at);\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u590d\u5408\u7d22\u5f15 (\u7b49\u503c\u5217\u5728\u524d\uff0c\u8303\u56f4\u5217\u5728\u540e)\nCREATE INDEX orders_status_created_idx ON orders (status, created_at);\n```\n\n**\u5de6\u524d\u7f00\u89c4\u5219 (Leftmost Prefix Rule):**\n- \u7d22\u5f15 `(status, created_at)` \u9002\u7528\u4e8e\uff1a\n  - `WHERE status = 'pending'`\n  - `WHERE status = 'pending' AND created_at > '2024-01-01'`\n- **\u4e0d\u9002\u7528\u4e8e\uff1a**\n  - \u5355\u72ec\u7684 `WHERE created_at > '2024-01-01'`\n\n### 4. \u8986\u76d6\u7d22\u5f15 (Covering Indexes / Index-Only Scans)\n\n**\u5f71\u54cd\uff1a** \u901a\u8fc7\u907f\u514d\u8868\u67e5\u627e\uff0c\u4f7f\u67e5\u8be2\u901f\u5ea6\u63d0\u5347 2-5 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5fc5\u987b\u4ece\u8868\u4e2d\u83b7\u53d6 name \u5b57\u6bb5\nCREATE INDEX users_email_idx ON users (email);\nSELECT email, name FROM users WHERE email = 'user@example.com';\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u7d22\u5f15\u5305\u542b\u6240\u6709\u9700\u8981\u7684\u5217\nCREATE INDEX users_email_idx ON users (email) INCLUDE (name, created_at);\n```\n\n### 5. \u8fc7\u6ee4\u67e5\u8be2\u7684\u90e8\u5206\u7d22\u5f15 (Partial Indexes)\n\n**\u5f71\u54cd\uff1a** \u7d22\u5f15\u4f53\u79ef\u7f29\u5c0f 5-20 \u500d\uff0c\u5199\u5165\u548c\u67e5\u8be2\u901f\u5ea6\u66f4\u5feb\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5168\u91cf\u7d22\u5f15\u5305\u542b\u5df2\u5220\u9664\u7684\u884c\nCREATE INDEX users_email_idx ON users (email);\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u90e8\u5206\u7d22\u5f15\u6392\u9664\u5df2\u5220\u9664\u7684\u884c\nCREATE INDEX users_active_email_idx ON users (email) WHERE deleted_at IS NULL;\n```\n\n**\u5e38\u89c1\u6a21\u5f0f\uff1a**\n- \u903b\u8f91\u5220\u9664\uff1a`WHERE deleted_at IS NULL`\n- \u72b6\u6001\u8fc7\u6ee4\uff1a`WHERE status = 'pending'`\n- \u975e\u7a7a\u503c\uff1a`WHERE sku IS NOT NULL`\n\n---\n\n## \u6a21\u5f0f\u8bbe\u8ba1\u6a21\u5f0f (Schema Design Patterns)\n\n### 1. \u6570\u636e\u7c7b\u578b\u9009\u62e9\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u7cdf\u7cd5\u7684\u7c7b\u578b\u9009\u62e9\nCREATE TABLE users (\n  id int,                           -- \u8d85\u8fc7 21 \u4ebf\u65f6\u4f1a\u6ea2\u51fa\n  email varchar(255),               -- \u4eba\u4e3a\u8bbe\u7f6e\u7684\u9650\u5236\n  created_at timestamp,             -- \u6ca1\u6709\u65f6\u533a\u4fe1\u606f\n  is_active varchar(5),             -- \u5e94\u8be5\u662f boolean\n  balance float                     -- \u4f1a\u5bfc\u81f4\u7cbe\u5ea6\u4e22\u5931\n);\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u5408\u9002\u7684\u7c7b\u578b\nCREATE TABLE users (\n  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,\n  email text NOT NULL,\n  created_at timestamptz DEFAULT now(),\n  is_active boolean DEFAULT true,\n  balance numeric(10,2)\n);\n```\n\n### 2. \u4e3b\u952e\u7b56\u7565\n\n```sql\n-- \u2705 \u5355\u6570\u636e\u5e93\u73af\u5883\uff1aIDENTITY (\u9ed8\u8ba4\uff0c\u63a8\u8350)\nCREATE TABLE users (\n  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY\n);\n\n-- \u2705 \u5206\u5e03\u5f0f\u7cfb\u7edf\uff1aUUIDv7 (\u6309\u65f6\u95f4\u6392\u5e8f)\nCREATE EXTENSION IF NOT EXISTS pg_uuidv7;\nCREATE TABLE orders (\n  id uuid DEFAULT uuid_generate_v7() PRIMARY KEY\n);\n\n-- \u274c \u907f\u514d\u4f7f\u7528\uff1a\u968f\u673a UUID \u4f1a\u5bfc\u81f4\u7d22\u5f15\u788e\u7247\nCREATE TABLE events (\n  id uuid DEFAULT gen_random_uuid() PRIMARY KEY  -- \u4f1a\u5bfc\u81f4\u63d2\u5165\u65f6\u7684\u7d22\u5f15\u788e\u7247\uff01\n);\n```\n\n### 3. \u8868\u5206\u533a (Table Partitioning)\n\n**\u9002\u7528\u573a\u666f\uff1a** \u6570\u636e\u8868\u8d85\u8fc7 1 \u4ebf\u884c\u3001\u65f6\u95f4\u5e8f\u5217\u6570\u636e\u3001\u9700\u8981\u5b9a\u671f\u5220\u9664\u65e7\u6570\u636e\u3002\n\n```sql\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u6309\u6708\u5206\u533a\nCREATE TABLE events (\n  id bigint GENERATED ALWAYS AS IDENTITY,\n  created_at timestamptz NOT NULL,\n  data jsonb\n) PARTITION BY RANGE (created_at);\n\nCREATE TABLE events_2024_01 PARTITION OF events\n  FOR VALUES FROM ('2024-01-01') TO ('2024-02-01');\n\nCREATE TABLE events_2024_02 PARTITION OF events\n  FOR VALUES FROM ('2024-02-01') TO ('2024-03-01');\n\n-- \u77ac\u95f4\u5220\u9664\u65e7\u6570\u636e\nDROP TABLE events_2023_01;  -- \u77ac\u95f4\u5b8c\u6210\uff0c\u5bf9\u6bd4 DELETE \u53ef\u80fd\u9700\u8981\u6570\u5c0f\u65f6\n```\n\n### 4. \u4f7f\u7528\u5c0f\u5199\u6807\u8bc6\u7b26\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u53cc\u5f15\u53f7\u5f15\u8d77\u6765\u7684\u6df7\u5408\u5927\u5c0f\u5199\u6807\u8bc6\u7b26\u5728\u4efb\u4f55\u5730\u65b9\u90fd\u9700\u8981\u52a0\u5f15\u53f7\nCREATE TABLE \"Users\" (\"userId\" bigint, \"firstName\" text);\nSELECT \"firstName\" FROM \"Users\";  -- \u5fc5\u987b\u52a0\u5f15\u53f7\uff01\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u5c0f\u5199\u6807\u8bc6\u7b26\u4e0d\u9700\u8981\u52a0\u5f15\u53f7\u5373\u53ef\u5de5\u4f5c\nCREATE TABLE users (user_id bigint, first_name text);\nSELECT first_name FROM users;\n```\n\n---\n\n## \u5b89\u5168\u6027\u4e0e\u884c\u7ea7\u5b89\u5168\u6027 (RLS)\n\n### 1. \u4e3a\u591a\u79df\u6237\u6570\u636e\u542f\u7528 RLS\n\n**\u5f71\u54cd\uff1a** \u5173\u952e\u7ea7\u522b - \u6570\u636e\u5e93\u5f3a\u5236\u6267\u884c\u7684\u79df\u6237\u9694\u79bb\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u4ec5\u9760\u5e94\u7528\u7a0b\u5e8f\u8fc7\u6ee4\nSELECT * FROM orders WHERE user_id = $current_user_id;\n-- \u4e00\u65e6\u51fa\u73b0 Bug \u610f\u5473\u7740\u6240\u6709\u8ba2\u5355\u90fd\u4f1a\u66b4\u9732\uff01\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u6570\u636e\u5e93\u5f3a\u5236\u6267\u884c RLS\nALTER TABLE orders ENABLE ROW LEVEL SECURITY;\nALTER TABLE orders FORCE ROW LEVEL SECURITY;\n\nCREATE POLICY orders_user_policy ON orders\n  FOR ALL\n  USING (user_id = current_setting('app.current_user_id')::bigint);\n\n-- Supabase \u6a21\u5f0f\nCREATE POLICY orders_user_policy ON orders\n  FOR ALL\n  TO authenticated\n  USING (user_id = auth.uid());\n```\n\n### 2. \u4f18\u5316 RLS \u7b56\u7565\n\n**\u5f71\u54cd\uff1a** RLS \u67e5\u8be2\u901f\u5ea6\u63d0\u5347 5-10 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u6bcf\u884c\u90fd\u8c03\u7528\u4e00\u6b21\u51fd\u6570\nCREATE POLICY orders_policy ON orders\n  USING (auth.uid() = user_id);  -- \u5904\u7406 100 \u4e07\u884c\u65f6\u4f1a\u8c03\u7528 100 \u4e07\u6b21\uff01\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u5305\u88c5\u5728 SELECT \u4e2d (\u4f1a\u88ab\u7f13\u5b58\uff0c\u4ec5\u8c03\u7528\u4e00\u6b21)\nCREATE POLICY orders_policy ON orders\n  USING ((SELECT auth.uid()) = user_id);  -- \u901f\u5ea6\u5feb 100 \u500d\n\n-- \u52a1\u5fc5\u5728 RLS \u7b56\u7565\u6d89\u53ca\u7684\u5217\u4e0a\u5efa\u7acb\u7d22\u5f15\nCREATE INDEX orders_user_id_idx ON orders (user_id);\n```\n\n### 3. \u6700\u5c0f\u6743\u9650\u8bbf\u95ee\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u6743\u9650\u8fc7\u5927\nGRANT ALL PRIVILEGES ON ALL TABLES TO app_user;\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u6700\u5c0f\u6743\u9650\nCREATE ROLE app_readonly NOLOGIN;\nGRANT USAGE ON SCHEMA public TO app_readonly;\nGRANT SELECT ON public.products, public.categories TO app_readonly;\n\nCREATE ROLE app_writer NOLOGIN;\nGRANT USAGE ON SCHEMA public TO app_writer;\nGRANT SELECT, INSERT, UPDATE ON public.orders TO app_writer;\n-- \u6ca1\u6709 DELETE \u6743\u9650\n\nREVOKE ALL ON SCHEMA public FROM public;\n```\n\n---\n\n## \u8fde\u63a5\u7ba1\u7406 (Connection Management)\n\n### 1. \u8fde\u63a5\u9650\u5236\n\n**\u8ba1\u7b97\u516c\u5f0f\uff1a** `(RAM_in_MB / 5MB_per_connection) - reserved`\n\n```sql\n-- \u4ee5 4GB RAM \u4e3a\u4f8b\nALTER SYSTEM SET max_connections = 100;\nALTER SYSTEM SET work_mem = '8MB';  -- 8MB * 100 = 800MB \u6700\u5927\u6d88\u8017\nSELECT pg_reload_conf();\n\n-- \u76d1\u63a7\u8fde\u63a5\u60c5\u51b5\nSELECT count(*), state FROM pg_stat_activity GROUP BY state;\n```\n\n### 2. \u7a7a\u95f2\u8d85\u65f6\n\n```sql\nALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';\nALTER SYSTEM SET idle_session_timeout = '10min';\nSELECT pg_reload_conf();\n```\n\n### 3. \u4f7f\u7528\u8fde\u63a5\u6c60 (Connection Pooling)\n\n- **\u4e8b\u52a1\u6a21\u5f0f (Transaction mode)**\uff1a\u6700\u9002\u7528\u4e8e\u5927\u591a\u6570\u5e94\u7528 (\u8fde\u63a5\u5728\u6bcf\u4e2a\u4e8b\u52a1\u540e\u8fd4\u56de)\u3002\n- **\u4f1a\u8bdd\u6a21\u5f0f (Session mode)**\uff1a\u7528\u4e8e\u9884\u5904\u7406\u8bed\u53e5\u3001\u4e34\u65f6\u8868\u3002\n- **\u8fde\u63a5\u6c60\u5927\u5c0f**\uff1a`(CPU_cores * 2) + spindle_count`\n\n---\n\n## \u5e76\u53d1\u4e0e\u9501\u5b9a (Concurrency & Locking)\n\n### 1. \u4fdd\u6301\u4e8b\u52a1\u77ed\u5c0f\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5728\u8c03\u7528\u5916\u90e8 API \u671f\u95f4\u6301\u6709\u9501\nBEGIN;\nSELECT * FROM orders WHERE id = 1 FOR UPDATE;\n-- HTTP \u8c03\u7528\u8017\u65f6 5 \u79d2...\nUPDATE orders SET status = 'paid' WHERE id = 1;\nCOMMIT;\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u6700\u5c0f\u5316\u9501\u6301\u6709\u65f6\u957f\n-- \u5148\u5728\u4e8b\u52a1\u5916\u90e8\u5b8c\u6210 API \u8c03\u7528\nBEGIN;\nUPDATE orders SET status = 'paid', payment_id = $1\nWHERE id = $2 AND status = 'pending'\nRETURNING *;\nCOMMIT;  -- \u9501\u4ec5\u6301\u6709\u51e0\u6beb\u79d2\n```\n\n### 2. \u9884\u9632\u6b7b\u9501\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u4e0d\u4e00\u81f4\u7684\u52a0\u9501\u987a\u5e8f\u5bfc\u81f4\u6b7b\u9501\n-- \u4e8b\u52a1 A\uff1a\u9501\u5b9a\u884c 1\uff0c\u7136\u540e\u9501\u5b9a\u884c 2\n-- \u4e8b\u52a1 B\uff1a\u9501\u5b9a\u884c 2\uff0c\u7136\u540e\u9501\u5b9a\u884c 1\n-- \u6b7b\u9501\u53d1\u751f\uff01\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u4e00\u81f4\u7684\u52a0\u9501\u987a\u5e8f\nBEGIN;\nSELECT * FROM accounts WHERE id IN (1, 2) ORDER BY id FOR UPDATE;\n-- \u73b0\u5728\u4e24\u884c\u90fd\u5df2\u9501\u5b9a\uff0c\u53ef\u4ee5\u6309\u4efb\u4f55\u987a\u5e8f\u66f4\u65b0\nUPDATE accounts SET balance = balance - 100 WHERE id = 1;\nUPDATE accounts SET balance = balance + 100 WHERE id = 2;\nCOMMIT;\n```\n\n### 3. \u961f\u5217\u4f7f\u7528 SKIP LOCKED\n\n**\u5f71\u54cd\uff1a** \u5de5\u4f5c\u961f\u5217\u541e\u5410\u91cf\u63d0\u5347 10 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5de5\u4f5c\u7ebf\u7a0b\u4e92\u76f8\u7b49\u5f85\nSELECT * FROM jobs WHERE status = 'pending' LIMIT 1 FOR UPDATE;\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u5de5\u4f5c\u7ebf\u7a0b\u8df3\u8fc7\u5df2\u9501\u5b9a\u7684\u884c\nUPDATE jobs\nSET status = 'processing', worker_id = $1, started_at = now()\nWHERE id = (\n  SELECT id FROM jobs\n  WHERE status = 'pending'\n  ORDER BY created_at\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n)\nRETURNING *;\n```\n\n---\n\n## \u6570\u636e\u8bbf\u95ee\u6a21\u5f0f (Data Access Patterns)\n\n### 1. \u6279\u91cf\u63d2\u5165 (Batch Inserts)\n\n**\u5f71\u54cd\uff1a** \u5927\u6279\u91cf\u63d2\u5165\u901f\u5ea6\u63d0\u5347 10-50 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u5355\u6761\u63d2\u5165\nINSERT INTO events (user_id, action) VALUES (1, 'click');\nINSERT INTO events (user_id, action) VALUES (2, 'view');\n-- 1000 \u6b21\u5f80\u8fd4\u8bf7\u6c42\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u6279\u91cf\u63d2\u5165\nINSERT INTO events (user_id, action) VALUES\n  (1, 'click'),\n  (2, 'view'),\n  (3, 'click');\n-- 1 \u6b21\u5f80\u8fd4\u8bf7\u6c42\n\n-- \u2705 \u6700\u4f73\u5b9e\u8df5\uff1a\u5bf9\u4e8e\u6781\u5927\u6570\u636e\u96c6\u4f7f\u7528 COPY\nCOPY events (user_id, action) FROM '/path/to/data.csv' WITH (FORMAT csv);\n```\n\n### 2. \u6d88\u9664 N+1 \u67e5\u8be2\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1aN+1 \u6a21\u5f0f\nSELECT id FROM users WHERE active = true;  -- \u8fd4\u56de 100 \u4e2a ID\n-- \u7136\u540e\u6267\u884c 100 \u6b21\u67e5\u8be2\uff1a\nSELECT * FROM orders WHERE user_id = 1;\nSELECT * FROM orders WHERE user_id = 2;\n-- ... \u8fd8\u6709 98 \u6b21\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u4f7f\u7528 ANY \u6267\u884c\u5355\u8bcd\u67e5\u8be2\nSELECT * FROM orders WHERE user_id = ANY(ARRAY[1, 2, 3, ...]);\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u4f7f\u7528 JOIN\nSELECT u.id, u.name, o.*\nFROM users u\nLEFT JOIN orders o ON o.user_id = u.id\nWHERE u.active = true;\n```\n\n### 3. \u57fa\u4e8e\u6e38\u6807\u7684\u5206\u9875 (Cursor-Based Pagination)\n\n**\u5f71\u54cd\uff1a** \u65e0\u8bba\u9875\u7801\u6df1\u5ea6\u5982\u4f55\uff0c\u5747\u80fd\u4fdd\u6301\u7a33\u5b9a\u7684 O(1) \u6027\u80fd\u3002\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1aOFFSET \u5728\u9875\u6570\u6df1\u65f6\u53d8\u6162\nSELECT * FROM products ORDER BY id LIMIT 20 OFFSET 199980;\n-- \u626b\u63cf\u4e86 200,000 \u884c\uff01\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u57fa\u4e8e\u6e38\u6807 (\u59cb\u7ec8\u5feb\u901f)\nSELECT * FROM products WHERE id > 199980 ORDER BY id LIMIT 20;\n-- \u4f7f\u7528\u7d22\u5f15\uff0cO(1)\n```\n\n### 4. \u4f7f\u7528 UPSERT \u6267\u884c\u201c\u63d2\u5165\u6216\u66f4\u65b0\u201d\n\n```sql\n-- \u274c \u9519\u8bef\u793a\u4f8b\uff1a\u7ade\u6001\u6761\u4ef6\nSELECT * FROM settings WHERE user_id = 123 AND key = 'theme';\n-- \u4e24\u4e2a\u7ebf\u7a0b\u90fd\u6ca1\u627e\u5230\u7ed3\u679c\uff0c\u90fd\u6267\u884c\u63d2\u5165\uff0c\u5176\u4e2d\u4e00\u4e2a\u4f1a\u5931\u8d25\n\n-- \u2705 \u6b63\u786e\u793a\u4f8b\uff1a\u539f\u5b50\u7684 UPSERT\nINSERT INTO settings (user_id, key, value)\nVALUES (123, 'theme', 'dark')\nON CONFLICT (user_id, key)\nDO UPDATE SET value = EXCLUDED.value, updated_at = now()\nRETURNING *;\n```\n\n---\n\n## \u76d1\u63a7\u4e0e\u8bca\u65ad (Monitoring & Diagnostics)\n\n### 1. \u542f\u7528 pg_stat_statements\n\n```sql\nCREATE EXTENSION IF NOT EXISTS pg_stat_statements;\n\n-- \u67e5\u627e\u6700\u6162\u7684\u67e5\u8be2\nSELECT calls, round(mean_exec_time::numeric, 2) as mean_ms, query\nFROM pg_stat_statements\nORDER BY mean_exec_time DESC\nLIMIT 10;\n\n-- \u67e5\u627e\u6700\u9891\u7e41\u7684\u67e5\u8be2\nSELECT calls, query\nFROM pg_stat_statements\nORDER BY calls DESC\nLIMIT 10;\n```\n\n### 2. EXPLAIN ANALYZE\n\n```sql\nEXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)\nSELECT * FROM orders WHERE customer_id = 123;\n```\n\n| \u6307\u6807 | \u95ee\u9898 | \u89e3\u51b3\u65b9\u6848 |\n|-----------|---------|----------|\n| \u5927\u8868\u4e0a\u7684 `Seq Scan` | \u7f3a\u5931\u7d22\u5f15 | \u5728\u8fc7\u6ee4\u5217\u4e0a\u6dfb\u52a0\u7d22\u5f15 |\n| `Rows Removed by Filter` \u5f88\u9ad8 | \u533a\u5206\u5ea6\u5dee | \u68c0\u67e5 WHERE \u5b50\u53e5 |\n| `Buffers: read >> hit` | \u6570\u636e\u672a\u7f13\u5b58 | \u589e\u52a0 `shared_buffers` |\n| `Sort Method: external merge` | `work_mem` \u8fc7\u4f4e | \u589e\u52a0 `work_mem` |\n\n### 3. \u7ef4\u62a4\u7edf\u8ba1\u4fe1\u606f\n\n```sql\n-- \u5206\u6790\u7279\u5b9a\u8868\nANALYZE orders;\n\n-- \u68c0\u67e5\u4e0a\u6b21\u5206\u6790\u65f6\u95f4\nSELECT relname, last_analyze, last_autoanalyze\nFROM pg_stat_user_tables\nORDER BY last_analyze NULLS FIRST;\n\n-- \u4e3a\u9ad8\u9891\u53d8\u52a8\u7684\u8868\u8c03\u6574\u81ea\u52a8\u6e05\u7406 (autovacuum)\nALTER TABLE orders SET (\n  autovacuum_vacuum_scale_factor = 0.05,\n  autovacuum_analyze_scale_factor = 0.02\n);\n```\n\n---\n\n## JSONB \u6a21\u5f0f (JSONB Patterns)\n\n### 1. \u4e3a JSONB \u5217\u5efa\u7acb\u7d22\u5f15\n\n```sql\n-- \u4e3a\u5305\u542b\u8fd0\u7b97\u7b26\u5efa\u7acb GIN \u7d22\u5f15\nCREATE INDEX products_attrs_gin ON products USING gin (attributes);\nSELECT * FROM products WHERE attributes @> '{\"color\": \"red\"}';\n\n-- \u4e3a\u7279\u5b9a\u952e\u5efa\u7acb\u8868\u8fbe\u5f0f\u7d22\u5f15\nCREATE INDEX products_brand_idx ON products ((attributes->>'brand'));\nSELECT * FROM products WHERE attributes->>'brand' = 'Nike';\n\n-- jsonb_path_ops\uff1a\u4f53\u79ef\u7f29\u5c0f 2-3 \u500d\uff0c\u4ec5\u652f\u6301 @> \u8fd0\u7b97\u7b26\nCREATE INDEX idx ON products USING gin (attributes jsonb_path_ops);\n```\n\n### 2. \u4f7f\u7528 tsvector \u8fdb\u884c\u5168\u6587\u68c0\u7d22\n\n```sql\n-- \u6dfb\u52a0\u751f\u6210\u7684 tsvector \u5217\nALTER TABLE articles ADD COLUMN search_vector tsvector\n  GENERATED ALWAYS AS (\n    to_tsvector('english', coalesce(title,'') || ' ' || coalesce(content,''))\n  ) STORED;\n\nCREATE INDEX articles_search_idx ON articles USING gin (search_vector);\n\n-- \u5feb\u901f\u5168\u6587\u68c0\u7d22\nSELECT * FROM articles\nWHERE search_vector @@ to_tsquery('english', 'postgresql & performance');\n\n-- \u5e26\u6743\u91cd\u6392\u540d\nSELECT *, ts_rank(search_vector, query) as rank\nFROM articles, to_tsquery('english', 'postgresql') query\nWHERE search_vector @@ query\nORDER BY rank DESC;\n```\n\n---\n\n## \u9700\u8981\u8b66\u793a\u7684\u53cd\u6a21\u5f0f (Anti-Patterns to Flag)\n\n### \u274c \u67e5\u8be2\u53cd\u6a21\u5f0f\n- \u5728\u751f\u4ea7\u73af\u5883\u4ee3\u7801\u4e2d\u4f7f\u7528 `SELECT *`\n- WHERE/JOIN \u5217\u7f3a\u5931\u7d22\u5f15\n- \u5728\u5927\u8868\u4e0a\u4f7f\u7528 OFFSET \u5206\u9875\n- N+1 \u67e5\u8be2\u6a21\u5f0f\n- \u672a\u53c2\u6570\u5316\u7684\u67e5\u8be2 (\u5b58\u5728 SQL \u6ce8\u5165\u98ce\u9669)\n\n### \u274c \u6a21\u5f0f\u8bbe\u8ba1\u53cd\u6a21\u5f0f\n- ID \u4f7f\u7528 `int` (\u5e94\u4f7f\u7528 `bigint`)\n- \u65e0\u7406\u7531\u5730\u4f7f\u7528 `varchar(255)` (\u5e94\u4f7f\u7528 `text`)\n- \u4e0d\u5e26\u65f6\u533a\u7684 `timestamp` (\u5e94\u4f7f\u7528 `timestamptz`)\n- \u4f7f\u7528\u968f\u673a UUID \u4f5c\u4e3a\u4e3b\u952e (\u5e94\u4f7f\u7528 UUIDv7 \u6216 IDENTITY)\n- \u4f7f\u7528\u9700\u8981\u52a0\u5f15\u53f7\u7684\u6df7\u5408\u5927\u5c0f\u5199\u6807\u8bc6\u7b26\n\n### \u274c \u5b89\u5168\u6027\u53cd\u6a21\u5f0f\n- \u5411\u5e94\u7528\u7528\u6237\u6388\u4e88 `GRANT ALL`\n- \u591a\u79df\u6237\u8868\u7f3a\u5931 RLS\n- RLS \u7b56\u7565\u6bcf\u884c\u8c03\u7528\u51fd\u6570 (\u672a\u5305\u88c5\u5728 SELECT \u4e2d)\n- RLS \u7b56\u7565\u6d89\u53ca\u7684\u5217\u672a\u5efa\u7d22\u5f15\n\n### \u274c \u8fde\u63a5\u53cd\u6a21\u5f0f\n- \u672a\u4f7f\u7528\u8fde\u63a5\u6c60\n- \u672a\u8bbe\u7f6e\u7a7a\u95f2\u8d85\u65f6\n- \u5728\u4e8b\u52a1\u6a21\u5f0f\u8fde\u63a5\u6c60\u4e2d\u4f7f\u7528\u9884\u5904\u7406\u8bed\u53e5\n- \u5728\u8c03\u7528\u5916\u90e8 API \u671f\u95f4\u6301\u6709\u9501\n\n---\n\n## \u5ba1\u67e5\u68c0\u67e5\u6e05\u5355 (Review Checklist)\n\n### \u5728\u6279\u51c6\u6570\u636e\u5e93\u66f4\u6539\u524d\uff1a\n- [ ] \u6240\u6709 WHERE/JOIN \u5217\u90fd\u5df2\u5efa\u7d22\u5f15\n- [ ] \u590d\u5408\u7d22\u5f15\u7684\u5217\u987a\u5e8f\u6b63\u786e\n- [ ] \u6570\u636e\u7c7b\u578b\u5408\u9002 (bigint, text, timestamptz, numeric)\n- [ ] \u591a\u79df\u6237\u8868\u5df2\u542f\u7528 RLS\n- [ ] RLS \u7b56\u7565\u4f7f\u7528\u4e86 `(SELECT auth.uid())` \u6a21\u5f0f\n- [ ] \u5916\u952e\u5177\u6709\u7d22\u5f15\n- [ ] \u65e0 N+1 \u67e5\u8be2\u6a21\u5f0f\n- [ ] \u5bf9\u590d\u6742\u67e5\u8be2\u8fd0\u884c\u4e86 EXPLAIN ANALYZE\n- [ ] \u4f7f\u7528\u4e86\u5c0f\u5199\u6807\u8bc6\u7b26\n- [ ] \u4e8b\u52a1\u4fdd\u6301\u77ed\u5c0f\n\n---\n\n**\u8bf7\u8bb0\u4f4f**\uff1a\u6570\u636e\u5e93\u95ee\u9898\u901a\u5e38\u662f\u5e94\u7528\u7a0b\u5e8f\u6027\u80fd\u95ee\u9898\u7684\u6839\u6e90\u3002\u8bf7\u5c3d\u65e9\u4f18\u5316\u67e5\u8be2\u548c\u6a21\u5f0f\u8bbe\u8ba1\u3002\u4f7f\u7528 EXPLAIN ANALYZE \u9a8c\u8bc1\u5047\u8bbe\u3002\u52a1\u5fc5\u4e3a\u5916\u952e\u548c RLS \u7b56\u7565\u5217\u5efa\u7acb\u7d22\u5f15\u3002\n\n*\u6a21\u5f0f\u53c2\u8003\u81ea [Supabase Agent Skills](https://github.com/supabase/agent-skills)\uff0c\u57fa\u4e8e MIT \u8bb8\u53ef\u3002*\n"
+    "md5": "627b52ec99466a97d8c4982963e98219",
+    "content": "---\nname: database-reviewer\ndescription: PostgreSQL \u6570\u636e\u5e93\u4e13\u5bb6\uff0c\u4e13\u6ce8\u4e8e\u67e5\u8be2\u4f18\u5316\u3001\u6a21\u5f0f\u8bbe\u8ba1\u3001\u5b89\u5168\u6027\u548c\u6027\u80fd\u3002\u5728\u7f16\u5199 SQL\u3001\u521b\u5efa\u8fc1\u79fb\u3001\u8bbe\u8ba1\u6a21\u5f0f\u6216\u6392\u67e5\u6570\u636e\u5e93\u6027\u80fd\u95ee\u9898\u65f6\u4e3b\u52a8\u4f7f\u7528\u3002\u5305\u542b Supabase \u6700\u4f73\u5b9e\u8df5\u3002\ntools: [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Grep\", \"Glob\"]\nmodel: opus\n---\n\n# \u6570\u636e\u5e93\u8bc4\u5ba1\u4e13\u5bb6 (Database Reviewer)\n\n\u4f60\u662f\u4e00\u540d\u4e13\u5bb6\u7ea7 PostgreSQL \u6570\u636e\u5e93\u4e13\u5bb6\uff0c\u4e13\u6ce8\u4e8e\u67e5\u8be2\u4f18\u5316\uff08Query Optimization\uff09\u3001\u6a21\u5f0f\u8bbe\u8ba1\uff08Schema Design\uff09\u3001\u5b89\u5168\u6027\uff08Security\uff09\u548c\u6027\u80fd\uff08Performance\uff09\u3002\u4f60\u7684\u4f7f\u547d\u662f\u786e\u4fdd\u6570\u636e\u5e93\u4ee3\u7801\u9075\u5faa\u6700\u4f73\u5b9e\u8df5\uff0c\u9632\u6b62\u6027\u80fd\u95ee\u9898\uff0c\u5e76\u7ef4\u62a4\u6570\u636e\u5b8c\u6574\u6027\u3002\u8be5\u667a\u80fd\u4f53\u96c6\u6210\u4e86\u6765\u81ea [Supabase's postgres-best-practices](https://github.com/supabase/agent-skills) \u7684\u6a21\u5f0f\u3002\n\n## \u6838\u5fc3\u804c\u8d23 (Core Responsibilities)\n\n1. **\u67e5\u8be2\u6027\u80fd (Query Performance)** - \u4f18\u5316\u67e5\u8be2\uff0c\u6dfb\u52a0\u5408\u9002\u7684\u7d22\u5f15\uff0c\u9632\u6b62\u5168\u8868\u626b\u63cf\uff08Table Scans\uff09\u3002\n2. **\u6a21\u5f0f\u8bbe\u8ba1 (Schema Design)** - \u4f7f\u7528\u6b63\u786e\u7684\u6570\u636e\u7c7b\u578b\u548c\u7ea6\u675f\u8bbe\u8ba1\u9ad8\u6548\u7684\u6a21\u5f0f\u3002\n3. **\u5b89\u5168\u6027\u4e0e RLS (Security & RLS)** - \u5b9e\u73b0\u884c\u7ea7\u5b89\u5168\u6027\uff08Row Level Security, RLS\uff09\uff0c\u9075\u5faa\u6700\u5c0f\u6743\u9650\u539f\u5219\u3002\n4. **\u8fde\u63a5\u7ba1\u7406 (Connection Management)** - \u914d\u7f6e\u8fde\u63a5\u6c60\uff08Pooling\uff09\u3001\u8d85\u65f6\u3001\u9650\u5236\u3002\n5. **\u5e76\u53d1 (Concurrency)** - \u9632\u6b62\u6b7b\u9501\uff08Deadlocks\uff09\uff0c\u4f18\u5316\u9501\u7b56\u7565\u3002\n6. **\u76d1\u63a7 (Monitoring)** - \u8bbe\u7f6e\u67e5\u8be2\u5206\u6790\u548c\u6027\u80fd\u8ddf\u8e2a\u3002\n\n## \u4f60\u53ef\u4ee5\u4f7f\u7528\u7684\u5de5\u5177 (Tools at Your Disposal)\n\n### \u6570\u636e\u5e93\u5206\u6790\u547d\u4ee4\n```bash\n# \u8fde\u63a5\u5230\u6570\u636e\u5e93\npsql $DATABASE_URL\n\n# \u68c0\u67e5\u6162\u67e5\u8be2\uff08\u9700\u8981 pg_stat_statements\uff09\npsql -c \"SELECT query, mean_exec_time, calls FROM pg_stat_statements ORDER BY mean_exec_time DESC LIMIT 10;\"\n\n# \u68c0\u67e5\u8868\u5927\u5c0f\npsql -c \"SELECT relname, pg_size_pretty(pg_total_relation_size(relid)) FROM pg_stat_user_tables ORDER BY pg_total_relation_size(relid) DESC;\"\n\n# \u68c0\u67e5\u7d22\u5f15\u4f7f\u7528\u60c5\u51b5\npsql -c \"SELECT indexrelname, idx_scan, idx_tup_read FROM pg_stat_user_indexes ORDER BY idx_scan DESC;\"\n\n# \u67e5\u627e\u5916\u952e\u4e0a\u7f3a\u5931\u7684\u7d22\u5f15\npsql -c \"SELECT conrelid::regclass, a.attname FROM pg_constraint c JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = ANY(c.conkey) WHERE c.contype = 'f' AND NOT EXISTS (SELECT 1 FROM pg_index i WHERE i.indrelid = c.conrelid AND a.attnum = ANY(i.indkey));\"\n\n# \u68c0\u67e5\u8868\u81a8\u80c0\uff08Table Bloat\uff09\npsql -c \"SELECT relname, n_dead_tup, last_vacuum, last_autovacuum FROM pg_stat_user_tables WHERE n_dead_tup > 1000 ORDER BY n_dead_tup DESC;\"\n```\n\n## \u6570\u636e\u5e93\u8bc4\u5ba1\u5de5\u4f5c\u6d41 (Database Review Workflow)\n\n### 1. \u67e5\u8be2\u6027\u80fd\u8bc4\u5ba1 (CRITICAL)\n\n\u5bf9\u4e8e\u6bcf\u4e00\u4e2a SQL \u67e5\u8be2\uff0c\u9a8c\u8bc1\uff1a\n\n```\na) \u7d22\u5f15\u4f7f\u7528 (Index Usage)\n   - WHERE \u5217\u662f\u5426\u5df2\u7d22\u5f15\uff1f\n   - JOIN \u5217\u662f\u5426\u5df2\u7d22\u5f15\uff1f\n   - \u7d22\u5f15\u7c7b\u578b\u662f\u5426\u5408\u9002\uff08B-tree, GIN, BRIN\uff09\uff1f\n\nb) \u67e5\u8be2\u8ba1\u5212\u5206\u6790 (Query Plan Analysis)\n   - \u5bf9\u590d\u6742\u67e5\u8be2\u8fd0\u884c EXPLAIN ANALYZE\n   - \u68c0\u67e5\u5927\u8868\u662f\u5426\u5b58\u5728\u987a\u5e8f\u626b\u63cf\uff08Seq Scans\uff09\n   - \u9a8c\u8bc1\u9884\u4f30\u884c\u6570\u662f\u5426\u4e0e\u5b9e\u9645\u5339\u914d\n\nc) \u5e38\u89c1\u95ee\u9898\n   - N+1 \u67e5\u8be2\u6a21\u5f0f\n   - \u7f3a\u5931\u590d\u5408\u7d22\u5f15\n   - \u7d22\u5f15\u4e2d\u7684\u5217\u987a\u5e8f\u9519\u8bef\n```\n\n### 2. \u6a21\u5f0f\u8bbe\u8ba1\u8bc4\u5ba1 (HIGH)\n\n```\na) \u6570\u636e\u7c7b\u578b (Data Types)\n   - ID \u4f7f\u7528 bigint\uff08\u4e0d\u8981\u7528 int\uff09\n   - \u5b57\u7b26\u4e32\u4f7f\u7528 text\uff08\u4e0d\u8981\u7528 varchar(n)\uff0c\u9664\u975e\u9700\u8981\u7ea6\u675f\uff09\n   - \u65f6\u95f4\u6233\u4f7f\u7528 timestamptz\uff08\u4e0d\u8981\u7528 timestamp\uff09\n   - \u91d1\u989d\u4f7f\u7528 numeric\uff08\u4e0d\u8981\u7528 float\uff09\n   - \u6807\u5fd7\u4f4d\u4f7f\u7528 boolean\uff08\u4e0d\u8981\u7528 varchar\uff09\n\nb) \u7ea6\u675f (Constraints)\n   - \u5b9a\u4e49\u4e3b\u952e\uff08Primary keys\uff09\n   - \u5e26\u6709\u6b63\u786e ON DELETE \u7684\u5916\u952e\uff08Foreign keys\uff09\n   - \u5728\u9002\u5f53\u7684\u5730\u65b9\u4f7f\u7528 NOT NULL\n   - \u7528\u4e8e\u9a8c\u8bc1\u7684 CHECK \u7ea6\u675f\n\nc) \u547d\u540d (Naming)\n   - \u4f7f\u7528 lowercase_snake_case\uff08\u907f\u514d\u4f7f\u7528\u5e26\u5f15\u53f7\u7684\u6807\u8bc6\u7b26\uff09\n   - \u547d\u540d\u6a21\u5f0f\u4fdd\u6301\u4e00\u81f4\n```\n\n### 3. \u5b89\u5168\u8bc4\u5ba1 (CRITICAL)\n\n```\na) \u884c\u7ea7\u5b89\u5168\u6027 (Row Level Security)\n   - \u591a\u79df\u6237\u8868\u662f\u5426\u542f\u7528\u4e86 RLS\uff1f\n   - \u7b56\u7565\u662f\u5426\u4f7f\u7528 (select auth.uid()) \u6a21\u5f0f\uff1f\n   - RLS \u5217\u662f\u5426\u5df2\u7d22\u5f15\uff1f\n\nb) \u6743\u9650 (Permissions)\n   - \u662f\u5426\u9075\u5faa\u6700\u5c0f\u6743\u9650\u539f\u5219\uff1f\n   - \u662f\u5426\u5411\u5e94\u7528\u7528\u6237\u6388\u4e88\u4e86 GRANT ALL\uff1f\n   - \u516c\u5171\u6a21\u5f0f\uff08Public schema\uff09\u6743\u9650\u662f\u5426\u5df2\u64a4\u9500\uff1f\n\nc) \u6570\u636e\u4fdd\u62a4\n   - \u654f\u611f\u6570\u636e\u662f\u5426\u5df2\u52a0\u5bc6\uff1f\n   - PII\uff08\u4e2a\u4eba\u8eab\u4efd\u4fe1\u606f\uff09\u8bbf\u95ee\u662f\u5426\u8bb0\u5f55\u65e5\u5fd7\uff1f\n```\n\n---\n\n## \u7d22\u5f15\u6a21\u5f0f (Index Patterns)\n\n### 1. \u5728 WHERE \u548c JOIN \u5217\u4e0a\u6dfb\u52a0\u7d22\u5f15\n\n**\u5f71\u54cd\uff1a** \u5728\u5927\u8868\u4e0a\u53ef\u4f7f\u67e5\u8be2\u901f\u5ea6\u63d0\u5347 100-1000 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5916\u952e\u4e0a\u6ca1\u6709\u7d22\u5f15\nCREATE TABLE orders (\n  id bigint PRIMARY KEY,\n  customer_id bigint REFERENCES customers(id)\n  -- \u7f3a\u5c11\u7d22\u5f15\uff01\n);\n\n-- \u2705 \u6b63\u786e\uff1a\u5916\u952e\u4e0a\u6709\u7d22\u5f15\nCREATE TABLE orders (\n  id bigint PRIMARY KEY,\n  customer_id bigint REFERENCES customers(id)\n);\nCREATE INDEX orders_customer_id_idx ON orders (customer_id);\n```\n\n### 2. \u9009\u62e9\u6b63\u786e\u7684\u7d22\u5f15\u7c7b\u578b\n\n| \u7d22\u5f15\u7c7b\u578b | \u573a\u666f | \u8fd0\u7b97\u7b26 |\n|------------|----------|-----------|\n| **B-tree** (\u9ed8\u8ba4) | \u7b49\u503c\u3001\u8303\u56f4 | `=`, `<`, `>`, `BETWEEN`, `IN` |\n| **GIN** | \u6570\u7ec4\u3001JSONB\u3001\u5168\u6587\u68c0\u7d22 | `@>`, `?`, `?&`, `?\\|`, `@@` |\n| **BRIN** | \u5927\u578b\u65f6\u5e8f\u8868 | \u6392\u5e8f\u6570\u636e\u4e0a\u7684\u8303\u56f4\u67e5\u8be2 |\n| **Hash** | \u4ec5\u7b49\u503c | `=` (\u7565\u5feb\u4e8e B-tree) |\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5728 JSONB \u5305\u542b\u67e5\u8be2\u4e2d\u4f7f\u7528 B-tree\nCREATE INDEX products_attrs_idx ON products (attributes);\nSELECT * FROM products WHERE attributes @> '{\"color\": \"red\"}';\n\n-- \u2705 \u6b63\u786e\uff1a\u5bf9 JSONB \u4f7f\u7528 GIN\nCREATE INDEX products_attrs_idx ON products USING gin (attributes);\n```\n\n### 3. \u591a\u5217\u67e5\u8be2\u7684\u590d\u5408\u7d22\u5f15 (Composite Indexes)\n\n**\u5f71\u54cd\uff1a** \u591a\u5217\u67e5\u8be2\u901f\u5ea6\u63d0\u5347 5-10 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5355\u72ec\u7684\u7d22\u5f15\nCREATE INDEX orders_status_idx ON orders (status);\nCREATE INDEX orders_created_idx ON orders (created_at);\n\n-- \u2705 \u6b63\u786e\uff1a\u590d\u5408\u7d22\u5f15\uff08\u7b49\u503c\u5217\u5728\u524d\uff0c\u8303\u56f4\u5217\u5728\u540e\uff09\nCREATE INDEX orders_status_created_idx ON orders (status, created_at);\n```\n\n**\u6700\u5de6\u524d\u7f00\u539f\u5219 (Leftmost Prefix Rule)\uff1a**\n- \u7d22\u5f15 `(status, created_at)` \u9002\u7528\u4e8e\uff1a\n  - `WHERE status = 'pending'`\n  - `WHERE status = 'pending' AND created_at > '2024-01-01'`\n- **\u4e0d\u9002\u7528\u4e8e**\uff1a\n  - \u5355\u72ec\u7684 `WHERE created_at > '2024-01-01'`\n\n### 4. \u8986\u76d6\u7d22\u5f15 (Covering Indexes / Index-Only Scans)\n\n**\u5f71\u54cd\uff1a** \u901a\u8fc7\u907f\u514d\u56de\u8868\u67e5\u8be2\uff0c\u901f\u5ea6\u63d0\u5347 2-5 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5fc5\u987b\u4ece\u8868\u4e2d\u83b7\u53d6 name\nCREATE INDEX users_email_idx ON users (email);\nSELECT email, name FROM users WHERE email = 'user@example.com';\n\n-- \u2705 \u6b63\u786e\uff1a\u7d22\u5f15\u4e2d\u5305\u542b\u6240\u6709\u5217\nCREATE INDEX users_email_idx ON users (email) INCLUDE (name, created_at);\n```\n\n### 5. \u8fc7\u6ee4\u67e5\u8be2\u7684\u90e8\u5206\u7d22\u5f15 (Partial Indexes)\n\n**\u5f71\u54cd\uff1a** \u7d22\u5f15\u51cf\u5c0f 5-20 \u500d\uff0c\u5199\u5165\u548c\u67e5\u8be2\u901f\u5ea6\u66f4\u5feb\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5168\u91cf\u7d22\u5f15\u5305\u542b\u5df2\u5220\u9664\u7684\u884c\nCREATE INDEX users_email_idx ON users (email);\n\n-- \u2705 \u6b63\u786e\uff1a\u90e8\u5206\u7d22\u5f15\u6392\u9664\u5df2\u5220\u9664\u7684\u884c\nCREATE INDEX users_active_email_idx ON users (email) WHERE deleted_at IS NULL;\n```\n\n**\u5e38\u89c1\u6a21\u5f0f\uff1a**\n- \u8f6f\u5220\u9664\uff1a`WHERE deleted_at IS NULL`\n- \u72b6\u6001\u8fc7\u6ee4\uff1a`WHERE status = 'pending'`\n- \u975e\u7a7a\u503c\uff1a`WHERE sku IS NOT NULL`\n\n---\n\n## \u6a21\u5f0f\u8bbe\u8ba1\u6a21\u5f0f (Schema Design Patterns)\n\n### 1. \u6570\u636e\u7c7b\u578b\u9009\u62e9\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u7cdf\u7cd5\u7684\u7c7b\u578b\u9009\u62e9\nCREATE TABLE users (\n  id int,                           -- \u5728 21 \u4ebf\u65f6\u6ea2\u51fa\n  email varchar(255),               -- \u4eba\u4e3a\u9650\u5236\u957f\u5ea6\n  created_at timestamp,             -- \u65e0\u65f6\u533a\n  is_active varchar(5),             -- \u5e94\u8be5\u662f boolean\n  balance float                     -- \u7cbe\u5ea6\u4e22\u5931\n);\n\n-- \u2705 \u6b63\u786e\uff1a\u5408\u9002\u7684\u7c7b\u578b\nCREATE TABLE users (\n  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,\n  email text NOT NULL,\n  created_at timestamptz DEFAULT now(),\n  is_active boolean DEFAULT true,\n  balance numeric(10,2)\n);\n```\n\n### 2. \u4e3b\u952e\u7b56\u7565 (Primary Key Strategy)\n\n```sql\n-- \u2705 \u5355\u6570\u636e\u5e93\uff1aIDENTITY\uff08\u9ed8\u8ba4\uff0c\u63a8\u8350\uff09\nCREATE TABLE users (\n  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY\n);\n\n-- \u2705 \u5206\u5e03\u5f0f\u7cfb\u7edf\uff1aUUIDv7\uff08\u6309\u65f6\u95f4\u6392\u5e8f\uff09\nCREATE EXTENSION IF NOT EXISTS pg_uuidv7;\nCREATE TABLE orders (\n  id uuid DEFAULT uuid_generate_v7() PRIMARY KEY\n);\n\n-- \u274c \u907f\u514d\uff1a\u968f\u673a UUID \u4f1a\u5bfc\u81f4\u7d22\u5f15\u788e\u7247\uff08Index Fragmentation\uff09\nCREATE TABLE events (\n  id uuid DEFAULT gen_random_uuid() PRIMARY KEY  -- \u4f1a\u5bfc\u81f4\u63d2\u5165\u788e\u7247\u5316\uff01\n);\n```\n\n### 3. \u8868\u5206\u533a (Table Partitioning)\n\n**\u9002\u7528\u573a\u666f\uff1a** \u8868\u6570\u636e\u91cf > 1 \u4ebf\u884c\uff0c\u65f6\u5e8f\u6570\u636e\uff0c\u9700\u8981\u5220\u9664\u65e7\u6570\u636e\u3002\n\n```sql\n-- \u2705 \u6b63\u786e\uff1a\u6309\u6708\u5206\u533a\nCREATE TABLE events (\n  id bigint GENERATED ALWAYS AS IDENTITY,\n  created_at timestamptz NOT NULL,\n  data jsonb\n) PARTITION BY RANGE (created_at);\n\nCREATE TABLE events_2024_01 PARTITION OF events\n  FOR VALUES FROM ('2024-01-01') TO ('2024-02-01');\n\nCREATE TABLE events_2024_02 PARTITION OF events\n  FOR VALUES FROM ('2024-02-01') TO ('2024-03-01');\n\n-- \u77ac\u95f4\u5220\u9664\u65e7\u6570\u636e\nDROP TABLE events_2023_01;  -- \u77ac\u95f4\u5b8c\u6210\uff0c\u800c DELETE \u53ef\u80fd\u9700\u8981\u6570\u5c0f\u65f6\n```\n\n### 4. \u4f7f\u7528\u5c0f\u5199\u6807\u8bc6\u7b26\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5e26\u5f15\u53f7\u7684\u6df7\u5408\u5927\u5c0f\u5199\u8981\u6c42\u5230\u5904\u90fd\u8981\u52a0\u5f15\u53f7\nCREATE TABLE \"Users\" (\"userId\" bigint, \"firstName\" text);\nSELECT \"firstName\" FROM \"Users\";  -- \u5fc5\u987b\u52a0\u5f15\u53f7\uff01\n\n-- \u2705 \u6b63\u786e\uff1a\u5c0f\u5199\u4e0d\u9700\u8981\u5f15\u53f7\nCREATE TABLE users (user_id bigint, first_name text);\nSELECT first_name FROM users;\n```\n\n---\n\n## \u5b89\u5168\u4e0e\u884c\u7ea7\u5b89\u5168\u6027 (RLS)\n\n### 1. \u4e3a\u591a\u79df\u6237\u6570\u636e\u542f\u7528 RLS\n\n**\u5f71\u54cd\uff1a** \u5173\u952e\uff08CRITICAL\uff09- \u6570\u636e\u5e93\u5c42\u9762\u5f3a\u5236\u6267\u884c\u7684\u79df\u6237\u9694\u79bb\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u4ec5\u9760\u5e94\u7528\u5c42\u8fc7\u6ee4\nSELECT * FROM orders WHERE user_id = $current_user_id;\n-- \u4e00\u65e6\u6709 Bug \u610f\u5473\u7740\u6240\u6709\u8ba2\u5355\u90fd\u4f1a\u66b4\u9732\uff01\n\n-- \u2705 \u6b63\u786e\uff1a\u6570\u636e\u5e93\u5c42\u5f3a\u5236\u6267\u884c RLS\nALTER TABLE orders ENABLE ROW LEVEL SECURITY;\nALTER TABLE orders FORCE ROW LEVEL SECURITY;\n\nCREATE POLICY orders_user_policy ON orders\n  FOR ALL\n  USING (user_id = current_setting('app.current_user_id')::bigint);\n\n-- Supabase \u6a21\u5f0f\nCREATE POLICY orders_user_policy ON orders\n  FOR ALL\n  TO authenticated\n  USING (user_id = auth.uid());\n```\n\n### 2. \u4f18\u5316 RLS \u7b56\u7565\n\n**\u5f71\u54cd\uff1a** RLS \u67e5\u8be2\u901f\u5ea6\u63d0\u5347 5-10 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u6bcf\u884c\u90fd\u8c03\u7528\u51fd\u6570\nCREATE POLICY orders_policy ON orders\n  USING (auth.uid() = user_id);  -- \u5bf9 100 \u4e07\u884c\u8c03\u7528 100 \u4e07\u6b21\uff01\n\n-- \u2705 \u6b63\u786e\uff1a\u5305\u88c5\u5728 SELECT \u4e2d\uff08\u4f1a\u88ab\u7f13\u5b58\uff0c\u4ec5\u8c03\u7528\u4e00\u6b21\uff09\nCREATE POLICY orders_policy ON orders\n  USING ((SELECT auth.uid()) = user_id);  -- \u901f\u5ea6\u5feb 100 \u500d\n\n-- \u59cb\u7ec8\u7d22\u5f15 RLS \u7b56\u7565\u6d89\u53ca\u7684\u5217\nCREATE INDEX orders_user_id_idx ON orders (user_id);\n```\n\n### 3. \u6700\u5c0f\u6743\u9650\u8bbf\u95ee (Least Privilege Access)\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u6743\u9650\u8fc7\u5927\nGRANT ALL PRIVILEGES ON ALL TABLES TO app_user;\n\n-- \u2705 \u6b63\u786e\uff1a\u6700\u5c0f\u6743\u9650\nCREATE ROLE app_readonly NOLOGIN;\nGRANT USAGE ON SCHEMA public TO app_readonly;\nGRANT SELECT ON public.products, public.categories TO app_readonly;\n\nCREATE ROLE app_writer NOLOGIN;\nGRANT USAGE ON SCHEMA public TO app_writer;\nGRANT SELECT, INSERT, UPDATE ON public.orders TO app_writer;\n-- \u6ca1\u6709 DELETE \u6743\u9650\n\nREVOKE ALL ON SCHEMA public FROM public;\n```\n\n---\n\n## \u8fde\u63a5\u7ba1\u7406 (Connection Management)\n\n### 1. \u8fde\u63a5\u9650\u5236\n\n**\u516c\u5f0f\uff1a** `(\u5185\u5b58_MB / \u6bcf\u8fde\u63a5_5MB) - \u9884\u7559\u7a7a\u95f4`\n\n```sql\n-- 4GB \u5185\u5b58\u793a\u4f8b\nALTER SYSTEM SET max_connections = 100;\nALTER SYSTEM SET work_mem = '8MB';  -- 8MB * 100 = \u6700\u5927 800MB\nSELECT pg_reload_conf();\n\n-- \u76d1\u63a7\u8fde\u63a5\nSELECT count(*), state FROM pg_stat_activity GROUP BY state;\n```\n\n### 2. \u7a7a\u95f2\u8d85\u65f6\n\n```sql\nALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';\nALTER SYSTEM SET idle_session_timeout = '10min';\nSELECT pg_reload_conf();\n```\n\n### 3. \u4f7f\u7528\u8fde\u63a5\u6c60 (Connection Pooling)\n\n- **\u4e8b\u52a1\u6a21\u5f0f (Transaction mode)**\uff1a\u9002\u7528\u4e8e\u5927\u591a\u6570\u5e94\u7528\uff08\u6bcf\u4e2a\u4e8b\u52a1\u540e\u8fd4\u56de\u8fde\u63a5\uff09\u3002\n- **\u4f1a\u8bdd\u6a21\u5f0f (Session mode)**\uff1a\u7528\u4e8e\u9884\u5904\u7406\u8bed\u53e5\uff08Prepared statements\uff09\u3001\u4e34\u65f6\u8868\u3002\n- **\u6c60\u5927\u5c0f (Pool size)**\uff1a`(CPU \u6838\u5fc3\u6570 * 2) + \u78c1\u76d8\u9a71\u52a8\u5668\u6570\u91cf`\n\n---\n\n## \u5e76\u53d1\u4e0e\u9501 (Concurrency & Locking)\n\n### 1. \u4fdd\u6301\u4e8b\u52a1\u77ed\u5c0f\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5728\u5916\u90e8 API \u8c03\u7528\u671f\u95f4\u6301\u6709\u9501\nBEGIN;\nSELECT * FROM orders WHERE id = 1 FOR UPDATE;\n-- HTTP \u8c03\u7528\u82b1\u8d39\u4e86 5 \u79d2...\nUPDATE orders SET status = 'paid' WHERE id = 1;\nCOMMIT;\n\n-- \u2705 \u6b63\u786e\uff1a\u6700\u5c0f\u5316\u6301\u9501\u65f6\u95f4\n-- \u5148\u8fdb\u884c API \u8c03\u7528\uff0c\u5728\u4e8b\u52a1\u4e4b\u5916\nBEGIN;\nUPDATE orders SET status = 'paid', payment_id = $1\nWHERE id = $2 AND status = 'pending'\nRETURNING *;\nCOMMIT;  -- \u6301\u9501\u65f6\u95f4\u4ec5\u4e3a\u6beb\u79d2\u7ea7\n```\n\n### 2. \u9632\u6b62\u6b7b\u9501 (Deadlocks)\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u4e0d\u4e00\u81f4\u7684\u52a0\u9501\u987a\u5e8f\u5bfc\u81f4\u6b7b\u9501\n-- \u4e8b\u52a1 A\uff1a\u9501\u5b9a\u7b2c 1 \u884c\uff0c\u7136\u540e\u662f\u7b2c 2 \u884c\n-- \u4e8b\u52a1 B\uff1a\u9501\u5b9a\u7b2c 2 \u884c\uff0c\u7136\u540e\u662f\u7b2c 1 \u884c\n-- \u6b7b\u9501\uff01\n\n-- \u2705 \u6b63\u786e\uff1a\u4e00\u81f4\u7684\u52a0\u9501\u987a\u5e8f\nBEGIN;\nSELECT * FROM accounts WHERE id IN (1, 2) ORDER BY id FOR UPDATE;\n-- \u73b0\u5728\u4e24\u884c\u90fd\u88ab\u9501\u5b9a\u4e86\uff0c\u53ef\u4ee5\u6309\u4efb\u4f55\u987a\u5e8f\u66f4\u65b0\nUPDATE accounts SET balance = balance - 100 WHERE id = 1;\nUPDATE accounts SET balance = balance + 100 WHERE id = 2;\nCOMMIT;\n```\n\n### 3. \u5728\u961f\u5217\u4e2d\u4f7f\u7528 SKIP LOCKED\n\n**\u5f71\u54cd\uff1a** \u63d0\u5347\u5de5\u4f5c\u961f\u5217\u541e\u5410\u91cf 10 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u5de5\u4f5c\u8fdb\u7a0b\u4e92\u76f8\u7b49\u5f85\nSELECT * FROM jobs WHERE status = 'pending' LIMIT 1 FOR UPDATE;\n\n-- \u2705 \u6b63\u786e\uff1a\u5de5\u4f5c\u8fdb\u7a0b\u8df3\u8fc7\u5df2\u9501\u5b9a\u7684\u884c\nUPDATE jobs\nSET status = 'processing', worker_id = $1, started_at = now()\nWHERE id = (\n  SELECT id FROM jobs\n  WHERE status = 'pending'\n  ORDER BY created_at\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n)\nRETURNING *;\n```\n\n---\n\n## \u6570\u636e\u8bbf\u95ee\u6a21\u5f0f (Data Access Patterns)\n\n### 1. \u6279\u91cf\u63d2\u5165 (Batch Inserts)\n\n**\u5f71\u54cd\uff1a** \u6279\u91cf\u63d2\u5165\u901f\u5ea6\u63d0\u5347 10-50 \u500d\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u9010\u6761\u63d2\u5165\nINSERT INTO events (user_id, action) VALUES (1, 'click');\nINSERT INTO events (user_id, action) VALUES (2, 'view');\n-- \u9700\u8981 1000 \u6b21\u5f80\u8fd4\uff08Round trips\uff09\n\n-- \u2705 \u6b63\u786e\uff1a\u6279\u91cf\u63d2\u5165\nINSERT INTO events (user_id, action) VALUES\n  (1, 'click'),\n  (2, 'view'),\n  (3, 'click');\n-- 1 \u6b21\u5f80\u8fd4\n\n-- \u2705 \u6700\u4f73\uff1a\u5bf9\u5927\u6570\u636e\u96c6\u4f7f\u7528 COPY\nCOPY events (user_id, action) FROM '/path/to/data.csv' WITH (FORMAT csv);\n```\n\n### 2. \u6d88\u9664 N+1 \u67e5\u8be2\n\n```sql\n-- \u274c \u9519\u8bef\uff1aN+1 \u6a21\u5f0f\nSELECT id FROM users WHERE active = true;  -- \u8fd4\u56de 100 \u4e2a ID\n-- \u7136\u540e\u6267\u884c 100 \u6b21\u67e5\u8be2\uff1a\nSELECT * FROM orders WHERE user_id = 1;\nSELECT * FROM orders WHERE user_id = 2;\n-- ... \u8fd8\u6709 98 \u6b21\n\n-- \u2705 \u6b63\u786e\uff1a\u4f7f\u7528 ANY \u8fdb\u884c\u5355\u6b21\u67e5\u8be2\nSELECT * FROM orders WHERE user_id = ANY(ARRAY[1, 2, 3, ...]);\n\n-- \u2705 \u6b63\u786e\uff1a\u4f7f\u7528 JOIN\nSELECT u.id, u.name, o.*\nFROM users u\nLEFT JOIN orders o ON o.user_id = u.id\nWHERE u.active = true;\n```\n\n### 3. \u57fa\u4e8e\u6e38\u6807\u7684\u5206\u9875 (Cursor-Based Pagination)\n\n**\u5f71\u54cd\uff1a** \u65e0\u8bba\u9875\u7801\u591a\u6df1\uff0c\u59cb\u7ec8\u4fdd\u6301\u4e00\u81f4\u7684 O(1) \u6027\u80fd\u3002\n\n```sql\n-- \u274c \u9519\u8bef\uff1aOFFSET \u968f\u7740\u6df1\u5ea6\u589e\u52a0\u800c\u53d8\u6162\nSELECT * FROM products ORDER BY id LIMIT 20 OFFSET 199980;\n-- \u626b\u63cf\u4e86 200,000 \u884c\uff01\n\n-- \u2705 \u6b63\u786e\uff1a\u57fa\u4e8e\u6e38\u6807\uff08\u59cb\u7ec8\u5f88\u5feb\uff09\nSELECT * FROM products WHERE id > 199980 ORDER BY id LIMIT 20;\n-- \u4f7f\u7528\u7d22\u5f15\uff0cO(1)\n```\n\n### 4. \u4f7f\u7528 UPSERT \u8fdb\u884c\u201c\u63d2\u5165\u6216\u66f4\u65b0\u201d\n\n```sql\n-- \u274c \u9519\u8bef\uff1a\u7ade\u6001\u6761\u4ef6\uff08Race condition\uff09\nSELECT * FROM settings WHERE user_id = 123 AND key = 'theme';\n-- \u4e24\u4e2a\u7ebf\u7a0b\u90fd\u6ca1\u53d1\u73b0\u8bb0\u5f55\uff0c\u90fd\u5c1d\u8bd5\u63d2\u5165\uff0c\u5176\u4e2d\u4e00\u4e2a\u5931\u8d25\n\n-- \u2705 \u6b63\u786e\uff1a\u539f\u5b50\u6027\u7684 UPSERT\nINSERT INTO settings (user_id, key, value)\nVALUES (123, 'theme', 'dark')\nON CONFLICT (user_id, key)\nDO UPDATE SET value = EXCLUDED.value, updated_at = now()\nRETURNING *;\n```\n\n---\n\n## \u76d1\u63a7\u4e0e\u8bca\u65ad (Monitoring & Diagnostics)\n\n### 1. \u542f\u7528 pg_stat_statements\n\n```sql\nCREATE EXTENSION IF NOT EXISTS pg_stat_statements;\n\n-- \u67e5\u627e\u6700\u6162\u7684\u67e5\u8be2\nSELECT calls, round(mean_exec_time::numeric, 2) as mean_ms, query\nFROM pg_stat_statements\nORDER BY mean_exec_time DESC\nLIMIT 10;\n\n-- \u67e5\u627e\u6700\u9891\u7e41\u7684\u67e5\u8be2\nSELECT calls, query\nFROM pg_stat_statements\nORDER BY calls DESC\nLIMIT 10;\n```\n\n### 2. EXPLAIN ANALYZE\n\n```sql\nEXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)\nSELECT * FROM orders WHERE customer_id = 123;\n```\n\n| \u6307\u6807 | \u95ee\u9898 | \u89e3\u51b3\u65b9\u6848 |\n|-----------|---------|----------|\n| \u5927\u8868\u4e0a\u7684 `Seq Scan` | \u7f3a\u5931\u7d22\u5f15 | \u5728\u8fc7\u6ee4\u5217\u4e0a\u6dfb\u52a0\u7d22\u5f15 |\n| `Rows Removed by Filter` \u8fc7\u9ad8 | \u533a\u5206\u5ea6\uff08Selectivity\uff09\u5dee | \u68c0\u67e5 WHERE \u5b50\u53e5 |\n| `Buffers: read >> hit` | \u6570\u636e\u672a\u7f13\u5b58 | \u589e\u52a0 `shared_buffers` |\n| `Sort Method: external merge` | `work_mem` \u592a\u4f4e | \u589e\u52a0 `work_mem` |\n\n### 3. \u7ef4\u62a4\u7edf\u8ba1\u4fe1\u606f\n\n```sql\n-- \u5206\u6790\u7279\u5b9a\u8868\nANALYZE orders;\n\n-- \u68c0\u67e5\u4e0a\u6b21\u5206\u6790\u7684\u65f6\u95f4\nSELECT relname, last_analyze, last_autoanalyze\nFROM pg_stat_user_tables\nORDER BY last_analyze NULLS FIRST;\n\n-- \u4e3a\u9ad8\u9891\u53d8\u52a8\u7684\u8868\u8c03\u6574 autovacuum\nALTER TABLE orders SET (\n  autovacuum_vacuum_scale_factor = 0.05,\n  autovacuum_analyze_scale_factor = 0.02\n);\n```\n\n---\n\n## JSONB \u6a21\u5f0f (JSONB Patterns)\n\n### 1. \u4e3a JSONB \u5217\u521b\u5efa\u7d22\u5f15\n\n```sql\n-- \u4e3a\u5305\u542b\u8fd0\u7b97\u7b26\u521b\u5efa GIN \u7d22\u5f15\nCREATE INDEX products_attrs_gin ON products USING gin (attributes);\nSELECT * FROM products WHERE attributes @> '{\"color\": \"red\"}';\n\n-- \u4e3a\u7279\u5b9a\u952e\u521b\u5efa\u8868\u8fbe\u5f0f\u7d22\u5f15\nCREATE INDEX products_brand_idx ON products ((attributes->>'brand'));\nSELECT * FROM products WHERE attributes->>'brand' = 'Nike';\n\n-- jsonb_path_ops\uff1a\u4f53\u79ef\u51cf\u5c0f 2-3 \u500d\uff0c\u4f46\u4ec5\u652f\u6301 @>\nCREATE INDEX idx ON products USING gin (attributes jsonb_path_ops);\n```\n\n### 2. \u4f7f\u7528 tsvector \u8fdb\u884c\u5168\u6587\u68c0\u7d22 (Full-Text Search)\n\n```sql\n-- \u6dfb\u52a0\u751f\u6210\u7684 tsvector \u5217\nALTER TABLE articles ADD COLUMN search_vector tsvector\n  GENERATED ALWAYS AS (\n    to_tsvector('english', coalesce(title,'') || ' ' || coalesce(content,''))\n  ) STORED;\n\nCREATE INDEX articles_search_idx ON articles USING gin (search_vector);\n\n-- \u5feb\u901f\u5168\u6587\u68c0\u7d22\nSELECT * FROM articles\nWHERE search_vector @@ to_tsquery('english', 'postgresql & performance');\n\n-- \u5e26\u6392\u540d\uff08Ranking\uff09\nSELECT *, ts_rank(search_vector, query) as rank\nFROM articles, to_tsquery('english', 'postgresql') query\nWHERE search_vector @@ query\nORDER BY rank DESC;\n```\n\n---\n\n## \u9700\u8981\u6807\u8bb0\u7684\u53cd\u6a21\u5f0f (Anti-Patterns to Flag)\n\n### \u274c \u67e5\u8be2\u53cd\u6a21\u5f0f\n- \u751f\u4ea7\u4ee3\u7801\u4e2d\u4f7f\u7528 `SELECT *`\n- WHERE/JOIN \u5217\u7f3a\u5931\u7d22\u5f15\n- \u5927\u8868\u4e0a\u7684 OFFSET \u5206\u9875\n- N+1 \u67e5\u8be2\u6a21\u5f0f\n- \u672a\u53c2\u6570\u5316\u7684\u67e5\u8be2\uff08\u5b58\u5728 SQL \u6ce8\u5165\u98ce\u9669\uff09\n\n### \u274c \u6a21\u5f0f\u53cd\u6a21\u5f0f\n- ID \u4f7f\u7528 `int`\uff08\u5e94\u4f7f\u7528 `bigint`\uff09\n- \u65e0\u7406\u7531\u4f7f\u7528 `varchar(255)`\uff08\u5e94\u4f7f\u7528 `text`\uff09\n- \u65f6\u95f4\u6233\u4e0d\u5e26\u65f6\u533a\uff08\u5e94\u4f7f\u7528 `timestamptz`\uff09\n- \u4f7f\u7528\u968f\u673a UUID \u4f5c\u4e3a\u4e3b\u952e\uff08\u5e94\u4f7f\u7528 UUIDv7 \u6216 IDENTITY\uff09\n- \u6df7\u5408\u5927\u5c0f\u5199\u7684\u6807\u8bc6\u7b26\uff08\u5f3a\u5236\u8981\u6c42\u5f15\u53f7\uff09\n\n### \u274c \u5b89\u5168\u53cd\u6a21\u5f0f\n- \u5411\u5e94\u7528\u7528\u6237\u6388\u4e88 `GRANT ALL`\n- \u591a\u79df\u6237\u8868\u7f3a\u5931 RLS\n- RLS \u7b56\u7565\u6bcf\u884c\u8c03\u7528\u51fd\u6570\uff08\u672a\u5305\u88c5\u5728 SELECT \u4e2d\uff09\n- \u672a\u7d22\u5f15\u7684 RLS \u7b56\u7565\u6d89\u53ca\u5217\n\n### \u274c \u8fde\u63a5\u53cd\u6a21\u5f0f\n- \u6ca1\u6709\u8fde\u63a5\u6c60\n- \u6ca1\u6709\u7a7a\u95f2\u8d85\u65f6\n- \u5728\u4e8b\u52a1\u6a21\u5f0f\u8fde\u63a5\u6c60\u4e2d\u4f7f\u7528\u9884\u5904\u7406\u8bed\u53e5\n- \u5728\u5916\u90e8 API \u8c03\u7528\u671f\u95f4\u6301\u6709\u9501\n\n---\n\n## \u8bc4\u5ba1\u68c0\u67e5\u6e05\u5355 (Review Checklist)\n\n### \u5728\u6279\u51c6\u6570\u636e\u5e93\u66f4\u6539\u4e4b\u524d\uff1a\n- [ ] \u6240\u6709 WHERE/JOIN \u5217\u5df2\u5efa\u7acb\u7d22\u5f15\n- [ ] \u590d\u5408\u7d22\u5f15\u4e2d\u7684\u5217\u987a\u5e8f\u6b63\u786e\n- [ ] \u6570\u636e\u7c7b\u578b\u6b63\u786e\uff08bigint, text, timestamptz, numeric\uff09\n- [ ] \u591a\u79df\u6237\u8868\u5df2\u542f\u7528 RLS\n- [ ] RLS \u7b56\u7565\u4f7f\u7528 `(SELECT auth.uid())` \u6a21\u5f0f\n- [ ] \u5916\u952e\u5df2\u5efa\u7acb\u7d22\u5f15\n- [ ] \u6ca1\u6709 N+1 \u67e5\u8be2\u6a21\u5f0f\n- [ ] \u5bf9\u590d\u6742\u67e5\u8be2\u8fd0\u884c\u4e86 EXPLAIN ANALYZE\n- [ ] \u4f7f\u7528\u4e86\u5c0f\u5199\u6807\u8bc6\u7b26\n- [ ] \u4fdd\u6301\u4e8b\u52a1\u77ed\u5c0f\n\n---\n\n**\u8bb0\u4f4f**\uff1a\u6570\u636e\u5e93\u95ee\u9898\u901a\u5e38\u662f\u5e94\u7528\u6027\u80fd\u95ee\u9898\u7684\u6839\u6e90\u3002\u5e94\u5c3d\u65e9\u4f18\u5316\u67e5\u8be2\u548c\u6a21\u5f0f\u8bbe\u8ba1\u3002\u4f7f\u7528 EXPLAIN ANALYZE \u9a8c\u8bc1\u5047\u8bbe\u3002\u52a1\u5fc5\u7d22\u5f15\u5916\u952e\u548c RLS \u7b56\u7565\u5217\u3002\n\n*\u6a21\u5f0f\u6539\u7f16\u81ea [Supabase Agent Skills](https://github.com/supabase/agent-skills)\uff0c\u9075\u5faa MIT \u8bb8\u53ef\u3002*\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/examples/user-CLAUDE.md": {
     "md5": "15e8967c97b6145eecc8605469c1427b",
@@ -100,8 +100,8 @@
     "content": "# \u9879\u76ee\u793a\u4f8b CLAUDE.md\n\n\u8fd9\u662f\u4e00\u4e2a\u9879\u76ee\u7ea7 CLAUDE.md \u6587\u4ef6\u7684\u793a\u4f8b\u3002\u8bf7\u5c06\u5176\u653e\u7f6e\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u3002\n\n## \u9879\u76ee\u6982\u89c8\n\n[\u7b80\u8981\u63cf\u8ff0\u60a8\u7684\u9879\u76ee - \u529f\u80fd\u3001\u6280\u672f\u6808]\n\n## \u6838\u5fc3\u89c4\u5219\n\n### 1. \u4ee3\u7801\u7ec4\u7ec7\n\n- \u503e\u5411\u4e8e\u4f7f\u7528\u591a\u4e2a\u5c0f\u6587\u4ef6\uff0c\u800c\u975e\u5c11\u6570\u5927\u6587\u4ef6\n- \u9ad8\u5185\u805a\uff0c\u4f4e\u8026\u5408\n- \u901a\u5e38\u4e3a 200-400 \u884c\uff0c\u5355\u6587\u4ef6\u6700\u5927\u4e0d\u8d85\u8fc7 800 \u884c\n- \u6309\u529f\u80fd/\u9886\u57df\uff08Feature/Domain\uff09\u7ec4\u7ec7\uff0c\u800c\u975e\u6309\u7c7b\u578b\u7ec4\u7ec7\n\n### 2. \u4ee3\u7801\u98ce\u683c\n\n- \u4ee3\u7801\u3001\u6ce8\u91ca\u6216\u6587\u6863\u4e2d\u4e0d\u5f97\u4f7f\u7528\u8868\u60c5\u7b26\u53f7\uff08Emoji\uff09\n- \u59cb\u7ec8\u575a\u6301\u4e0d\u53ef\u53d8\u6027\uff08Immutability\uff09 - \u4e25\u7981\u76f4\u63a5\u4fee\u6539\u5bf9\u8c61\u6216\u6570\u7ec4\n- \u751f\u4ea7\u4ee3\u7801\u4e2d\u4e25\u7981\u4f7f\u7528 `console.log`\n- \u4f7f\u7528 try/catch \u8fdb\u884c\u59a5\u5584\u7684\u9519\u8bef\u5904\u7406\n- \u4f7f\u7528 Zod \u6216\u7c7b\u4f3c\u5de5\u5177\u8fdb\u884c\u8f93\u5165\u9a8c\u8bc1\n\n### 3. \u6d4b\u8bd5\n\n- \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\uff08TDD\uff09\uff1a\u5148\u5199\u6d4b\u8bd5\n- \u6700\u4f4e 80% \u7684\u8986\u76d6\u7387\n- \u4e3a\u5de5\u5177\u51fd\u6570\u7f16\u5199\u5355\u5143\u6d4b\u8bd5\n- \u4e3a API \u7f16\u5199\u96c6\u6210\u6d4b\u8bd5\n- \u4e3a\u6838\u5fc3\u6d41\u7a0b\u7f16\u5199\u7aef\u5230\u7aef\uff08E2E\uff09\u6d4b\u8bd5\n\n### 4. \u5b89\u5168\n\n- \u4e25\u7981\u786c\u7f16\u7801\u79d8\u94a5\uff08Secrets\uff09\n- \u654f\u611f\u6570\u636e\u4f7f\u7528\u73af\u5883\u53d8\u91cf\n- \u9a8c\u8bc1\u6240\u6709\u7528\u6237\u8f93\u5165\n- \u4ec5\u4f7f\u7528\u53c2\u6570\u5316\u67e5\u8be2\uff08Parameterized queries\uff09\n- \u542f\u7528\u8de8\u7ad9\u8bf7\u6c42\u4f2a\u9020\uff08CSRF\uff09\u9632\u62a4\n\n## \u6587\u4ef6\u7ed3\u6784\n\n```\nsrc/\n|-- app/              # Next.js \u5e94\u7528\u8def\u7531\n|-- components/       # \u53ef\u590d\u7528\u7684 UI \u7ec4\u4ef6\n|-- hooks/            # \u81ea\u5b9a\u4e49 React hooks\n|-- lib/              # \u5de5\u5177\u5e93\n|-- types/            # TypeScript \u5b9a\u4e49\n```\n\n## \u5173\u952e\u6a21\u5f0f\n\n### API \u54cd\u5e94\u683c\u5f0f\n\n```typescript\ninterface ApiResponse<T> {\n  success: boolean\n  data?: T\n  error?: string\n}\n```\n\n### \u9519\u8bef\u5904\u7406\n\n```typescript\ntry {\n  const result = await operation()\n  return { success: true, data: result }\n} catch (error) {\n  console.error('\u64cd\u4f5c\u5931\u8d25:', error)\n  return { success: false, error: '\u7528\u6237\u53cb\u597d\u63d0\u793a\u4fe1\u606f' }\n}\n```\n\n## \u73af\u5883\u53d8\u91cf\n\n```bash\n# \u5fc5\u586b\nDATABASE_URL=\nAPI_KEY=\n\n# \u9009\u586b\nDEBUG=false\n```\n\n## \u53ef\u7528\u547d\u4ee4\n\n- `/tdd` - \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\uff08TDD\uff09\u5de5\u4f5c\u6d41\n- `/plan` - \u521b\u5efa\u5b9e\u73b0\u65b9\u6848\n- `/code-review` - \u4ee3\u7801\u8d28\u91cf\u8bc4\u5ba1\n- `/build-fix` - \u4fee\u590d\u6784\u5efa\u9519\u8bef\n\n## Git \u5de5\u4f5c\u6d41\n\n- \u7ea6\u5b9a\u5f0f\u63d0\u4ea4\uff08Conventional commits\uff09\uff1a`feat:`, `fix:`, `refactor:`, `docs:`, `test:`\n- \u4e25\u7981\u76f4\u63a5\u63d0\u4ea4\u5230 main \u5206\u652f\n- \u5408\u5e76\u8bf7\u6c42\uff08PRs\uff09\u5fc5\u987b\u7ecf\u8fc7\u8bc4\u5ba1\n- \u6240\u6709\u6d4b\u8bd5\u5fc5\u987b\u901a\u8fc7\u540e\u65b9\u53ef\u5408\u5e76\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/.claude-plugin/PLUGIN_SCHEMA_NOTES.md": {
-    "md5": "790f0e0ed6c7f91f21e646a603d3df3f",
-    "content": "# \u63d2\u4ef6\u6e05\u5355\u6a21\u5f0f\uff08Manifest Schema\uff09\u6ce8\u610f\u4e8b\u9879\n\n\u672c\u6587\u6863\u8bb0\u5f55\u4e86 Claude Code \u63d2\u4ef6\u6e05\u5355\u6821\u9a8c\u5668\u4e2d**\u672a\u89c1\u4e8e\u6587\u6863\u4f46\u5f3a\u5236\u6267\u884c\u7684\u7ea6\u675f**\u3002\n\n\u8fd9\u4e9b\u89c4\u5219\u57fa\u4e8e\u771f\u5b9e\u7684\u5b89\u88c5\u5931\u8d25\u6848\u4f8b\u3001\u6821\u9a8c\u5668\u884c\u4e3a\u4ee5\u53ca\u4e0e\u5df2\u77e5\u53ef\u7528\u63d2\u4ef6\u7684\u5bf9\u6bd4\u3002\n\u8bbe\u7f6e\u8fd9\u4e9b\u89c4\u5219\u662f\u4e3a\u4e86\u9632\u6b62\u9690\u6027\u6545\u969c\u548c\u91cd\u590d\u7684\u56de\u5f52\u95ee\u9898\u3002\n\n\u5982\u679c\u4f60\u7f16\u8f91 `.claude-plugin/plugin.json`\uff0c\u8bf7\u5148\u9605\u8bfb\u672c\u6587\u3002\n\n---\n\n## \u6458\u8981\uff08\u4f18\u5148\u9605\u8bfb\uff09\n\nClaude \u63d2\u4ef6\u6e05\u5355\u6821\u9a8c\u5668**\u6781\u5176\u4e25\u683c\u4e14\u5177\u6709\u4e3b\u89c2\u6027**\u3002\n\u5b83\u6267\u884c\u4e86\u4e00\u4e9b\u5728\u516c\u5f00\u6a21\u5f0f\uff08Schema\uff09\u53c2\u8003\u6587\u6863\u4e2d\u672a\u5b8c\u5168\u8bf4\u660e\u7684\u89c4\u5219\u3002\n\n\u6700\u5e38\u89c1\u7684\u5931\u8d25\u6a21\u5f0f\u662f\uff1a\n\n> \u6e05\u5355\u770b\u8d77\u6765\u5f88\u5408\u7406\uff0c\u4f46\u6821\u9a8c\u5668\u4ee5\u6a21\u7cca\u7684\u9519\u8bef\u62d2\u7edd\u5b83\uff0c\u4f8b\u5982\uff1a\n> `agents: Invalid input`\n\n\u672c\u6587\u6863\u5c06\u89e3\u91ca\u5176\u539f\u56e0\u3002\n\n---\n\n## \u5fc5\u586b\u5b57\u6bb5\n\n### `version`\uff08\u5f3a\u5236\u6027\uff09\n\n\u5373\u4fbf\u5728\u67d0\u4e9b\u793a\u4f8b\u4e2d\u88ab\u7701\u7565\uff0c\u6821\u9a8c\u5668\u4e5f\u8981\u6c42\u5fc5\u987b\u5305\u542b `version` \u5b57\u6bb5\u3002\n\n\u5982\u679c\u7f3a\u5931\uff0c\u5728\u5e94\u7528\u5e02\u573a\u5b89\u88c5\u6216 CLI \u6821\u9a8c\u671f\u95f4\u53ef\u80fd\u4f1a\u5931\u8d25\u3002\n\n\u793a\u4f8b\uff1a\n\n```json\n{\n  \"version\": \"1.1.0\"\n}\n```\n\n---\n\n## \u5b57\u6bb5\u5f62\u6001\u89c4\u5219\n\n\u4ee5\u4e0b\u5b57\u6bb5**\u5fc5\u987b\u59cb\u7ec8\u4e3a\u6570\u7ec4\uff08Arrays\uff09**\uff1a\n\n* `agents`\n* `commands`\n* `skills`\n* `hooks`\uff08\u5982\u679c\u5b58\u5728\uff09\n\n\u5373\u4fbf\u53ea\u6709\u4e00\u4e2a\u6761\u76ee\uff0c**\u4e5f\u4e0d\u63a5\u53d7\u5b57\u7b26\u4e32\uff08Strings\uff09**\u3002\n\n### \u9519\u8bef\u5199\u6cd5\uff08Invalid\uff09\n\n```json\n{\n  \"agents\": \"./agents\"\n}\n```\n\n### \u6b63\u786e\u5199\u6cd5\uff08Valid\uff09\n\n```json\n{\n  \"agents\": [\"./agents/planner.md\"]\n}\n```\n\n\u8fd9\u9002\u7528\u4e8e\u6240\u6709\u7ec4\u4ef6\u8def\u5f84\u5b57\u6bb5\u3002\n\n---\n\n## \u8def\u5f84\u89e3\u6790\u89c4\u5219\uff08\u81f3\u5173\u91cd\u8981\uff09\n\n### Agents \u5fc5\u987b\u4f7f\u7528\u663e\u5f0f\u6587\u4ef6\u8def\u5f84\n\n\u6821\u9a8c\u5668**\u4e0d\u63a5\u53d7 `agents` \u4f7f\u7528\u76ee\u5f55\u8def\u5f84**\u3002\n\n\u5373\u4fbf\u5982\u4e0b\u5199\u6cd5\u4e5f\u4f1a\u5931\u8d25\uff1a\n\n```json\n{\n  \"agents\": [\"./agents/\"]\n}\n```\n\n\u76f8\u53cd\uff0c\u4f60\u5fc5\u987b\u663e\u5f0f\u5217\u4e3e\u667a\u80fd\u4f53\uff08Agent\uff09\u6587\u4ef6\uff1a\n\n```json\n{\n  \"agents\": [\n    \"./agents/planner.md\",\n    \"./agents/architect.md\",\n    \"./agents/code-reviewer.md\"\n  ]\n}\n```\n\n\u8fd9\u662f\u6821\u9a8c\u9519\u8bef\u6700\u5e38\u89c1\u7684\u6765\u6e90\u3002\n\n### Commands \u548c Skills\n\n* `commands` \u548c `skills` \u4ec5\u5728**\u5305\u88f9\u5728\u6570\u7ec4\u4e2d**\u65f6\u624d\u63a5\u53d7\u76ee\u5f55\u8def\u5f84\u3002\n* \u4f7f\u7528\u663e\u5f0f\u6587\u4ef6\u8def\u5f84\u662f\u6700\u5b89\u5168\u4e14\u9762\u5411\u672a\u6765\u7684\u505a\u6cd5\u3002\n\n---\n\n## \u6821\u9a8c\u5668\u884c\u4e3a\u5907\u6ce8\n\n* `claude plugin validate` \u6bd4\u67d0\u4e9b\u5e94\u7528\u5e02\u573a\u9884\u89c8\u66f4\u4e25\u683c\u3002\n* \u6821\u9a8c\u53ef\u80fd\u5728\u672c\u5730\u901a\u8fc7\uff0c\u4f46\u5982\u679c\u8def\u5f84\u542b\u4e49\u6a21\u7cca\uff0c\u5219\u5728\u5b89\u88c5\u65f6\u53ef\u80fd\u4f1a\u5931\u8d25\u3002\n* \u9519\u8bef\u901a\u5e38\u5f88\u7b3c\u7edf\uff08`Invalid input`\uff09\uff0c\u4e14\u4e0d\u6307\u793a\u6839\u672c\u539f\u56e0\u3002\n* \u8de8\u5e73\u53f0\u5b89\u88c5\uff08\u5c24\u5176\u662f Windows\uff09\u5bf9\u8def\u5f84\u5047\u8bbe\u7684\u5bb9\u5fcd\u5ea6\u8f83\u4f4e\u3002\n\n\u8bf7\u5047\u8bbe\u6821\u9a8c\u5668\u662f\u201c\u5e26\u6709\u654c\u610f\u7684\u201d\u4e14\u5b8c\u5168\u5b57\u9762\u5316\u7684\u3002\n\n---\n\n## \u5df2\u77e5\u7684\u53cd\u6a21\u5f0f\uff08Anti-Patterns\uff09\n\n\u8fd9\u4e9b\u770b\u8d77\u6765\u6b63\u786e\u4f46\u4f1a\u88ab\u62d2\u7edd\uff1a\n\n* \u4f7f\u7528\u5b57\u7b26\u4e32\u503c\u800c\u975e\u6570\u7ec4\n* \u4e3a `agents` \u63d0\u4f9b\u76ee\u5f55\u6570\u7ec4\n* \u7f3a\u5931 `version`\n* \u4f9d\u8d56\u63a8\u65ad\u8def\u5f84\n* \u5047\u8bbe\u5e94\u7528\u5e02\u573a\u7684\u884c\u4e3a\u4e0e\u672c\u5730\u6821\u9a8c\u4e00\u81f4\n\n\u4e0d\u8981\u800d\u5c0f\u806a\u660e\u3002\u8bf7\u4fdd\u6301\u663e\u5f0f\u3002\n\n---\n\n## \u6700\u5c0f\u5df2\u77e5\u6709\u6548\u793a\u4f8b\n\n```json\n{\n  \"version\": \"1.1.0\",\n  \"agents\": [\n    \"./agents/planner.md\",\n    \"./agents/code-reviewer.md\"\n  ],\n  \"commands\": [\"./commands/\"],\n  \"skills\": [\"./skills/\"]\n}\n```\n\n\u8be5\u7ed3\u6784\u5df2\u901a\u8fc7 Claude \u63d2\u4ef6\u6821\u9a8c\u5668\u7684\u9a8c\u8bc1\u3002\n\n---\n\n## \u5bf9\u8d21\u732e\u8005\u7684\u5efa\u8bae\n\n\u5728\u63d0\u4ea4\u6d89\u53ca `plugin.json` \u7684\u66f4\u6539\u4e4b\u524d\uff1a\n\n1. \u4e3a agents \u4f7f\u7528\u663e\u5f0f\u6587\u4ef6\u8def\u5f84\n2. \u786e\u4fdd\u6240\u6709\u7ec4\u4ef6\u5b57\u6bb5\u5747\u4e3a\u6570\u7ec4\n3. \u5305\u542b `version`\n4. \u8fd0\u884c\uff1a\n\n```bash\nclaude plugin validate .claude-plugin/plugin.json\n```\n\n\u5982\u6709\u7591\u95ee\uff0c\u5b81\u53ef\u7e41\u7410\u4e5f\u4e0d\u8981\u8ffd\u6c42\u4fbf\u5229\u3002\n\n---\n\n## \u4e3a\u4ec0\u4e48\u5b58\u5728\u6b64\u6587\u4ef6\n\n\u6b64\u4ed3\u5e93\u88ab\u5e7f\u6cdb fork \u5e76\u7528\u4f5c\u53c2\u8003\u5b9e\u73b0\u3002\n\n\u5728\u6b64\u8bb0\u5f55\u6821\u9a8c\u5668\u7684\u7279\u6027\uff1a\n\n* \u9632\u6b62\u91cd\u590d\u51fa\u73b0\u7684\u95ee\u9898\n* \u51cf\u5c11\u8d21\u732e\u8005\u7684\u632b\u8d25\u611f\n* \u968f\u7740\u751f\u6001\u7cfb\u7edf\u7684\u6f14\u8fdb\u4fdd\u6301\u63d2\u4ef6\u7684\u7a33\u5b9a\u6027\n\n\u5982\u679c\u6821\u9a8c\u5668\u53d1\u751f\u53d8\u5316\uff0c\u8bf7\u9996\u5148\u66f4\u65b0\u672c\u6587\u6863\u3002\n"
+    "md5": "a69e0dea61ca5b9d21cdcad00583402c",
+    "content": "# \u63d2\u4ef6\u6e05\u5355\u6a21\u5f0f\uff08Plugin Manifest Schema\uff09\u8bf4\u660e\n\n\u672c\u6587\u6863\u8bb0\u5f55\u4e86 Claude Code \u63d2\u4ef6\u6e05\u5355\u6821\u9a8c\u5668\uff08Validator\uff09\u4e2d**\u672a\u516c\u5f00\u4f46\u5f3a\u5236\u6267\u884c\u7684\u7ea6\u675f\u6761\u4ef6**\u3002\n\n\u8fd9\u4e9b\u89c4\u5219\u57fa\u4e8e\u771f\u5b9e\u7684\u5b89\u88c5\u5931\u8d25\u6848\u4f8b\u3001\u6821\u9a8c\u5668\u884c\u4e3a\u5206\u6790\u4ee5\u53ca\u4e0e\u5df2\u77e5\u53ef\u7528\u63d2\u4ef6\u7684\u5bf9\u6bd4\u3002\n\u5b83\u4eec\u7684\u5b58\u5728\u662f\u4e3a\u4e86\u9632\u6b62\u9690\u6027\u7834\u574f\uff08silent breakage\uff09\u548c\u91cd\u590d\u51fa\u73b0\u7684\u56de\u5f52\uff08regressions\uff09\u95ee\u9898\u3002\n\n\u5982\u679c\u4f60\u9700\u8981\u7f16\u8f91 `.claude-plugin/plugin.json`\uff0c\u8bf7\u52a1\u5fc5\u5148\u9605\u8bfb\u672c\u6587\u3002\n\n---\n\n## \u6458\u8981\uff08\u4f18\u5148\u9605\u8bfb\uff09\n\nClaude \u63d2\u4ef6\u6e05\u5355\u6821\u9a8c\u5668\u975e\u5e38**\u4e25\u683c\u4e14\u5177\u6709\u786e\u5b9a\u6027**\u3002\n\u5b83\u5f3a\u5236\u6267\u884c\u4e86\u4e00\u4e9b\u5728\u516c\u5171\u6a21\u5f0f\uff08Schema\uff09\u5f15\u7528\u4e2d\u672a\u5b8c\u5168\u8bb0\u5f55\u7684\u89c4\u5219\u3002\n\n\u6700\u5e38\u89c1\u7684\u5931\u8d25\u6a21\u5f0f\u662f\uff1a\n\n> \u6e05\u5355\u770b\u8d77\u6765\u5f88\u5408\u7406\uff0c\u4f46\u6821\u9a8c\u5668\u62d2\u7edd\u4e86\u5b83\uff0c\u5e76\u7ed9\u51fa\u6a21\u7cca\u7684\u9519\u8bef\u63d0\u793a\uff0c\u4f8b\u5982\n> `agents: Invalid input`\n\n\u672c\u6587\u6863\u5c06\u89e3\u91ca\u5176\u539f\u56e0\u3002\n\n---\n\n## \u5fc5\u586b\u5b57\u6bb5\n\n### `version`\uff08\u5f3a\u5236\u8981\u6c42\uff09\n\n\u6821\u9a8c\u5668\u8981\u6c42\u5fc5\u987b\u5305\u542b `version` \u5b57\u6bb5\uff0c\u5373\u4f7f\u5728\u67d0\u4e9b\u793a\u4f8b\u4e2d\u7701\u7565\u4e86\u5b83\u3002\n\n\u5982\u679c\u7f3a\u5931\u8be5\u5b57\u6bb5\uff0c\u5728\u5e94\u7528\u5e02\u573a\u5b89\u88c5\u6216 CLI \u6821\u9a8c\u671f\u95f4\u53ef\u80fd\u4f1a\u5931\u8d25\u3002\n\n\u793a\u4f8b\uff1a\n\n```json\n{\n  \"version\": \"1.1.0\"\n}\n```\n\n---\n\n## \u5b57\u6bb5\u5f62\u6001\u89c4\u5219\n\n\u4ee5\u4e0b\u5b57\u6bb5**\u5fc5\u987b\u59cb\u7ec8\u4e3a\u6570\u7ec4\uff08Arrays\uff09**\uff1a\n\n* `agents`\n* `commands`\n* `skills`\n* `hooks`\uff08\u5982\u679c\u5b58\u5728\uff09\n\n\u5373\u4f7f\u53ea\u6709\u4e00\u4e2a\u6761\u76ee\uff0c**\u4e5f\u4e0d\u63a5\u53d7\u5b57\u7b26\u4e32\uff08Strings\uff09\u7c7b\u578b**\u3002\n\n### \u9519\u8bef\u793a\u4f8b\uff08Invalid\uff09\n\n```json\n{\n  \"agents\": \"./agents\"\n}\n```\n\n### \u6b63\u786e\u793a\u4f8b\uff08Valid\uff09\n\n```json\n{\n  \"agents\": [\"./agents/planner.md\"]\n}\n```\n\n\u8fd9\u4e00\u89c4\u5219\u4e00\u81f4\u9002\u7528\u4e8e\u6240\u6709\u7ec4\u4ef6\u8def\u5f84\u5b57\u6bb5\u3002\n\n---\n\n## \u8def\u5f84\u89e3\u6790\u89c4\u5219\uff08\u5173\u952e\uff09\n\n### Agents \u5fc5\u987b\u4f7f\u7528\u663e\u5f0f\u6587\u4ef6\u8def\u5f84\n\n\u6821\u9a8c\u5668**\u4e0d\u63a5\u53d7 `agents` \u5b57\u6bb5\u4f7f\u7528\u76ee\u5f55\u8def\u5f84**\u3002\n\n\u5373\u4f7f\u662f\u4ee5\u4e0b\u5199\u6cd5\u4e5f\u4f1a\u5931\u8d25\uff1a\n\n```json\n{\n  \"agents\": [\"./agents/\"]\n}\n```\n\n\u76f8\u53cd\uff0c\u4f60\u5fc5\u987b\u663e\u5f0f\u679a\u4e3e\u667a\u80fd\u4f53\uff08Agent\uff09\u6587\u4ef6\uff1a\n\n```json\n{\n  \"agents\": [\n    \"./agents/planner.md\",\n    \"./agents/architect.md\",\n    \"./agents/code-reviewer.md\"\n  ]\n}\n```\n\n\u8fd9\u662f\u6821\u9a8c\u9519\u8bef\u6700\u5e38\u89c1\u7684\u6765\u6e90\u3002\n\n### \u547d\u4ee4\uff08Commands\uff09\u4e0e\u6280\u80fd\uff08Skills\uff09\n\n* `commands` \u548c `skills` **\u4ec5\u5728\u5305\u88f9\u5728\u6570\u7ec4\u4e2d\u65f6**\u63a5\u53d7\u76ee\u5f55\u8def\u5f84\u3002\n* \u663e\u5f0f\u6587\u4ef6\u8def\u5f84\u662f\u6700\u5b89\u5168\u4e14\u6700\u80fd\u517c\u5bb9\u672a\u6765\u7684\u505a\u6cd5\u3002\n\n---\n\n## \u6821\u9a8c\u5668\u884c\u4e3a\u6ce8\u610f\u4e8b\u9879\n\n* `claude plugin validate` \u6bd4\u67d0\u4e9b\u5e94\u7528\u5e02\u573a\u9884\u89c8\uff08marketplace previews\uff09\u66f4\u4e25\u683c\u3002\n* \u6821\u9a8c\u53ef\u80fd\u5728\u672c\u5730\u901a\u8fc7\uff0c\u4f46\u5982\u679c\u8def\u5f84\u542b\u4e49\u6a21\u7cca\uff0c\u5728\u5b89\u88c5\u65f6\u53ef\u80fd\u4f1a\u5931\u8d25\u3002\n* \u9519\u8bef\u63d0\u793a\u901a\u5e38\u5f88\u901a\u7528\uff08`Invalid input`\uff09\uff0c\u4e14\u4e0d\u4f1a\u6307\u51fa\u6839\u672c\u539f\u56e0\u3002\n* \u8de8\u5e73\u53f0\u5b89\u88c5\uff08\u5c24\u5176\u662f Windows\uff09\u5bf9\u8def\u5f84\u5047\u8bbe\u7684\u5bb9\u5fcd\u5ea6\u8f83\u4f4e\u3002\n\n\u8bf7\u5047\u8bbe\u6821\u9a8c\u5668\u662f\u4e25\u82db\u4e14\u5b8c\u5168\u6309\u5b57\u9762\u610f\u601d\u7406\u89e3\u7684\u3002\n\n---\n\n## `hooks` \u5b57\u6bb5\uff1a\u8bf7\u52ff\u6dfb\u52a0\n\n> \u26a0\ufe0f **\u5173\u952e\uff08CRITICAL\uff09\uff1a** \u8bf7\u52ff\u5728 `plugin.json` \u4e2d\u6dfb\u52a0 `\"hooks\"` \u5b57\u6bb5\u3002\u8fd9\u662f\u4e00\u4e2a\u56de\u5f52\u6d4b\u8bd5\u5f3a\u5236\u8981\u6c42\u7684\u89c4\u5219\u3002\n\n### \u4e3a\u4ec0\u4e48\u8fd9\u5f88\u91cd\u8981\n\n\u6309\u7167\u7ea6\u5b9a\uff0cClaude Code v2.1+ \u4f1a**\u81ea\u52a8\u52a0\u8f7d**\u4efb\u4f55\u5df2\u5b89\u88c5\u63d2\u4ef6\u4e2d\u7684 `hooks/hooks.json`\u3002\u5982\u679c\u4f60\u5728 `plugin.json` \u4e2d\u4e5f\u58f0\u660e\u4e86\u5b83\uff0c\u4f60\u4f1a\u5f97\u5230\uff1a\n\n```\nDuplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file.\nThe standard hooks/hooks.json is loaded automatically, so manifest.hooks should\nonly reference additional hook files.\n```\n\n### \u53cd\u590d\u53d8\u66f4\u7684\u5386\u53f2\n\n\u8fd9\u66fe\u5bfc\u81f4\u6b64\u4ed3\u5e93\u4e2d\u51fa\u73b0\u591a\u6b21\u201c\u4fee\u590d/\u56de\u6eda\u201d\u5faa\u73af\uff1a\n\n| \u63d0\u4ea4 | \u52a8\u4f5c | \u89e6\u53d1\u539f\u56e0 |\n|--------|--------|---------|\n| `22ad036` | \u6dfb\u52a0\uff08ADD\uff09hooks | \u7528\u6237\u62a5\u544a\u201c\u94a9\u5b50\u672a\u52a0\u8f7d\u201d |\n| `a7bc5f2` | \u79fb\u9664\uff08REMOVE\uff09hooks | \u7528\u6237\u62a5\u544a\u201c\u91cd\u590d\u94a9\u5b50\u9519\u8bef\u201d (#52) |\n| `779085e` | \u6dfb\u52a0\uff08ADD\uff09hooks | \u7528\u6237\u62a5\u544a\u201c\u667a\u80fd\u4f53\u672a\u52a0\u8f7d\u201d (#88) |\n| `e3a1306` | \u79fb\u9664\uff08REMOVE\uff09hooks | \u7528\u6237\u62a5\u544a\u201c\u91cd\u590d\u94a9\u5b50\u9519\u8bef\u201d (#103) |\n\n**\u6839\u672c\u539f\u56e0\uff1a** Claude Code CLI \u5728\u4e0d\u540c\u7248\u672c\u95f4\u66f4\u6539\u4e86\u884c\u4e3a\uff1a\n- v2.1 \u4e4b\u524d\uff1a\u9700\u8981\u663e\u5f0f\u58f0\u660e `hooks`\u3002\n- v2.1+\uff1a\u6309\u7ea6\u5b9a\u81ea\u52a8\u52a0\u8f7d\uff0c\u663e\u5f0f\u58f0\u660e\u4f1a\u5bfc\u81f4\u91cd\u590d\u9519\u8bef\u3002\n\n### \u5f53\u524d\u89c4\u5219\uff08\u7531\u6d4b\u8bd5\u5f3a\u5236\u6267\u884c\uff09\n\n`tests/hooks/hooks.test.js` \u4e2d\u7684\u6d4b\u8bd5 `plugin.json does NOT have explicit hooks declaration` \u4f1a\u963b\u6b62\u91cd\u65b0\u5f15\u5165\u6b64\u58f0\u660e\u3002\n\n**\u5982\u679c\u4f60\u8981\u6dfb\u52a0\u989d\u5916\u7684\u94a9\u5b50\u6587\u4ef6**\uff08\u975e `hooks/hooks.json`\uff09\uff0c\u53ef\u4ee5\u58f0\u660e\u5b83\u4eec\u3002\u4f46\u6807\u51c6\u8def\u5f84 `hooks/hooks.json` **\u7edd\u4e0d\u80fd**\u88ab\u58f0\u660e\u3002\n\n---\n\n## \u5df2\u77e5\u7684\u53cd\u6a21\u5f0f\uff08Anti-Patterns\uff09\n\n\u8fd9\u4e9b\u770b\u8d77\u6765\u6b63\u786e\u4f46\u4f1a\u88ab\u62d2\u7edd\uff1a\n\n* \u4f7f\u7528\u5b57\u7b26\u4e32\u503c\u800c\u975e\u6570\u7ec4\n* \u5728 `agents` \u4e2d\u4f7f\u7528\u76ee\u5f55\u6570\u7ec4\n* \u7f3a\u5931 `version`\n* \u4f9d\u8d56\u63a8\u65ad\u8def\u5f84\n* \u5047\u8bbe\u5e94\u7528\u5e02\u573a\u884c\u4e3a\u4e0e\u672c\u5730\u6821\u9a8c\u4e00\u81f4\n* **\u6dfb\u52a0 `\"hooks\": \"./hooks/hooks.json\"`** \u2014\u2014 \u6309\u7ea6\u5b9a\u81ea\u52a8\u52a0\u8f7d\uff0c\u4f1a\u5bfc\u81f4\u91cd\u590d\u9519\u8bef\n\n\u4e0d\u8981\u5c1d\u8bd5\u201c\u53d6\u5de7\u201d\uff0c\u8bf7\u4fdd\u6301\u663e\u5f0f\u58f0\u660e\u3002\n\n---\n\n## \u6700\u5c0f\u5df2\u77e5\u53ef\u7528\u793a\u4f8b\n\n```json\n{\n  \"version\": \"1.1.0\",\n  \"agents\": [\n    \"./agents/planner.md\",\n    \"./agents/code-reviewer.md\"\n  ],\n  \"commands\": [\"./commands/\"],\n  \"skills\": [\"./skills/\"]\n}\n```\n\n\u6b64\u7ed3\u6784\u5df2\u901a\u8fc7 Claude \u63d2\u4ef6\u6821\u9a8c\u5668\u7684\u9a8c\u8bc1\u3002\n\n**\u91cd\u8981\u63d0\u793a\uff1a** \u8bf7\u6ce8\u610f\u8fd9\u91cc**\u6ca1\u6709** `\"hooks\"` \u5b57\u6bb5\u3002`hooks/hooks.json` \u6587\u4ef6\u4f1a\u6309\u7ea6\u5b9a\u81ea\u52a8\u52a0\u8f7d\u3002\u663e\u5f0f\u6dfb\u52a0\u5b83\u4f1a\u5bfc\u81f4\u91cd\u590d\u9519\u8bef\u3002\n\n---\n\n## \u8d21\u732e\u8005\u5efa\u8bae\n\n\u5728\u63d0\u4ea4\u6d89\u53ca `plugin.json` \u7684\u66f4\u6539\u524d\uff1a\n\n1. \u4e3a\u667a\u80fd\u4f53\uff08Agents\uff09\u4f7f\u7528\u663e\u5f0f\u6587\u4ef6\u8def\u5f84\n2. \u786e\u4fdd\u6240\u6709\u7ec4\u4ef6\u5b57\u6bb5\u5747\u4e3a\u6570\u7ec4\n3. \u5305\u542b `version` \u5b57\u6bb5\n4. \u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\uff1a\n\n```bash\nclaude plugin validate .claude-plugin/plugin.json\n```\n\n\u5982\u6709\u7591\u95ee\uff0c\u5b81\u53ef\u7e41\u7410\u4e5f\u4e0d\u8981\u4e3a\u4e86\u65b9\u4fbf\u800c\u5bfc\u81f4\u89e3\u6790\u5931\u8d25\u3002\n\n---\n\n## \u4e3a\u4ec0\u4e48\u5b58\u5728\u6b64\u6587\u4ef6\n\n\u6b64\u4ed3\u5e93\u88ab\u5e7f\u6cdb Fork \u5e76\u4f5c\u4e3a\u53c2\u8003\u5b9e\u73b0\u3002\n\n\u5728\u6b64\u8bb0\u5f55\u6821\u9a8c\u5668\u7684\u5947\u7279\u884c\u4e3a\uff08quirks\uff09\u662f\u4e3a\u4e86\uff1a\n\n* \u9632\u6b62\u91cd\u590d\u51fa\u73b0\u7684\u95ee\u9898\n* \u51cf\u5c11\u8d21\u732e\u8005\u7684\u632b\u8d25\u611f\n* \u968f\u7740\u751f\u6001\u7cfb\u7edf\u7684\u6f14\u8fdb\u4fdd\u6301\u63d2\u4ef6\u7684\u7a33\u5b9a\u6027\n\n\u5982\u679c\u6821\u9a8c\u5668\u89c4\u5219\u53d1\u751f\u53d8\u5316\uff0c\u8bf7\u9996\u5148\u66f4\u65b0\u6b64\u6587\u6863\u3002\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/rules/coding-style.md": {
     "md5": "4b5e30879949693a07774266651d2663",
@@ -240,28 +240,28 @@
     "content": "---\nname: continuous-learning\ndescription: \u81ea\u52a8\u4ece Claude Code \u4f1a\u8bdd\uff08Sessions\uff09\u4e2d\u63d0\u53d6\u53ef\u91cd\u7528\u7684\u6a21\u5f0f\uff0c\u5e76\u5c06\u5176\u4fdd\u5b58\u4e3a\u5b66\u4e60\u5230\u7684\u6280\u80fd\u4ee5\u4f9b\u672a\u6765\u4f7f\u7528\u3002\n---\n\n# \u6301\u7eed\u5b66\u4e60\u6280\u80fd\uff08Continuous Learning Skill\uff09\n\n\u5728\u4f1a\u8bdd\u7ed3\u675f\u65f6\u81ea\u52a8\u8bc4\u4f30 Claude Code \u4f1a\u8bdd\uff08Sessions\uff09\uff0c\u4ee5\u63d0\u53d6\u53ef\u4fdd\u5b58\u4e3a\u5b66\u4e60\u6280\u80fd\uff08Learned Skills\uff09\u7684\u53ef\u91cd\u7528\u6a21\u5f0f\u3002\n\n## \u5de5\u4f5c\u539f\u7406\n\n\u8be5\u6280\u80fd\u4f5c\u4e3a **\u505c\u6b62\u94a9\u5b50\uff08Stop hook\uff09** \u5728\u6bcf\u4e2a\u4f1a\u8bdd\u7ed3\u675f\u65f6\u8fd0\u884c\uff1a\n\n1. **\u4f1a\u8bdd\u8bc4\u4f30\uff08Session Evaluation\uff09**\uff1a\u68c0\u67e5\u4f1a\u8bdd\u662f\u5426\u6709\u8db3\u591f\u7684\u6d88\u606f\uff08\u9ed8\u8ba4\uff1a10 \u6761\u4ee5\u4e0a\uff09\n2. **\u6a21\u5f0f\u68c0\u6d4b\uff08Pattern Detection\uff09**\uff1a\u8bc6\u522b\u4f1a\u8bdd\u4e2d\u53ef\u63d0\u53d6\u7684\u6a21\u5f0f\n3. **\u6280\u80fd\u63d0\u53d6\uff08Skill Extraction\uff09**\uff1a\u5c06\u6709\u7528\u7684\u6a21\u5f0f\u4fdd\u5b58\u5230 `~/.claude/skills/learned/`\n\n## \u914d\u7f6e\n\n\u7f16\u8f91 `config.json` \u8fdb\u884c\u81ea\u5b9a\u4e49\uff1a\n\n```json\n{\n  \"min_session_length\": 10,\n  \"extraction_threshold\": \"medium\",\n  \"auto_approve\": false,\n  \"learned_skills_path\": \"~/.claude/skills/learned/\",\n  \"patterns_to_detect\": [\n    \"error_resolution\",\n    \"user_corrections\",\n    \"workarounds\",\n    \"debugging_techniques\",\n    \"project_specific\"\n  ],\n  \"ignore_patterns\": [\n    \"simple_typos\",\n    \"one_time_fixes\",\n    \"external_api_issues\"\n  ]\n}\n```\n\n## \u6a21\u5f0f\u7c7b\u578b\n\n| \u6a21\u5f0f\uff08Pattern\uff09 | \u63cf\u8ff0\uff08Description\uff09 |\n|---------|-------------|\n| `error_resolution` | \u7279\u5b9a\u9519\u8bef\u7684\u89e3\u51b3\u65b9\u5f0f |\n| `user_corrections` | \u6765\u81ea\u7528\u6237\u4fee\u6b63\u7684\u6a21\u5f0f |\n| `workarounds` | \u6846\u67b6/\u5e93\u7279\u6709\u95ee\u9898\u7684\u53d8\u901a\u65b9\u6848 |\n| `debugging_techniques` | \u6709\u6548\u7684\u8c03\u8bd5\u65b9\u6cd5 |\n| `project_specific` | \u9879\u76ee\u7279\u5b9a\u7684\u7ea6\u5b9a |\n\n## \u94a9\u5b50\u8bbe\u7f6e\uff08Hook Setup\uff09\n\n\u6dfb\u52a0\u5230\u4f60\u7684 `~/.claude/settings.json`\uff1a\n\n```json\n{\n  \"hooks\": {\n    \"Stop\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"~/.claude/skills/continuous-learning/evaluate-session.sh\"\n      }]\n    }]\n  }\n}\n```\n\n## \u4e3a\u4ec0\u4e48\u4f7f\u7528\u505c\u6b62\u94a9\u5b50\uff08Stop Hook\uff09\uff1f\n\n- **\u8f7b\u91cf\u7ea7\uff08Lightweight\uff09**\uff1a\u5728\u4f1a\u8bdd\u7ed3\u675f\u65f6\u8fd0\u884c\u4e00\u6b21\n- **\u975e\u963b\u585e\uff08Non-blocking\uff09**\uff1a\u4e0d\u4f1a\u7ed9\u6bcf\u6761\u6d88\u606f\u589e\u52a0\u5ef6\u8fdf\n- **\u5b8c\u6574\u4e0a\u4e0b\u6587\uff08Complete context\uff09**\uff1a\u53ef\u4ee5\u8bbf\u95ee\u5b8c\u6574\u7684\u4f1a\u8bdd\u8bb0\u5f55\n\n## \u76f8\u5173\u5185\u5bb9\n\n- [\u957f\u7bc7\u6307\u5357\uff08The Longform Guide\uff09](https://x.com/affaanmustafa/status/2014040193557471352) - \u5173\u4e8e\u6301\u7eed\u5b66\u4e60\u7684\u90e8\u5206\n- `/learn` \u547d\u4ee4 - \u5728\u4f1a\u8bdd\u4e2d\u624b\u52a8\u63d0\u53d6\u6a21\u5f0f\n\n---\n\n## \u5bf9\u6bd4\u7b14\u8bb0\uff08\u7814\u7a76\uff1a2025\u5e741\u6708\uff09\n\n### vs Homunculus (github.com/humanplane/homunculus)\n\nHomunculus v2 \u91c7\u7528\u4e86\u66f4\u590d\u6742\u7684\u65b9\u6cd5\uff1a\n\n| \u7279\u6027\uff08Feature\uff09 | \u6211\u4eec\u7684\u65b9\u6cd5\uff08Our Approach\uff09 | Homunculus v2 |\n|---------|--------------|---------------|\n| \u89c2\u6d4b\uff08Observation\uff09 | \u505c\u6b62\u94a9\u5b50\uff08Stop hook\uff0c\u4f1a\u8bdd\u7ed3\u675f\u65f6\uff09 | PreToolUse/PostToolUse \u94a9\u5b50\uff08100% \u53ef\u9760\uff09 |\n| \u5206\u6790\uff08Analysis\uff09 | \u4e3b\u4e0a\u4e0b\u6587\uff08Main context\uff09 | \u540e\u53f0\u667a\u80fd\u4f53\uff08Background agent\uff0cHaiku\uff09 |\n| \u7c92\u5ea6\uff08Granularity\uff09 | \u5b8c\u6574\u6280\u80fd\uff08Full skills\uff09 | \u539f\u5b50\u5316\u7684\u201c\u672c\u80fd\uff08instincts\uff09\u201d |\n| \u7f6e\u4fe1\u5ea6\uff08Confidence\uff09 | \u65e0 | 0.3-0.9 \u52a0\u6743 |\n| \u6f14\u8fdb\uff08Evolution\uff09 | \u76f4\u63a5\u8f6c\u5316\u4e3a\u6280\u80fd | \u672c\u80fd\uff08Instincts\uff09\u2192 \u805a\u7c7b\uff08cluster\uff09\u2192 \u6280\u80fd/\u547d\u4ee4/\u667a\u80fd\u4f53 |\n| \u5171\u4eab\uff08Sharing\uff09 | \u65e0 | \u5bfc\u51fa/\u5bfc\u5165\u672c\u80fd |\n\n**\u6765\u81ea homunculus \u7684\u5173\u952e\u6d1e\u5bdf\uff1a**\n> \u201cv1 \u4f9d\u8d56\u6280\u80fd\u8fdb\u884c\u89c2\u6d4b\u3002\u6280\u80fd\u662f\u6982\u7387\u6027\u7684\u2014\u2014\u5b83\u4eec\u7684\u89e6\u53d1\u7387\u7ea6\u4e3a 50-80%\u3002v2 \u4f7f\u7528\u94a9\u5b50\u8fdb\u884c\u89c2\u6d4b\uff08100% \u53ef\u9760\uff09\uff0c\u5e76\u5c06\u672c\u80fd\uff08instincts\uff09\u4f5c\u4e3a\u5b66\u4e60\u884c\u4e3a\u7684\u539f\u5b50\u5355\u4f4d\u3002\u201d\n\n### \u6f5c\u5728\u7684 v2 \u589e\u5f3a\u529f\u80fd\n\n1. **\u57fa\u4e8e\u672c\u80fd\u7684\u5b66\u4e60\uff08Instinct-based learning\uff09** - \u5e26\u6709\u7f6e\u4fe1\u5ea6\u8bc4\u5206\u7684\u5c0f\u578b\u539f\u5b50\u5316\u884c\u4e3a\n2. **\u540e\u53f0\u89c2\u6d4b\u5668\uff08Background observer\uff09** - \u5e76\u884c\u5206\u6790\u7684 Haiku \u667a\u80fd\u4f53\n3. **\u7f6e\u4fe1\u5ea6\u8870\u51cf\uff08Confidence decay\uff09** - \u5982\u679c\u51fa\u73b0\u77db\u76fe\uff0c\u672c\u80fd\u5c06\u5931\u53bb\u7f6e\u4fe1\u5ea6\n4. **\u9886\u57df\u6807\u7b7e\uff08Domain tagging\uff09** - \u4ee3\u7801\u98ce\u683c\uff08code-style\uff09\u3001\u6d4b\u8bd5\uff08testing\uff09\u3001git\u3001\u8c03\u8bd5\uff08debugging\uff09\u7b49\n5. **\u6f14\u8fdb\u8def\u5f84\uff08Evolution path\uff09** - \u5c06\u76f8\u5173\u7684\u672c\u80fd\u805a\u7c7b\u4e3a\u6280\u80fd/\u547d\u4ee4\n\n\u53c2\u89c1\uff1a`/Users/affoon/Documents/tasks/12-continuous-learning-v2.md` \u4ee5\u83b7\u53d6\u5b8c\u6574\u89c4\u8303\u3002\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/continuous-learning-v2/SKILL.md": {
-    "md5": "dbec664c39a70f339a8f9457549aed71",
-    "content": "---\nname: continuous-learning-v2\ndescription: \u57fa\u4e8e\u76f4\u89c9\u7684\u5b66\u4e60\u7cfb\u7edf\uff0c\u901a\u8fc7\u94a9\u5b50\uff08hooks\uff09\u89c2\u5bdf\u4f1a\u8bdd\uff0c\u521b\u5efa\u5e26\u6709\u7f6e\u4fe1\u5ea6\u8bc4\u5206\u7684\u539f\u5b50\u76f4\u89c9\uff08atomic instincts\uff09\uff0c\u5e76\u5c06\u5176\u6f14\u5316\u4e3a\u6280\u80fd/\u547d\u4ee4/\u667a\u80fd\u4f53\u3002\nversion: 2.0.0\n---\n\n# \u6301\u7eed\u5b66\u4e60 v2 - \u57fa\u4e8e\u76f4\u89c9\u7684\u67b6\u6784 (Instinct-Based Architecture)\n\n\u4e00\u4e2a\u9ad8\u7ea7\u5b66\u4e60\u7cfb\u7edf\uff0c\u901a\u8fc7\u539f\u5b50\u201c\u76f4\u89c9\uff08instincts\uff09\u201d\u2014\u2014\u5e26\u6709\u7f6e\u4fe1\u5ea6\u8bc4\u5206\u7684\u5c0f\u578b\u4e60\u5f97\u884c\u4e3a\uff0c\u5c06\u4f60\u7684 Claude Code \u4f1a\u8bdd\u8f6c\u5316\u4e3a\u53ef\u590d\u7528\u7684\u77e5\u8bc6\u3002\n\n## v2 \u7248\u672c\u65b0\u7279\u6027\n\n| \u7279\u6027 | v1 | v2 |\n|---------|----|----|\n| \u89c2\u5bdf (Observation) | Stop \u94a9\u5b50\uff08\u4f1a\u8bdd\u7ed3\u675f\uff09 | PreToolUse/PostToolUse (100% \u53ef\u9760) |\n| \u5206\u6790 (Analysis) | \u4e3b\u4e0a\u4e0b\u6587 (Main context) | \u540e\u53f0\u667a\u80fd\u4f53 (Haiku) |\n| \u7c92\u5ea6 (Granularity) | \u5b8c\u6574\u6280\u80fd (Full skills) | \u539f\u5b50\u201c\u76f4\u89c9\uff08instincts\uff09\u201d |\n| \u7f6e\u4fe1\u5ea6 (Confidence) | \u65e0 | 0.3-0.9 \u52a0\u6743 |\n| \u6f14\u5316 (Evolution) | \u76f4\u63a5\u8f6c\u6362\u4e3a\u6280\u80fd | \u76f4\u89c9 \u2192 \u805a\u7c7b \u2192 \u6280\u80fd/\u547d\u4ee4/\u667a\u80fd\u4f53 |\n| \u5171\u4eab (Sharing) | \u65e0 | \u5bfc\u51fa/\u5bfc\u5165\u76f4\u89c9 |\n\n## \u76f4\u89c9\u6a21\u578b (The Instinct Model)\n\n\u201c\u76f4\u89c9\uff08instinct\uff09\u201d\u662f\u4e00\u4e2a\u5c0f\u578b\u7684\u4e60\u5f97\u884c\u4e3a\uff1a\n\n```yaml\n---\nid: prefer-functional-style\ntrigger: \"when writing new functions\"\nconfidence: 0.7\ndomain: \"code-style\"\nsource: \"session-observation\"\n---\n\n# \u504f\u597d\u51fd\u6570\u5f0f\u98ce\u683c (Prefer Functional Style)\n\n## \u64cd\u4f5c (Action)\n\u5728\u5408\u9002\u7684\u65f6\u5019\uff0c\u4f18\u5148\u4f7f\u7528\u51fd\u6570\u5f0f\u6a21\u5f0f\u800c\u975e\u7c7b\uff08class\uff09\u3002\n\n## \u8bc1\u636e (Evidence)\n- \u89c2\u5bdf\u5230 5 \u6b21\u504f\u597d\u51fd\u6570\u5f0f\u6a21\u5f0f\u7684\u5b9e\u4f8b\n- \u7528\u6237\u5728 2025-01-15 \u5c06\u57fa\u4e8e\u7c7b\u7684\u65b9\u6cd5\u4fee\u6b63\u4e3a\u51fd\u6570\u5f0f\n```\n\n**\u5c5e\u6027\uff1a**\n- **\u539f\u5b50\u6027 (Atomic)** \u2014 \u4e00\u4e2a\u89e6\u53d1\u5668\uff0c\u4e00\u4e2a\u52a8\u4f5c\n- **\u7f6e\u4fe1\u5ea6\u52a0\u6743 (Confidence-weighted)** \u2014 0.3 = \u5c1d\u8bd5\u6027\u7684\uff0c0.9 = \u8fd1\u4e4e\u786e\u5b9a\n- **\u9886\u57df\u6807\u7b7e (Domain-tagged)** \u2014 code-style\u3001testing\u3001git\u3001debugging\u3001workflow \u7b49\n- **\u8bc1\u636e\u652f\u6301 (Evidence-backed)** \u2014 \u8ffd\u8e2a\u662f\u54ea\u4e9b\u89c2\u5bdf\u7ed3\u679c\u521b\u5efa\u4e86\u5b83\n\n## \u5de5\u4f5c\u539f\u7406\n\n```\n\u4f1a\u8bdd\u6d3b\u52a8 (Session Activity)\n      \u2502\n      \u2502 \u94a9\u5b50\u6355\u83b7\u63d0\u793a\u8bcd + \u5de5\u5177\u4f7f\u7528 (100% \u53ef\u9760)\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502         observations.jsonl              \u2502\n\u2502   (\u63d0\u793a\u8bcd, \u5de5\u5177\u8c03\u7528, \u7ed3\u679c)                 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n      \u2502\n      \u2502 \u89c2\u5bdf\u8005\u667a\u80fd\u4f53\u8bfb\u53d6 (\u540e\u53f0\u8fd0\u884c, Haiku)\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502          \u6a21\u5f0f\u68c0\u6d4b (PATTERN DETECTION)    \u2502\n\u2502   \u2022 \u7528\u6237\u4fee\u6b63 \u2192 \u76f4\u89c9                       \u2502\n\u2502   \u2022 \u9519\u8bef\u4fee\u590d \u2192 \u76f4\u89c9                       \u2502\n\u2502   \u2022 \u91cd\u590d\u5de5\u4f5c\u6d41 \u2192 \u76f4\u89c9                     \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n      \u2502\n      \u2502 \u521b\u5efa/\u66f4\u65b0\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502         instincts/personal/             \u2502\n\u2502   \u2022 prefer-functional.md (0.7)          \u2502\n\u2502   \u2022 always-test-first.md (0.9)          \u2502\n\u2502   \u2022 use-zod-validation.md (0.6)         \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n      \u2502\n      \u2502 /evolve \u805a\u7c7b\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502              evolved/                   \u2502\n\u2502   \u2022 commands/new-feature.md             \u2502\n\u2502   \u2022 skills/testing-workflow.md          \u2502\n\u2502   \u2022 agents/refactor-specialist.md       \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## \u5feb\u901f\u5f00\u59cb\n\n### 1. \u542f\u7528\u89c2\u5bdf\u94a9\u5b50 (Observation Hooks)\n\n\u6dfb\u52a0\u5230\u4f60\u7684 `~/.claude/settings.json`\uff1a\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"~/.claude/skills/continuous-learning-v2/hooks/observe.sh pre\"\n      }]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"~/.claude/skills/continuous-learning-v2/hooks/observe.sh post\"\n      }]\n    }]\n  }\n}\n```\n\n### 2. \u521d\u59cb\u5316\u76ee\u5f55\u7ed3\u6784\n\n```bash\nmkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands}}\ntouch ~/.claude/homunculus/observations.jsonl\n```\n\n### 3. \u8fd0\u884c\u89c2\u5bdf\u8005\u667a\u80fd\u4f53 (\u53ef\u9009)\n\n\u89c2\u5bdf\u8005\u53ef\u4ee5\u5728\u540e\u53f0\u8fd0\u884c\uff0c\u5206\u6790\u89c2\u5bdf\u7ed3\u679c\uff1a\n\n```bash\n# \u542f\u52a8\u540e\u53f0\u89c2\u5bdf\u8005\n~/.claude/skills/continuous-learning-v2/agents/start-observer.sh\n```\n\n## \u547d\u4ee4\n\n| \u547d\u4ee4 | \u63cf\u8ff0 |\n|---------|-------------|\n| `/instinct-status` | \u663e\u793a\u6240\u6709\u4e60\u5f97\u7684\u76f4\u89c9\u53ca\u5176\u7f6e\u4fe1\u5ea6 |\n| `/evolve` | \u5c06\u76f8\u5173\u7684\u76f4\u89c9\u805a\u7c7b\u4e3a\u6280\u80fd/\u547d\u4ee4 |\n| `/instinct-export` | \u5bfc\u51fa\u76f4\u89c9\u4ee5\u4fbf\u5171\u4eab |\n| `/instinct-import <file>` | \u4ece\u4ed6\u4eba\u5904\u5bfc\u5165\u76f4\u89c9 |\n\n## \u914d\u7f6e\n\n\u7f16\u8f91 `config.json`\uff1a\n\n```json\n{\n  \"version\": \"2.0\",\n  \"observation\": {\n    \"enabled\": true,\n    \"store_path\": \"~/.claude/homunculus/observations.jsonl\",\n    \"max_file_size_mb\": 10,\n    \"archive_after_days\": 7\n  },\n  \"instincts\": {\n    \"personal_path\": \"~/.claude/homunculus/instincts/personal/\",\n    \"inherited_path\": \"~/.claude/homunculus/instincts/inherited/\",\n    \"min_confidence\": 0.3,\n    \"auto_approve_threshold\": 0.7,\n    \"confidence_decay_rate\": 0.05\n  },\n  \"observer\": {\n    \"enabled\": true,\n    \"model\": \"haiku\",\n    \"run_interval_minutes\": 5,\n    \"patterns_to_detect\": [\n      \"user_corrections\",\n      \"error_resolutions\",\n      \"repeated_workflows\",\n      \"tool_preferences\"\n    ]\n  },\n  \"evolution\": {\n    \"cluster_threshold\": 3,\n    \"evolved_path\": \"~/.claude/homunculus/evolved/\"\n  }\n}\n```\n\n## \u6587\u4ef6\u7ed3\u6784\n\n```\n~/.claude/homunculus/\n\u251c\u2500\u2500 identity.json           # \u4f60\u7684\u4e2a\u4eba\u8d44\u6599\u3001\u6280\u672f\u6c34\u5e73\n\u251c\u2500\u2500 observations.jsonl      # \u5f53\u524d\u4f1a\u8bdd\u89c2\u5bdf\u7ed3\u679c\n\u251c\u2500\u2500 observations.archive/   # \u5df2\u5904\u7406\u7684\u89c2\u5bdf\u7ed3\u679c\n\u251c\u2500\u2500 instincts/\n\u2502   \u251c\u2500\u2500 personal/           # \u81ea\u52a8\u4e60\u5f97\u7684\u76f4\u89c9\n\u2502   \u2514\u2500\u2500 inherited/          # \u4ece\u4ed6\u4eba\u5904\u5bfc\u5165\u7684\u76f4\u89c9\n\u2514\u2500\u2500 evolved/\n    \u251c\u2500\u2500 agents/             # \u751f\u6210\u7684\u4e13\u5bb6\u667a\u80fd\u4f53\n    \u251c\u2500\u2500 skills/             # \u751f\u6210\u7684\u6280\u80fd\n    \u2514\u2500\u2500 commands/           # \u751f\u6210\u7684\u547d\u4ee4\n```\n\n## \u4e0e\u6280\u80fd\u521b\u5efa\u5668 (Skill Creator) \u96c6\u6210\n\n\u5f53\u4f60\u4f7f\u7528 [Skill Creator GitHub App](https://skill-creator.app) \u65f6\uff0c\u5b83\u73b0\u5728\u4f1a**\u540c\u65f6**\u751f\u6210\uff1a\n- \u4f20\u7edf\u7684 SKILL.md \u6587\u4ef6\uff08\u4e3a\u4e86\u5411\u540e\u517c\u5bb9\uff09\n- \u76f4\u89c9\u96c6\u5408 (Instinct collections)\uff08\u4e3a\u4e86 v2 \u5b66\u4e60\u7cfb\u7edf\uff09\n\n\u6765\u81ea\u4ed3\u5e93\u5206\u6790\u7684\u76f4\u89c9\u5e26\u6709 `source: \"repo-analysis\"` \u6807\u7b7e\uff0c\u5e76\u5305\u542b\u6e90\u4ed3\u5e93\u7684 URL\u3002\n\n## \u7f6e\u4fe1\u5ea6\u8bc4\u5206 (Confidence Scoring)\n\n\u7f6e\u4fe1\u5ea6\u4f1a\u968f\u65f6\u95f4\u6f14\u5316\uff1a\n\n| \u5206\u6570 | \u542b\u4e49 | \u884c\u4e3a |\n|-------|---------|----------|\n| 0.3 | \u5c1d\u8bd5\u6027 (Tentative) | \u5efa\u8bae\u4f46\u4e0d\u5f3a\u5236\u6267\u884c |\n| 0.5 | \u4e2d\u7b49 (Moderate) | \u5728\u76f8\u5173\u65f6\u5e94\u7528 |\n| 0.7 | \u5f3a (Strong) | \u81ea\u52a8\u6279\u51c6\u5e94\u7528 |\n| 0.9 | \u8fd1\u4e4e\u786e\u5b9a (Near-certain) | \u6838\u5fc3\u884c\u4e3a |\n\n**\u7f6e\u4fe1\u5ea6\u589e\u52a0** \u7684\u60c5\u51b5\uff1a\n- \u6a21\u5f0f\u88ab\u91cd\u590d\u89c2\u5bdf\u5230\n- \u7528\u6237\u6ca1\u6709\u4fee\u6b63\u5efa\u8bae\u7684\u884c\u4e3a\n- \u6765\u81ea\u5176\u4ed6\u6765\u6e90\u7684\u7c7b\u4f3c\u76f4\u89c9\u8fbe\u6210\u4e00\u81f4\n\n**\u7f6e\u4fe1\u5ea6\u964d\u4f4e** \u7684\u60c5\u51b5\uff1a\n- \u7528\u6237\u660e\u786e\u4fee\u6b63\u4e86\u8be5\u884c\u4e3a\n- \u6a21\u5f0f\u5728\u5f88\u957f\u4e00\u6bb5\u65f6\u95f4\u5185\u6ca1\u6709\u88ab\u89c2\u5bdf\u5230\n- \u51fa\u73b0\u77db\u76fe\u7684\u8bc1\u636e\n\n## \u4e3a\u4ec0\u4e48\u4f7f\u7528\u94a9\u5b50 (Hooks) \u800c\u975e\u6280\u80fd (Skills) \u8fdb\u884c\u89c2\u5bdf\uff1f\n\n> \u201cv1 \u4f9d\u8d56\u6280\u80fd\u8fdb\u884c\u89c2\u5bdf\u3002\u6280\u80fd\u662f\u6982\u7387\u6027\u7684\u2014\u2014\u6839\u636e Claude \u7684\u5224\u65ad\uff0c\u5b83\u4eec\u7684\u89e6\u53d1\u7387\u7ea6\u4e3a 50-80%\u3002\u201d\n\n\u94a9\u5b50\uff08Hooks\uff09\u7684\u89e6\u53d1\u662f **100% \u786e\u5b9a\u6027**\u7684\u3002\u8fd9\u610f\u5473\u7740\uff1a\n- \u6bcf\u4e00\u4e2a\u5de5\u5177\u8c03\u7528\u90fd\u4f1a\u88ab\u89c2\u5bdf\u5230\n- \u4e0d\u4f1a\u9057\u6f0f\u4efb\u4f55\u6a21\u5f0f\n- \u5b66\u4e60\u662f\u5168\u9762\u7684\n\n## \u5411\u540e\u517c\u5bb9\u6027\n\nv2 \u5b8c\u5168\u517c\u5bb9 v1\uff1a\n- \u73b0\u6709\u7684 `~/.claude/skills/learned/` \u6280\u80fd\u4ecd\u7136\u6709\u6548\n- Stop \u94a9\u5b50\u4ecd\u7136\u8fd0\u884c\uff08\u4f46\u73b0\u5728\u4e5f\u4f1a\u8f93\u5165\u5230 v2 \u7cfb\u7edf\u4e2d\uff09\n- \u6e10\u8fdb\u5f0f\u8fc1\u79fb\u8def\u5f84\uff1a\u5e76\u884c\u8fd0\u884c\u4e24\u8005\n\n## \u9690\u79c1\n\n- \u89c2\u5bdf\u7ed3\u679c\u4fdd\u5b58\u5728\u4f60\u7684\u672c\u5730\u673a\u5668\u4e0a\n- \u53ea\u6709 **\u76f4\u89c9\uff08instincts\uff09**\uff08\u5373\u6a21\u5f0f\uff09\u53ef\u4ee5\u88ab\u5bfc\u51fa\n- \u4e0d\u4f1a\u5171\u4eab\u5b9e\u9645\u7684\u4ee3\u7801\u6216\u5bf9\u8bdd\u5185\u5bb9\n- \u4f60\u53ef\u4ee5\u63a7\u5236\u54ea\u4e9b\u5185\u5bb9\u88ab\u5bfc\u51fa\n\n## \u76f8\u5173\u94fe\u63a5\n\n- [Skill Creator](https://skill-creator.app) - \u4ece\u4ed3\u5e93\u5386\u53f2\u751f\u6210\u76f4\u89c9\n- [Homunculus](https://github.com/humanplane/homunculus) - v2 \u67b6\u6784\u7684\u7075\u611f\u6765\u6e90\n- [The Longform Guide](https://x.com/affaanmustafa/status/2014040193557471352) - \u6301\u7eed\u5b66\u4e60\u7ae0\u8282\n\n---\n\n*\u57fa\u4e8e\u76f4\u89c9\u7684\u5b66\u4e60\uff1a\u901a\u8fc7\u4e00\u6b21\u53c8\u4e00\u6b21\u7684\u89c2\u5bdf\uff0c\u6559\u4f1a Claude \u4f60\u7684\u6a21\u5f0f\u3002*\n"
+    "md5": "24ee1c6993e41601ba4950a88d3bbae3",
+    "content": "---\nname: continuous-learning-v2\ndescription: \u57fa\u4e8e\u76f4\u89c9\uff08Instinct\uff09\u7684\u5b66\u4e60\u7cfb\u7edf\uff0c\u901a\u8fc7\u94a9\u5b50\uff08Hooks\uff09\u89c2\u6d4b\u4f1a\u8bdd\uff0c\u521b\u5efa\u5e26\u6709\u7f6e\u4fe1\u5ea6\u8bc4\u5206\uff08Confidence Scoring\uff09\u7684\u539f\u5b50\u76f4\u89c9\uff0c\u5e76\u5c06\u5176\u6f14\u8fdb\u4e3a\u6280\u80fd\uff08Skills\uff09\u3001\u547d\u4ee4\uff08Commands\uff09\u6216\u667a\u80fd\u4f53\uff08Agents\uff09\u3002\nversion: 2.0.0\n---\n\n# \u6301\u7eed\u5b66\u4e60 v2 - \u57fa\u4e8e\u76f4\u89c9\u7684\u67b6\u6784\uff08Instinct-Based Architecture\uff09\n\n\u8fd9\u662f\u4e00\u4e2a\u5148\u8fdb\u7684\u5b66\u4e60\u7cfb\u7edf\uff0c\u901a\u8fc7\u539f\u5b50\u5316\u201c\u76f4\u89c9\uff08Instincts\uff09\u201d\u2014\u2014\u5373\u5e26\u6709\u7f6e\u4fe1\u5ea6\u8bc4\u5206\u7684\u5c0f\u578b\u4e60\u5f97\u884c\u4e3a\uff0c\u5c06\u4f60\u7684 Claude Code \u4f1a\u8bdd\u8f6c\u5316\u4e3a\u53ef\u590d\u7528\u7684\u77e5\u8bc6\u3002\n\n## v2 \u7248\u672c\u65b0\u7279\u6027\n\n| \u7279\u6027 | v1 | v2 |\n|---------|----|----|\n| \u89c2\u6d4b\uff08Observation\uff09 | Stop \u94a9\u5b50\uff08\u4f1a\u8bdd\u7ed3\u675f\u65f6\uff09 | PreToolUse/PostToolUse (100% \u53ef\u9760) |\n| \u5206\u6790\uff08Analysis\uff09 | \u4e3b\u4e0a\u4e0b\u6587\uff08Main context\uff09 | \u540e\u53f0\u667a\u80fd\u4f53 (Haiku) |\n| \u7c92\u5ea6\uff08Granularity\uff09 | \u5b8c\u6574\u6280\u80fd\uff08Full skills\uff09 | \u539f\u5b50\u5316\u201c\u76f4\u89c9\uff08Instincts\uff09\u201d |\n| \u7f6e\u4fe1\u5ea6\uff08Confidence\uff09 | \u65e0 | 0.3-0.9 \u52a0\u6743\u8bc4\u5206 |\n| \u6f14\u8fdb\uff08Evolution\uff09 | \u76f4\u63a5\u8f6c\u5316\u4e3a\u6280\u80fd | \u76f4\u89c9 \u2192 \u805a\u7c7b \u2192 \u6280\u80fd/\u547d\u4ee4/\u667a\u80fd\u4f53 |\n| \u5171\u4eab\uff08Sharing\uff09 | \u65e0 | \u5bfc\u51fa/\u5bfc\u5165\u76f4\u89c9 |\n\n## \u76f4\u89c9\u6a21\u578b\uff08The Instinct Model\uff09\n\n\u76f4\u89c9\uff08Instinct\uff09\u662f\u4e00\u79cd\u5c0f\u578b\u4e60\u5f97\u884c\u4e3a\uff1a\n\n```yaml\n---\nid: prefer-functional-style\ntrigger: \"when writing new functions\"\nconfidence: 0.7\ndomain: \"code-style\"\nsource: \"session-observation\"\n---\n\n# \u504f\u597d\u51fd\u6570\u5f0f\u98ce\u683c\uff08Prefer Functional Style\uff09\n\n## \u52a8\u4f5c\uff08Action\uff09\n\u5728\u5408\u9002\u7684\u60c5\u51b5\u4e0b\uff0c\u4f18\u5148\u4f7f\u7528\u51fd\u6570\u5f0f\u6a21\u5f0f\uff08Functional Patterns\uff09\u800c\u975e\u7c7b\uff08Classes\uff09\u3002\n\n## \u8bc1\u636e\uff08Evidence\uff09\n- \u89c2\u6d4b\u5230 5 \u6b21\u51fd\u6570\u5f0f\u6a21\u5f0f\u504f\u597d\u5b9e\u4f8b\n- \u7528\u6237\u5728 2025-01-15 \u5c06\u57fa\u4e8e\u7c7b\u7684\u65b9\u6cd5\u4fee\u6b63\u4e3a\u51fd\u6570\u5f0f\u65b9\u6cd5\n```\n\n**\u5c5e\u6027\uff1a**\n- **\u539f\u5b50\u5316\uff08Atomic\uff09** \u2014 \u4e00\u4e2a\u89e6\u53d1\u5668\u5bf9\u5e94\u4e00\u4e2a\u52a8\u4f5c\n- **\u7f6e\u4fe1\u5ea6\u52a0\u6743\uff08Confidence-weighted\uff09** \u2014 0.3 = \u5c1d\u8bd5\u6027\u7684\uff0c0.9 = \u8fd1\u4e4e\u786e\u5b9a\n- **\u9886\u57df\u6807\u7b7e\uff08Domain-tagged\uff09** \u2014 \u4ee3\u7801\u98ce\u683c\uff08code-style\uff09\u3001\u6d4b\u8bd5\uff08testing\uff09\u3001git\u3001\u8c03\u8bd5\uff08debugging\uff09\u3001\u5de5\u4f5c\u6d41\uff08workflow\uff09\u7b49\n- **\u8bc1\u636e\u652f\u6301\uff08Evidence-backed\uff09** \u2014 \u8ffd\u8e2a\u662f\u54ea\u4e9b\u89c2\u6d4b\u7ed3\u679c\u521b\u5efa\u4e86\u5b83\n\n## \u5de5\u4f5c\u539f\u7406\n\n```\n\u4f1a\u8bdd\u6d3b\u52a8\uff08Session Activity\uff09\n      \u2502\n      \u2502 \u94a9\u5b50\uff08Hooks\uff09\u6355\u83b7\u63d0\u793a\u8bcd + \u5de5\u5177\u4f7f\u7528 (100% \u53ef\u9760)\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502         observations.jsonl              \u2502\n\u2502   (\u63d0\u793a\u8bcd\u3001\u5de5\u5177\u8c03\u7528\u3001\u6267\u884c\u7ed3\u679c)          \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n      \u2502\n      \u2502 \u89c2\u6d4b\u8005\u667a\u80fd\u4f53\u8bfb\u53d6 (\u540e\u53f0\u8fd0\u884c, Haiku)\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502          \u6a21\u5f0f\u68c0\u6d4b\uff08PATTERN DETECTION\uff09  \u2502\n\u2502   \u2022 \u7528\u6237\u4fee\u6b63 \u2192 \u76f4\u89c9                     \u2502\n\u2502   \u2022 \u9519\u8bef\u89e3\u51b3 \u2192 \u76f4\u89c9                     \u2502\n\u2502   \u2022 \u91cd\u590d\u5de5\u4f5c\u6d41 \u2192 \u76f4\u89c9                   \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n      \u2502\n      \u2502 \u521b\u5efa/\u66f4\u65b0\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502         instincts/personal/             \u2502\n\u2502   \u2022 prefer-functional.md (0.7)          \u2502\n\u2502   \u2022 always-test-first.md (0.9)          \u2502\n\u2502   \u2022 use-zod-validation.md (0.6)         \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n      \u2502\n      \u2502 /evolve \u805a\u7c7b\n      \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502              evolved/                   \u2502\n\u2502   \u2022 commands/new-feature.md             \u2502\n\u2502   \u2022 skills/testing-workflow.md          \u2502\n\u2502   \u2022 agents/refactor-specialist.md       \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## \u5feb\u901f\u5165\u95e8\n\n### 1. \u542f\u7528\u89c2\u6d4b\u94a9\u5b50\uff08Observation Hooks\uff09\n\n\u5c06\u4ee5\u4e0b\u5185\u5bb9\u6dfb\u52a0\u5230\u4f60\u7684 `~/.claude/settings.json` \u4e2d\u3002\n\n**\u5982\u679c\u4f5c\u4e3a\u63d2\u4ef6\u5b89\u88c5**\uff08\u63a8\u8350\uff09\uff1a\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh pre\"\n      }]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh post\"\n      }]\n    }]\n  }\n}\n```\n\n**\u5982\u679c\u624b\u52a8\u5b89\u88c5**\u5230 `~/.claude/skills`\uff1a\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"~/.claude/skills/continuous-learning-v2/hooks/observe.sh pre\"\n      }]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"*\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"~/.claude/skills/continuous-learning-v2/hooks/observe.sh post\"\n      }]\n    }]\n  }\n}\n```\n\n### 2. \u521d\u59cb\u5316\u76ee\u5f55\u7ed3\u6784\n\nPython CLI \u4f1a\u81ea\u52a8\u521b\u5efa\u8fd9\u4e9b\u76ee\u5f55\uff0c\u4f46\u4f60\u4e5f\u53ef\u4ee5\u624b\u52a8\u521b\u5efa\uff1a\n\n```bash\nmkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands}}\ntouch ~/.claude/homunculus/observations.jsonl\n```\n\n### 3. \u4f7f\u7528\u76f4\u89c9\u547d\u4ee4\n\n```bash\n/instinct-status     # \u663e\u793a\u5df2\u4e60\u5f97\u7684\u76f4\u89c9\u53ca\u5176\u7f6e\u4fe1\u5ea6\u8bc4\u5206\n/evolve              # \u5c06\u76f8\u5173\u7684\u76f4\u89c9\u805a\u7c7b\u4e3a\u6280\u80fd/\u547d\u4ee4\n/instinct-export     # \u5bfc\u51fa\u76f4\u89c9\u4ee5\u4fbf\u5206\u4eab\n/instinct-import     # \u4ece\u4ed6\u4eba\u5904\u5bfc\u5165\u76f4\u89c9\n```\n\n## \u547d\u4ee4\uff08Commands\uff09\n\n| \u547d\u4ee4 | \u63cf\u8ff0 |\n|---------|-------------|\n| `/instinct-status` | \u663e\u793a\u6240\u6709\u5df2\u4e60\u5f97\u7684\u76f4\u89c9\u53ca\u7f6e\u4fe1\u5ea6 |\n| `/evolve` | \u5c06\u76f8\u5173\u7684\u76f4\u89c9\u805a\u7c7b\u4e3a\u6280\u80fd/\u547d\u4ee4 |\n| `/instinct-export` | \u5bfc\u51fa\u76f4\u89c9\u4ee5\u4fbf\u5206\u4eab |\n| `/instinct-import <file>` | \u4ece\u4ed6\u4eba\u5904\u5bfc\u5165\u76f4\u89c9 |\n\n## \u914d\u7f6e\uff08Configuration\uff09\n\n\u7f16\u8f91 `config.json`\uff1a\n\n```json\n{\n  \"version\": \"2.0\",\n  \"observation\": {\n    \"enabled\": true,\n    \"store_path\": \"~/.claude/homunculus/observations.jsonl\",\n    \"max_file_size_mb\": 10,\n    \"archive_after_days\": 7\n  },\n  \"instincts\": {\n    \"personal_path\": \"~/.claude/homunculus/instincts/personal/\",\n    \"inherited_path\": \"~/.claude/homunculus/instincts/inherited/\",\n    \"min_confidence\": 0.3,\n    \"auto_approve_threshold\": 0.7,\n    \"confidence_decay_rate\": 0.05\n  },\n  \"observer\": {\n    \"enabled\": true,\n    \"model\": \"haiku\",\n    \"run_interval_minutes\": 5,\n    \"patterns_to_detect\": [\n      \"user_corrections\",\n      \"error_resolutions\",\n      \"repeated_workflows\",\n      \"tool_preferences\"\n    ]\n  },\n  \"evolution\": {\n    \"cluster_threshold\": 3,\n    \"evolved_path\": \"~/.claude/homunculus/evolved/\"\n  }\n}\n```\n\n## \u6587\u4ef6\u7ed3\u6784\n\n```\n~/.claude/homunculus/\n\u251c\u2500\u2500 identity.json           # \u4f60\u7684\u4e2a\u4eba\u8d44\u6599\u3001\u6280\u672f\u6c34\u5e73\n\u251c\u2500\u2500 observations.jsonl      # \u5f53\u524d\u4f1a\u8bdd\u89c2\u6d4b\u7ed3\u679c\n\u251c\u2500\u2500 observations.archive/   # \u5df2\u5904\u7406\u7684\u89c2\u6d4b\u7ed3\u679c\n\u251c\u2500\u2500 instincts/\n\u2502   \u251c\u2500\u2500 personal/           # \u81ea\u52a8\u4e60\u5f97\u7684\u76f4\u89c9\n\u2502   \u2514\u2500\u2500 inherited/          # \u4ece\u4ed6\u4eba\u5904\u5bfc\u5165\u7684\u76f4\u89c9\n\u2514\u2500\u2500 evolved/\n    \u251c\u2500\u2500 agents/             # \u751f\u6210\u7684\u4e13\u5bb6\u667a\u80fd\u4f53\n    \u251c\u2500\u2500 skills/             # \u751f\u6210\u7684\u6280\u80fd\n    \u2514\u2500\u2500 commands/           # \u751f\u6210\u7684\u547d\u4ee4\n```\n\n## \u4e0e Skill Creator \u96c6\u6210\n\n\u5f53\u4f60\u4f7f\u7528 [Skill Creator GitHub App](https://skill-creator.app) \u65f6\uff0c\u5b83\u73b0\u5728\u4f1a**\u540c\u65f6**\u751f\u6210\uff1a\n- \u4f20\u7edf\u7684 SKILL.md \u6587\u4ef6\uff08\u7528\u4e8e\u5411\u4e0b\u517c\u5bb9\uff09\n- \u76f4\u89c9\u96c6\u5408\uff08\u7528\u4e8e v2 \u5b66\u4e60\u7cfb\u7edf\uff09\n\n\u6765\u81ea\u4ed3\u5e93\u5206\u6790\u7684\u76f4\u89c9\u5177\u6709 `source: \"repo-analysis\"` \u5c5e\u6027\uff0c\u5e76\u5305\u542b\u6e90\u4ed3\u5e93 URL\u3002\n\n## \u7f6e\u4fe1\u5ea6\u8bc4\u5206\uff08Confidence Scoring\uff09\n\n\u7f6e\u4fe1\u5ea6\u968f\u65f6\u95f4\u6f14\u8fdb\uff1a\n\n| \u5206\u6570 | \u542b\u4e49 | \u884c\u4e3a |\n|-------|---------|----------|\n| 0.3 | \u5c1d\u8bd5\u6027\u7684\uff08Tentative\uff09 | \u5efa\u8bae\u4f46\u4e0d\u5f3a\u5236\u6267\u884c |\n| 0.5 | \u4e2d\u7b49\uff08Moderate\uff09 | \u5728\u76f8\u5173\u65f6\u5e94\u7528 |\n| 0.7 | \u5f3a\uff08Strong\uff09 | \u81ea\u52a8\u6279\u51c6\u5e94\u7528 |\n| 0.9 | \u8fd1\u4e4e\u786e\u5b9a\uff08Near-certain\uff09 | \u6838\u5fc3\u884c\u4e3a |\n\n**\u7f6e\u4fe1\u5ea6\u589e\u52a0**\u7684\u60c5\u51b5\uff1a\n- \u6a21\u5f0f\u88ab\u91cd\u590d\u89c2\u6d4b\u5230\n- \u7528\u6237\u6ca1\u6709\u4fee\u6b63\u5efa\u8bae\u7684\u884c\u4e3a\n- \u6765\u81ea\u5176\u4ed6\u6765\u6e90\u7684\u7c7b\u4f3c\u76f4\u89c9\u8fbe\u6210\u4e00\u81f4\n\n**\u7f6e\u4fe1\u5ea6\u964d\u4f4e**\u7684\u60c5\u51b5\uff1a\n- \u7528\u6237\u660e\u786e\u4fee\u6b63\u4e86\u8be5\u884c\u4e3a\n- \u6a21\u5f0f\u957f\u65f6\u95f4\u672a\u88ab\u89c2\u6d4b\u5230\n- \u51fa\u73b0\u77db\u76fe\u7684\u8bc1\u636e\n\n## \u4e3a\u4ec0\u4e48\u4f7f\u7528\u94a9\u5b50\uff08Hooks\uff09\u800c\u975e\u6280\u80fd\uff08Skills\uff09\u8fdb\u884c\u89c2\u6d4b\uff1f\n\n> \"v1 \u4f9d\u8d56\u6280\u80fd\u8fdb\u884c\u89c2\u6d4b\u3002\u6280\u80fd\u5177\u6709\u6982\u7387\u6027\u2014\u2014\u6839\u636e Claude \u7684\u5224\u65ad\uff0c\u5176\u89e6\u53d1\u7387\u7ea6\u4e3a 50-80%\u3002\"\n\n\u94a9\u5b50\uff08Hooks\uff09\u7684\u89e6\u53d1\u662f **100% \u786e\u5b9a\u6027\u7684**\u3002\u8fd9\u610f\u5473\u7740\uff1a\n- \u6bcf\u4e00\u4e2a\u5de5\u5177\u8c03\u7528\u90fd\u4f1a\u88ab\u89c2\u6d4b\u5230\n- \u4e0d\u4f1a\u9057\u6f0f\u4efb\u4f55\u6a21\u5f0f\n- \u5b66\u4e60\u662f\u5168\u9762\u7684\n\n## \u5411\u4e0b\u517c\u5bb9\u6027\n\nv2 \u5b8c\u5168\u517c\u5bb9 v1\uff1a\n- \u73b0\u6709\u7684 `~/.claude/skills/learned/` \u6280\u80fd\u4ecd\u7136\u6709\u6548\n- Stop \u94a9\u5b50\u4ecd\u7136\u8fd0\u884c\uff08\u4f46\u73b0\u5728\u4e5f\u4f1a\u4e3a v2 \u63d0\u4f9b\u8f93\u5165\uff09\n- \u6e10\u8fdb\u5f0f\u8fc1\u79fb\u8def\u5f84\uff1a\u4e24\u8005\u5e76\u884c\u8fd0\u884c\n\n## \u9690\u79c1\uff08Privacy\uff09\n\n- \u89c2\u6d4b\u7ed3\u679c\u4fdd\u5b58\u5728\u4f60\u672c\u5730\u673a\u5668\u4e0a\n- \u53ea\u6709**\u76f4\u89c9**\uff08\u6a21\u5f0f\uff09\u53ef\u4ee5\u88ab\u5bfc\u51fa\n- \u4e0d\u4f1a\u5206\u4eab\u5b9e\u9645\u7684\u4ee3\u7801\u6216\u5bf9\u8bdd\u5185\u5bb9\n- \u4f60\u53ef\u4ee5\u63a7\u5236\u5bfc\u51fa\u7684\u5185\u5bb9\n\n## \u76f8\u5173\u94fe\u63a5\n\n- [Skill Creator](https://skill-creator.app) - \u4ece\u4ed3\u5e93\u5386\u53f2\u751f\u6210\u76f4\u89c9\n- [Homunculus](https://github.com/humanplane/homunculus) - v2 \u67b6\u6784\u7684\u7075\u611f\u6765\u6e90\n- [\u957f\u7bc7\u6307\u5357\uff08The Longform Guide\uff09](https://x.com/affaanmustafa/status/2014040193557471352) - \u6301\u7eed\u5b66\u4e60\u7ae0\u8282\n\n---\n\n*\u57fa\u4e8e\u76f4\u89c9\u7684\u5b66\u4e60\uff1a\u901a\u8fc7\u6bcf\u4e00\u6b21\u89c2\u6d4b\uff0c\u6559\u4f1a Claude \u4f60\u7684\u6a21\u5f0f\u3002*\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/continuous-learning-v2/agents/observer.md": {
     "md5": "d3f1b2f829b31c7b8925f4d8540ae4b3",
     "content": "---\nname: observer\ndescription: \u5206\u6790\u4f1a\u8bdd\u89c2\u6d4b\uff08observations\uff09\u4ee5\u68c0\u6d4b\u6a21\u5f0f\uff08patterns\uff09\u5e76\u521b\u5efa\u76f4\u89c9\uff08instincts\uff09\u7684\u540e\u53f0\u667a\u80fd\u4f53\uff08Agent\uff09\u3002\u4f7f\u7528 Haiku \u6a21\u578b\u4ee5\u4fdd\u8bc1\u6210\u672c\u6548\u76ca\u3002\nmodel: haiku\nrun_mode: background\n---\n\n# \u89c2\u6d4b\u8005\u667a\u80fd\u4f53 (Observer Agent)\n\n\u4e00\u4e2a\u540e\u53f0\u667a\u80fd\u4f53\uff08Agent\uff09\uff0c\u7528\u4e8e\u5206\u6790 Claude Code \u4f1a\u8bdd\u4e2d\u7684\u89c2\u6d4b\u6570\u636e\uff0c\u4ece\u800c\u68c0\u6d4b\u6a21\u5f0f\uff08patterns\uff09\u5e76\u521b\u5efa\u76f4\u89c9\uff08instincts\uff09\u3002\n\n## \u8fd0\u884c\u65f6\u673a\n\n- \u5f53\u4f1a\u8bdd\u6d3b\u52a8\u663e\u8457\u65f6\uff08\u8d85\u8fc7 20 \u6b21\u5de5\u5177\u8c03\u7528\uff09\n- \u5f53\u7528\u6237\u8fd0\u884c `/analyze-patterns` \u547d\u4ee4\u65f6\n- \u6309\u9884\u5b9a\u65f6\u95f4\u95f4\u9694\uff08\u53ef\u914d\u7f6e\uff0c\u9ed8\u8ba4\u4e3a 5 \u5206\u949f\uff09\n- \u5f53\u88ab\u89c2\u6d4b\u94a9\u5b50\uff08observation hook\uff09\u89e6\u53d1\u65f6\uff08SIGUSR1\uff09\n\n## \u8f93\u5165\n\n\u4ece `~/.claude/homunculus/observations.jsonl` \u8bfb\u53d6\u89c2\u6d4b\u6570\u636e\uff1a\n\n```jsonl\n{\"timestamp\":\"2025-01-22T10:30:00Z\",\"event\":\"tool_start\",\"session\":\"abc123\",\"tool\":\"Edit\",\"input\":\"...\"}\n{\"timestamp\":\"2025-01-22T10:30:01Z\",\"event\":\"tool_complete\",\"session\":\"abc123\",\"tool\":\"Edit\",\"output\":\"...\"}\n{\"timestamp\":\"2025-01-22T10:30:05Z\",\"event\":\"tool_start\",\"session\":\"abc123\",\"tool\":\"Bash\",\"input\":\"npm test\"}\n{\"timestamp\":\"2025-01-22T10:30:10Z\",\"event\":\"tool_complete\",\"session\":\"abc123\",\"tool\":\"Bash\",\"output\":\"All tests pass\"}\n```\n\n## \u6a21\u5f0f\u68c0\u6d4b\n\n\u5728\u89c2\u6d4b\u6570\u636e\u4e2d\u5bfb\u627e\u4ee5\u4e0b\u6a21\u5f0f\uff1a\n\n### 1. \u7528\u6237\u4fee\u6b63\n\u5f53\u7528\u6237\u7684\u540e\u7eed\u6d88\u606f\u4fee\u6b63\u4e86 Claude \u4e4b\u524d\u7684\u64cd\u4f5c\u65f6\uff1a\n- \"\u4e0d\uff0c\u7528 X \u4ee3\u66ff Y\"\n- \"\u5b9e\u9645\u4e0a\uff0c\u6211\u7684\u610f\u601d\u662f\u2026\u2026\"\n- \u7acb\u5373\u64a4\u9500/\u91cd\u505a\u6a21\u5f0f\n\n\u2192 \u521b\u5efa\u76f4\u89c9\uff08instinct\uff09\uff1a\"\u6267\u884c X \u65f6\uff0c\u4f18\u5148\u4f7f\u7528 Y\"\n\n### 2. \u9519\u8bef\u4fee\u590d\n\u5f53\u9519\u8bef\u53d1\u751f\u540e\u7d27\u63a5\u7740\u4fee\u590d\u64cd\u4f5c\u65f6\uff1a\n- \u5de5\u5177\u8f93\u51fa\u5305\u542b\u9519\u8bef\n- \u63a5\u4e0b\u6765\u7684\u51e0\u6b21\u5de5\u5177\u8c03\u7528\u4fee\u590d\u4e86\u8be5\u9519\u8bef\n- \u540c\u7c7b\u9519\u8bef\u591a\u6b21\u4ee5\u7c7b\u4f3c\u65b9\u5f0f\u89e3\u51b3\n\n\u2192 \u521b\u5efa\u76f4\u89c9\uff08instinct\uff09\uff1a\"\u9047\u5230\u9519\u8bef X \u65f6\uff0c\u5c1d\u8bd5 Y\"\n\n### 3. \u91cd\u590d\u5de5\u4f5c\u6d41\n\u5f53\u591a\u6b21\u4f7f\u7528\u76f8\u540c\u7684\u5de5\u5177\u5e8f\u5217\u65f6\uff1a\n- \u8f93\u5165\u76f8\u4f3c\u7684\u76f8\u540c\u5de5\u5177\u5e8f\u5217\n- \u540c\u6b65\u53d8\u66f4\u7684\u6587\u4ef6\u6a21\u5f0f\n- \u65f6\u95f4\u4e0a\u805a\u96c6\u7684\u64cd\u4f5c\n\n\u2192 \u521b\u5efa\u5de5\u4f5c\u6d41\u76f4\u89c9\uff08workflow instinct\uff09\uff1a\"\u6267\u884c X \u65f6\uff0c\u9075\u5faa\u6b65\u9aa4 Y\u3001Z\u3001W\"\n\n### 4. \u5de5\u5177\u504f\u597d\n\u5f53\u67d0\u4e9b\u5de5\u5177\u88ab\u6301\u7eed\u504f\u597d\u4f7f\u7528\u65f6\uff1a\n- \u603b\u662f\u5728 Edit \u4e4b\u524d\u4f7f\u7528 Grep\n- \u76f8\u6bd4 Bash cat \u66f4\u503e\u5411\u4e8e\u4f7f\u7528 Read\n- \u9488\u5bf9\u7279\u5b9a\u4efb\u52a1\u4f7f\u7528\u7279\u5b9a\u7684 Bash \u547d\u4ee4\n\n\u2192 \u521b\u5efa\u76f4\u89c9\uff08instinct\uff09\uff1a\"\u5f53\u9700\u8981 X \u65f6\uff0c\u4f7f\u7528\u5de5\u5177 Y\"\n\n## \u8f93\u51fa\n\n\u5728 `~/.claude/homunculus/instincts/personal/` \u4e2d\u521b\u5efa/\u66f4\u65b0\u76f4\u89c9\uff08instincts\uff09\uff1a\n\n```yaml\n---\nid: prefer-grep-before-edit\ntrigger: \"when searching for code to modify\"\nconfidence: 0.65\ndomain: \"workflow\"\nsource: \"session-observation\"\n---\n\n# \u4f18\u5148\u5728 Edit \u524d\u4f7f\u7528 Grep\n\n## \u52a8\u4f5c\n\u5728\u4f7f\u7528 Edit \u4e4b\u524d\uff0c\u59cb\u7ec8\u4f7f\u7528 Grep \u67e5\u627e\u786e\u5207\u4f4d\u7f6e\u3002\n\n## \u8bc1\u636e\n- \u5728\u4f1a\u8bdd abc123 \u4e2d\u89c2\u6d4b\u5230 8 \u6b21\n- \u6a21\u5f0f\uff1aGrep \u2192 Read \u2192 Edit \u5e8f\u5217\n- \u6700\u8fd1\u89c2\u6d4b\u65f6\u95f4\uff1a2025-01-22\n```\n\n## \u7f6e\u4fe1\u5ea6\u8ba1\u7b97\n\n\u57fa\u4e8e\u89c2\u6d4b\u9891\u7387\u7684\u521d\u59cb\u7f6e\u4fe1\u5ea6\uff1a\n- 1-2 \u6b21\u89c2\u6d4b\uff1a0.3\uff08\u521d\u6b65\uff09\n- 3-5 \u6b21\u89c2\u6d4b\uff1a0.5\uff08\u4e2d\u7b49\uff09\n- 6-10 \u6b21\u89c2\u6d4b\uff1a0.7\uff08\u5f3a\uff09\n- 11+ \u6b21\u89c2\u6d4b\uff1a0.85\uff08\u6781\u5f3a\uff09\n\n\u7f6e\u4fe1\u5ea6\u968f\u65f6\u95f4\u8c03\u6574\uff1a\n- \u6bcf\u6b21\u8bc1\u5b9e\u6027\u89c2\u6d4b +0.05\n- \u6bcf\u6b21\u77db\u76fe\u6027\u89c2\u6d4b -0.1\n- \u65e0\u89c2\u6d4b\u6bcf\u5468 -0.02\uff08\u8870\u51cf\uff09\n\n## \u91cd\u8981\u6307\u5357\n\n1. **\u4fdd\u6301\u4fdd\u5b88**\uff1a\u4ec5\u9488\u5bf9\u6e05\u6670\u7684\u6a21\u5f0f\uff083 \u6b21\u4ee5\u4e0a\u89c2\u6d4b\uff09\u521b\u5efa\u76f4\u89c9\n2. **\u4fdd\u6301\u5177\u4f53**\uff1a\u5177\u4f53\u7684\u89e6\u53d1\u6761\u4ef6\u4f18\u4e8e\u5bbd\u6cdb\u7684\u6761\u4ef6\n3. **\u8ffd\u8e2a\u8bc1\u636e**\uff1a\u59cb\u7ec8\u5305\u542b\u5bfc\u81f4\u8be5\u76f4\u89c9\u7684\u89c2\u6d4b\u7ed3\u679c\n4. **\u5c0a\u91cd\u9690\u79c1**\uff1a\u5207\u52ff\u5305\u542b\u5b9e\u9645\u4ee3\u7801\u7247\u6bb5\uff0c\u4ec5\u5305\u542b\u6a21\u5f0f\n5. **\u5408\u5e76\u76f8\u4f3c\u9879**\uff1a\u5982\u679c\u65b0\u76f4\u89c9\u4e0e\u73b0\u6709\u76f4\u89c9\u76f8\u4f3c\uff0c\u5e94\u8fdb\u884c\u66f4\u65b0\u800c\u975e\u91cd\u590d\u521b\u5efa\n\n## \u793a\u4f8b\u5206\u6790\u4f1a\u8bdd\n\n\u7ed9\u5b9a\u89c2\u6d4b\u6570\u636e\uff1a\n```jsonl\n{\"event\":\"tool_start\",\"tool\":\"Grep\",\"input\":\"pattern: useState\"}\n{\"event\":\"tool_complete\",\"tool\":\"Grep\",\"output\":\"Found in 3 files\"}\n{\"event\":\"tool_start\",\"tool\":\"Read\",\"input\":\"src/hooks/useAuth.ts\"}\n{\"event\":\"tool_complete\",\"tool\":\"Read\",\"output\":\"[file content]\"}\n{\"event\":\"tool_start\",\"tool\":\"Edit\",\"input\":\"src/hooks/useAuth.ts...\"}\n```\n\n\u5206\u6790\uff1a\n- \u68c0\u6d4b\u5230\u7684\u5de5\u4f5c\u6d41\uff1aGrep \u2192 Read \u2192 Edit\n- \u9891\u7387\uff1a\u672c\u4f1a\u8bdd\u51fa\u73b0 5 \u6b21\n- \u521b\u5efa\u76f4\u89c9\uff1a\n  - trigger: \"when modifying code\"\n  - action: \"\u5148\u7528 Grep \u641c\u7d22\uff0c\u518d\u7528 Read \u786e\u8ba4\uff0c\u6700\u540e Edit\"\n  - confidence: 0.6\n  - domain: \"workflow\"\n\n## \u4e0e\u6280\u80fd\u751f\u6210\u5668 (Skill Creator) \u96c6\u6210\n\n\u5f53\u4ece\u6280\u80fd\u751f\u6210\u5668\uff08\u4ed3\u5e93\u5206\u6790\uff09\u5bfc\u5165\u76f4\u89c9\u65f6\uff0c\u5b83\u4eec\u5177\u6709\uff1a\n- `source: \"repo-analysis\"`\n- `source_repo: \"https://github.com/...\"`\n\n\u8fd9\u4e9b\u5e94\u88ab\u89c6\u4e3a\u56e2\u961f/\u9879\u76ee\u89c4\u8303\uff0c\u5177\u6709\u8f83\u9ad8\u7684\u521d\u59cb\u7f6e\u4fe1\u5ea6\uff080.7+\uff09\u3002\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/continuous-learning-v2/commands/instinct-export.md": {
-    "md5": "17b1afc48ce7380005509993a87c7309",
+    "md5": "8679fea63be82c9e6b47333a49089b4d",
     "content": "---\nname: instinct-export\ndescription: \u5bfc\u51fa\u76f4\u89c9\uff08Instincts\uff09\u4ee5\u4fbf\u4e0e\u56e2\u961f\u6210\u5458\u6216\u5176\u4ed6\u9879\u76ee\u5171\u4eab\ncommand: /instinct-export\n---\n\n# \u76f4\u89c9\u5bfc\u51fa\u547d\u4ee4\uff08Instinct Export Command\uff09\n\n\u5c06\u76f4\u89c9\uff08Instincts\uff09\u5bfc\u51fa\u4e3a\u53ef\u5171\u4eab\u7684\u683c\u5f0f\u3002\u975e\u5e38\u9002\u7528\u4e8e\uff1a\n- \u4e0e\u56e2\u961f\u6210\u5458\u5171\u4eab\n- \u8fc1\u79fb\u5230\u65b0\u673a\u5668\n- \u8d21\u732e\u5230\u9879\u76ee\u89c4\u8303\uff08Conventions\uff09\u4e2d\n\n## \u4f7f\u7528\u65b9\u6cd5\n\n```\n/instinct-export                           # \u5bfc\u51fa\u6240\u6709\u4e2a\u4eba\u76f4\u89c9\n/instinct-export --domain testing          # \u4ec5\u5bfc\u51fa\u6d4b\u8bd5\uff08Testing\uff09\u9886\u57df\u7684\u76f4\u89c9\n/instinct-export --min-confidence 0.7      # \u4ec5\u5bfc\u51fa\u9ad8\u7f6e\u4fe1\u5ea6\u7684\u76f4\u89c9\n/instinct-export --output team-instincts.yaml\n```\n\n## \u6267\u884c\u903b\u8f91\n\n1. \u4ece `~/.claude/homunculus/instincts/personal/` \u8bfb\u53d6\u76f4\u89c9\u6570\u636e\n2. \u6839\u636e\u53c2\u6570\uff08Flags\uff09\u8fdb\u884c\u8fc7\u6ee4\n3. \u8131\u654f\u654f\u611f\u4fe1\u606f\uff1a\n   - \u79fb\u9664\u4f1a\u8bdd ID\uff08Session IDs\uff09\n   - \u79fb\u9664\u6587\u4ef6\u8def\u5f84\uff08\u4ec5\u4fdd\u7559\u6a21\u5f0f\u4e32/Patterns\uff09\n   - \u79fb\u9664\u65e9\u4e8e\u201c\u4e0a\u5468\u201d\u7684\u65f6\u95f4\u6233\n4. \u751f\u6210\u5bfc\u51fa\u6587\u4ef6\n\n## \u8f93\u51fa\u683c\u5f0f\n\n\u521b\u5efa\u4e00\u4e2a YAML \u6587\u4ef6\uff1a\n\n```yaml\n# Instincts Export\n# Generated: 2025-01-22\n# Source: personal\n# Count: 12 instincts\n\nversion: \"2.0\"\nexported_by: \"continuous-learning-v2\"\nexport_date: \"2025-01-22T10:30:00Z\"\n\ninstincts:\n  - id: prefer-functional-style\n    trigger: \"when writing new functions\"\n    action: \"Use functional patterns over classes\"\n    confidence: 0.8\n    domain: code-style\n    observations: 8\n\n  - id: test-first-workflow\n    trigger: \"when adding new functionality\"\n    action: \"Write test first, then implementation\"\n    confidence: 0.9\n    domain: testing\n    observations: 12\n\n  - id: grep-before-edit\n    trigger: \"when modifying code\"\n    action: \"Search with Grep, confirm with Read, then Edit\"\n    confidence: 0.7\n    domain: workflow\n    observations: 6\n```\n\n## \u9690\u79c1\u8bf4\u660e\n\n\u5bfc\u51fa\u5185\u5bb9**\u5305\u542b**\uff1a\n- \u2705 \u89e6\u53d1\u6a21\u5f0f\uff08Trigger patterns\uff09\n- \u2705 \u52a8\u4f5c\uff08Actions\uff09\n- \u2705 \u7f6e\u4fe1\u5ea6\u8bc4\u5206\uff08Confidence scores\uff09\n- \u2705 \u9886\u57df\uff08Domains\uff09\n- \u2705 \u89c2\u6d4b\u8ba1\u6570\uff08Observation counts\uff09\n\n\u5bfc\u51fa\u5185\u5bb9**\u4e0d\u5305\u542b**\uff1a\n- \u274c \u5b9e\u9645\u4ee3\u7801\u7247\u6bb5\n- \u274c \u6587\u4ef6\u8def\u5f84\n- \u274c \u4f1a\u8bdd\u8f6c\u5f55\uff08Session transcripts\uff09\n- \u274c \u4e2a\u4eba\u8eab\u4efd\u6807\u8bc6\u7b26\n\n## \u53c2\u6570\uff08Flags\uff09\n\n- `--domain <name>`: \u4ec5\u5bfc\u51fa\u6307\u5b9a\u9886\u57df\uff08Domain\uff09\n- `--min-confidence <n>`: \u6700\u4f4e\u7f6e\u4fe1\u5ea6\u9608\u503c\uff08\u9ed8\u8ba4\u503c\uff1a0.3\uff09\n- `--output <file>`: \u8f93\u51fa\u6587\u4ef6\u8def\u5f84\uff08\u9ed8\u8ba4\u503c\uff1ainstincts-export-YYYYMMDD.yaml\uff09\n- `--format <yaml|json|md>`: \u8f93\u51fa\u683c\u5f0f\uff08\u9ed8\u8ba4\u503c\uff1ayaml\uff09\n- `--include-evidence`: \u5305\u542b\u8bc1\u636e\uff08Evidence\uff09\u6587\u672c\uff08\u9ed8\u8ba4\uff1a\u6392\u9664\uff09\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/continuous-learning-v2/commands/instinct-import.md": {
-    "md5": "253f6c240c33461521a5860d27f229e4",
-    "content": "---\nname: instinct-import\ndescription: \u4ece\u961f\u53cb\u3001\u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u6216\u5176\u4ed6\u6765\u6e90\u5bfc\u5165\u76f4\u89c9\uff08Instincts\uff09\ncommand: /instinct-import\nimplementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file>\n---\n\n# \u76f4\u89c9\u5bfc\u5165\u547d\u4ee4\uff08Instinct Import Command\uff09\n\n## \u5b9e\u73b0\n\n```bash\npython3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7]\n```\n\n\u4ece\u4ee5\u4e0b\u6765\u6e90\u5bfc\u5165\u76f4\u89c9\uff08Instincts\uff09\uff1a\n- \u961f\u53cb\u5bfc\u51fa\u7684\u6587\u4ef6\n- \u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\uff08\u4ed3\u5e93\u5206\u6790\uff09\n- \u793e\u533a\u96c6\u5408\n- \u4e4b\u524d\u7684\u673a\u5668\u5907\u4efd\n\n## \u7528\u6cd5\n\n```\n/instinct-import team-instincts.yaml\n/instinct-import https://github.com/org/repo/instincts.yaml\n/instinct-import --from-skill-creator acme/webapp\n```\n\n## \u6267\u884c\u6d41\u7a0b\n\n1. \u83b7\u53d6\u76f4\u89c9\u6587\u4ef6\uff08\u672c\u5730\u8def\u5f84\u6216 URL\uff09\n2. \u89e3\u6790\u5e76\u9a8c\u8bc1\u683c\u5f0f\n3. \u68c0\u67e5\u662f\u5426\u4e0e\u73b0\u6709\u76f4\u89c9\u91cd\u590d\n4. \u5408\u5e76\u6216\u6dfb\u52a0\u65b0\u76f4\u89c9\n5. \u4fdd\u5b58\u81f3 `~/.claude/homunculus/instincts/inherited/`\n\n## \u5bfc\u5165\u8fc7\u7a0b\u793a\u4f8b\n\n```\n\ud83d\udce5 \u6b63\u5728\u4ece team-instincts.yaml \u5bfc\u5165\u76f4\u89c9\uff1a\n================================================\n\n\u53d1\u73b0 12 \u6761\u5f85\u5bfc\u5165\u7684\u76f4\u89c9\u3002\n\n\u6b63\u5728\u5206\u6790\u51b2\u7a81...\n\n## \u65b0\u76f4\u89c9 (8)\n\u8fd9\u4e9b\u5c06\u88ab\u6dfb\u52a0\uff1a\n  \u2713 use-zod-validation (\u7f6e\u4fe1\u5ea6: 0.7)\n  \u2713 prefer-named-exports (\u7f6e\u4fe1\u5ea6: 0.65)\n  \u2713 test-async-functions (\u7f6e\u4fe1\u5ea6: 0.8)\n  ...\n\n## \u91cd\u590d\u76f4\u89c9 (3)\n\u5df2\u5b58\u5728\u7c7b\u4f3c\u7684\u76f4\u89c9\uff1a\n  \u26a0\ufe0f prefer-functional-style\n     \u672c\u5730\uff1a0.8 \u7f6e\u4fe1\u5ea6\uff0c12 \u4e2a\u89c2\u6d4b\u9879\n     \u5bfc\u5165\uff1a0.7 \u7f6e\u4fe1\u5ea6\n     \u2192 \u4fdd\u7559\u672c\u5730\uff08\u7f6e\u4fe1\u5ea6\u66f4\u9ad8\uff09\n\n  \u26a0\ufe0f test-first-workflow\n     \u672c\u5730\uff1a0.75 \u7f6e\u4fe1\u5ea6\n     \u5bfc\u5165\uff1a0.9 \u7f6e\u4fe1\u5ea6\n     \u2192 \u66f4\u65b0\u4e3a\u5bfc\u5165\u7684\u5185\u5bb9\uff08\u7f6e\u4fe1\u5ea6\u66f4\u9ad8\uff09\n\n## \u51b2\u7a81\u76f4\u89c9 (1)\n\u8fd9\u4e9b\u4e0e\u672c\u5730\u76f4\u89c9\u76f8\u77db\u76fe\uff1a\n  \u274c use-classes-for-services\n     \u4e0e avoid-classes \u51b2\u7a81\n     \u2192 \u8df3\u8fc7\uff08\u9700\u8981\u624b\u52a8\u89e3\u51b3\uff09\n\n---\n\u5bfc\u5165 8 \u4e2a\u65b0\u9879\uff0c\u66f4\u65b0 1 \u4e2a\uff0c\u8df3\u8fc7 3 \u4e2a\uff1f\n```\n\n## \u5408\u5e76\u7b56\u7565\uff08Merge Strategies\uff09\n\n### \u5904\u7406\u91cd\u590d\u9879\n\u5f53\u5bfc\u5165\u7684\u76f4\u89c9\u4e0e\u73b0\u6709\u76f4\u89c9\u5339\u914d\u65f6\uff1a\n- **\u9ad8\u7f6e\u4fe1\u5ea6\u80dc\u51fa**\uff1a\u4fdd\u7559\u7f6e\u4fe1\u5ea6\uff08Confidence\uff09\u8f83\u9ad8\u7684\u4e00\u65b9\n- **\u5408\u5e76\u8bc1\u636e**\uff1a\u7d2f\u8ba1\u89c2\u6d4b\u9879\uff08Observation\uff09\u8ba1\u6570\n- **\u66f4\u65b0\u65f6\u95f4\u6233**\uff1a\u6807\u8bb0\u4e3a\u6700\u8fd1\u5df2\u9a8c\u8bc1\n\n### \u5904\u7406\u51b2\u7a81\n\u5f53\u5bfc\u5165\u7684\u76f4\u89c9\u4e0e\u73b0\u6709\u76f4\u89c9\u51b2\u7a81\u65f6\uff1a\n- **\u9ed8\u8ba4\u8df3\u8fc7**\uff1a\u4e0d\u5bfc\u5165\u4ea7\u751f\u51b2\u7a81\u7684\u76f4\u89c9\n- **\u6807\u8bb0\u5f85\u5ba1\u67e5**\uff1a\u5c06\u4e24\u8005\u90fd\u6807\u8bb0\u4e3a\u9700\u8981\u5173\u6ce8\n- **\u624b\u52a8\u89e3\u51b3**\uff1a\u7531\u7528\u6237\u51b3\u5b9a\u4fdd\u7559\u54ea\u4e00\u4e2a\n\n## \u6765\u6e90\u8ffd\u8e2a\n\n\u5bfc\u5165\u7684\u76f4\u89c9\u4f1a\u88ab\u6807\u8bb0\u4ee5\u4e0b\u5b57\u6bb5\uff1a\n```yaml\nsource: \"inherited\"\nimported_from: \"team-instincts.yaml\"\nimported_at: \"2025-01-22T10:30:00Z\"\noriginal_source: \"session-observation\"  # \u6216 \"repo-analysis\"\n```\n\n## \u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u96c6\u6210\n\n\u4ece\u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u5bfc\u5165\u65f6\uff1a\n\n```\n/instinct-import --from-skill-creator acme/webapp\n```\n\n\u8fd9\u5c06\u83b7\u53d6\u901a\u8fc7\u4ed3\u5e93\u5206\u6790\u751f\u6210\u7684\u76f4\u89c9\uff1a\n- \u6765\u6e90\uff1a`repo-analysis`\n- \u8f83\u9ad8\u7684\u521d\u59cb\u7f6e\u4fe1\u5ea6\uff080.7+\uff09\n- \u5df2\u94fe\u63a5\u5230\u6e90\u4ed3\u5e93\n\n## \u53c2\u6570\u6807\u5fd7\uff08Flags\uff09\n\n- `--dry-run`\uff1a\u9884\u89c8\u800c\u4e0d\u6267\u884c\u5bfc\u5165\n- `--force`\uff1a\u5373\u4f7f\u5b58\u5728\u51b2\u7a81\u4e5f\u5f3a\u5236\u5bfc\u5165\n- `--merge-strategy <higher|local|import>`\uff1a\u5982\u4f55\u5904\u7406\u91cd\u590d\u9879\n- `--from-skill-creator <owner/repo>`\uff1a\u4ece\u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u5206\u6790\u7ed3\u679c\u5bfc\u5165\n- `--min-confidence <n>`\uff1a\u4ec5\u5bfc\u5165\u7f6e\u4fe1\u5ea6\u9ad8\u4e8e\u9608\u503c\u7684\u76f4\u89c9\n\n## \u8f93\u51fa\n\n\u5bfc\u5165\u5b8c\u6210\u540e\uff1a\n```\n\u2705 \u5bfc\u5165\u5b8c\u6210\uff01\n\n\u5df2\u6dfb\u52a0\uff1a8 \u6761\u76f4\u89c9\n\u5df2\u66f4\u65b0\uff1a1 \u6761\u76f4\u89c9\n\u5df2\u8df3\u8fc7\uff1a3 \u6761\u76f4\u89c9\uff082 \u4e2a\u91cd\u590d\uff0c1 \u4e2a\u51b2\u7a81\uff09\n\n\u65b0\u76f4\u89c9\u5df2\u4fdd\u5b58\u81f3\uff1a~/.claude/homunculus/instincts/inherited/\n\n\u8fd0\u884c /instinct-status \u67e5\u770b\u6240\u6709\u76f4\u89c9\u3002\n```\n"
+    "md5": "faf806d226f555c0eb60929daec25584",
+    "content": "---\nname: instinct-import\ndescription: \u4ece\u961f\u53cb\u3001\u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u6216\u5176\u4ed6\u6765\u6e90\u5bfc\u5165\u76f4\u89c9\uff08Instincts\uff09\ncommand: /instinct-import\nimplementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file>\n---\n\n# \u76f4\u89c9\u5bfc\u5165\u547d\u4ee4\uff08Instinct Import Command\uff09\n\n## \u5b9e\u73b0\n\n```bash\npython3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7]\n```\n\n\u4ece\u4ee5\u4e0b\u6765\u6e90\u5bfc\u5165\u76f4\u89c9\uff08Instincts\uff09\uff1a\n- \u961f\u53cb\u5bfc\u51fa\u7684\u6587\u4ef6\n- \u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\uff08\u4ed3\u5e93\u5206\u6790\uff09\n- \u793e\u533a\u96c6\u5408\n- \u4e4b\u524d\u7684\u673a\u5668\u5907\u4efd\n\n## \u7528\u6cd5\n\n```\n/instinct-import team-instincts.yaml\n/instinct-import https://github.com/org/repo/instincts.yaml\n/instinct-import --from-skill-creator acme/webapp\n```\n\n## \u6267\u884c\u6d41\u7a0b\n\n1. \u83b7\u53d6\u76f4\u89c9\u6587\u4ef6\uff08\u672c\u5730\u8def\u5f84\u6216 URL\uff09\n2. \u89e3\u6790\u5e76\u9a8c\u8bc1\u683c\u5f0f\n3. \u68c0\u67e5\u662f\u5426\u4e0e\u73b0\u6709\u76f4\u89c9\u91cd\u590d\n4. \u5408\u5e76\u6216\u6dfb\u52a0\u65b0\u76f4\u89c9\n5. \u4fdd\u5b58\u81f3 `~/.claude/homunculus/instincts/inherited/`\n\n## \u5bfc\u5165\u8fc7\u7a0b\u793a\u4f8b\n\n```\n\ud83d\udce5 \u6b63\u5728\u4ece team-instincts.yaml \u5bfc\u5165\u76f4\u89c9\uff1a\n================================================\n\n\u53d1\u73b0 12 \u6761\u5f85\u5bfc\u5165\u7684\u76f4\u89c9\u3002\n\n\u6b63\u5728\u5206\u6790\u51b2\u7a81...\n\n## \u65b0\u76f4\u89c9 (8)\n\u8fd9\u4e9b\u5c06\u88ab\u6dfb\u52a0\uff1a\n  \u2713 use-zod-validation (\u7f6e\u4fe1\u5ea6: 0.7)\n  \u2713 prefer-named-exports (\u7f6e\u4fe1\u5ea6: 0.65)\n  \u2713 test-async-functions (\u7f6e\u4fe1\u5ea6: 0.8)\n  ...\n\n## \u91cd\u590d\u76f4\u89c9 (3)\n\u5df2\u5b58\u5728\u7c7b\u4f3c\u7684\u76f4\u89c9\uff1a\n  \u26a0\ufe0f prefer-functional-style\n     \u672c\u5730\uff1a0.8 \u7f6e\u4fe1\u5ea6\uff0c12 \u4e2a\u89c2\u6d4b\u9879\n     \u5bfc\u5165\uff1a0.7 \u7f6e\u4fe1\u5ea6\n     \u2192 \u4fdd\u7559\u672c\u5730\uff08\u7f6e\u4fe1\u5ea6\u66f4\u9ad8\uff09\n\n  \u26a0\ufe0f test-first-workflow\n     \u672c\u5730\uff1a0.75 \u7f6e\u4fe1\u5ea6\n     \u5bfc\u5165\uff1a0.9 \u7f6e\u4fe1\u5ea6\n     \u2192 \u66f4\u65b0\u4e3a\u5bfc\u5165\u7684\u5185\u5bb9\uff08\u7f6e\u4fe1\u5ea6\u66f4\u9ad8\uff09\n\n## \u51b2\u7a81\u76f4\u89c9 (1)\n\u8fd9\u4e9b\u4e0e\u672c\u5730\u76f4\u89c9\u76f8\u77db\u76fe\uff1a\n  \u274c use-classes-for-services\n     \u4e0e avoid-classes \u51b2\u7a81\n     \u2192 \u8df3\u8fc7\uff08\u9700\u8981\u624b\u52a8\u89e3\u51b3\uff09\n\n---\n\u5bfc\u5165 8 \u4e2a\u65b0\u9879\uff0c\u66f4\u65b0 1 \u4e2a\uff0c\u8df3\u8fc7 3 \u4e2a\uff1f\n```\n\n## \u5408\u5e76\u7b56\u7565\uff08Merge Strategies\uff09\n\n### \u5904\u7406\u91cd\u590d\u9879\n\u5f53\u5bfc\u5165\u7684\u76f4\u89c9\u4e0e\u73b0\u6709\u76f4\u89c9\u5339\u914d\u65f6\uff1a\n- **\u9ad8\u7f6e\u4fe1\u5ea6\u80dc\u51fa**\uff1a\u4fdd\u7559\u7f6e\u4fe1\u5ea6\uff08Confidence\uff09\u8f83\u9ad8\u7684\u4e00\u65b9\n- **\u5408\u5e76\u8bc1\u636e**\uff1a\u7d2f\u8ba1\u89c2\u6d4b\u9879\uff08Observation\uff09\u8ba1\u6570\n- **\u66f4\u65b0\u65f6\u95f4\u6233**\uff1a\u6807\u8bb0\u4e3a\u6700\u8fd1\u5df2\u9a8c\u8bc1\n\n### \u5904\u7406\u51b2\u7a81\n\u5f53\u5bfc\u5165\u7684\u76f4\u89c9\u4e0e\u73b0\u6709\u76f4\u89c9\u51b2\u7a81\u65f6\uff1a\n- **\u9ed8\u8ba4\u8df3\u8fc7**\uff1a\u4e0d\u5bfc\u5165\u4ea7\u751f\u51b2\u7a81\u7684\u76f4\u89c9\n- **\u6807\u8bb0\u5f85\u5ba1\u67e5**\uff1a\u5c06\u4e24\u8005\u90fd\u6807\u8bb0\u4e3a\u9700\u8981\u5173\u6ce8\n- **\u624b\u52a8\u89e3\u51b3**\uff1a\u7531\u7528\u6237\u51b3\u5b9a\u4fdd\u7559\u54ea\u4e00\u4e2a\n\n## \u6765\u6e90\u8ffd\u8e2a\n\n\u5bfc\u5165\u7684\u76f4\u89c9\u4f1a\u88ab\u6807\u8bb0\u4ee5\u4e0b\u5b57\u6bb5\uff1a\n```yaml\nsource: \"inherited\"\nimported_from: \"team-instincts.yaml\"\nimported_at: \"2025-01-22T10:30:00Z\"\noriginal_source: \"session-observation\"  # \u6216 \"repo-analysis\"\n```\n\n## \u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u96c6\u6210\n\n\u4ece\u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u5bfc\u5165\u65f6\uff1a\n\n```\n/instinct-import --from-skill-creator acme/webapp\n```\n\n\u8fd9\u5c06\u83b7\u53d6\u901a\u8fc7\u4ed3\u5e93\u5206\u6790\u751f\u6210\u7684\u76f4\u89c9\uff1a\n- \u6765\u6e90\uff1a`repo-analysis`\n- \u8f83\u9ad8\u7684\u521d\u59cb\u7f6e\u4fe1\u5ea6\uff080.7+\uff09\n- \u5df2\u94fe\u63a5\u5230\u6e90\u4ed3\u5e93\n\n## \u53c2\u6570\u6807\u5fd7\uff08Flags\uff09\n\n- `--dry-run`\uff1a\u9884\u89c8\u800c\u4e0d\u6267\u884c\u5bfc\u5165\n- `--force`\uff1a\u5373\u4f7f\u5b58\u5728\u51b2\u7a81\u4e5f\u5f3a\u5236\u5bfc\u5165\n- `--merge-strategy <higher|local|import>`\uff1a\u5982\u4f55\u5904\u7406\u91cd\u590d\u9879\n- `--from-skill-creator <owner/repo>`\uff1a\u4ece\u6280\u80fd\u751f\u6210\u5668\uff08Skill Creator\uff09\u5206\u6790\u7ed3\u679c\u5bfc\u5165\n- `--min-confidence <n>`\uff1a\u4ec5\u5bfc\u5165\u7f6e\u4fe1\u5ea6\u9ad8\u4e8e\u9608\u503c\u7684\u76f4\u89c9\n\n## \u8f93\u51fa\n\n\u5bfc\u5165\u5b8c\u6210\u540e\uff1a\n```\n\u2705 \u5bfc\u5165\u5b8c\u6210\uff01\n\n\u5df2\u6dfb\u52a0\uff1a8 \u6761\u76f4\u89c9\n\u5df2\u66f4\u65b0\uff1a1 \u6761\u76f4\u89c9\n\u5df2\u8df3\u8fc7\uff1a3 \u6761\u76f4\u89c9\uff082 \u4e2a\u91cd\u590d\uff0c1 \u4e2a\u51b2\u7a81\uff09\n\n\u65b0\u76f4\u89c9\u5df2\u4fdd\u5b58\u81f3\uff1a~/.claude/homunculus/instincts/inherited/\n\n\u8fd0\u884c /instinct-status \u67e5\u770b\u6240\u6709\u76f4\u89c9\u3002\n```"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/continuous-learning-v2/commands/instinct-status.md": {
-    "md5": "6e51fc9802148657184875fb624d5953",
+    "md5": "3606345a74a78bcff12732b12d83ca7f",
     "content": "---\nname: instinct-status\ndescription: \u663e\u793a\u6240\u6709\u5df2\u5b66\u4e60\u7684\u76f4\u89c9\uff08Instincts\uff09\u53ca\u5176\u7f6e\u4fe1\u5ea6\u6c34\u5e73\ncommand: /instinct-status\nimplementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py status\n---\n\n# Instinct Status \u547d\u4ee4\n\n\u6309\u9886\u57df\uff08Domain\uff09\u5206\u7ec4\u663e\u793a\u6240\u6709\u5df2\u5b66\u4e60\u7684\u76f4\u89c9\uff08Instincts\uff09\u53ca\u5176\u7f6e\u4fe1\u5ea6\u5f97\u5206\u3002\n\n## \u5b9e\u73b0\n\n```bash\npython3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py status\n```\n\n## \u7528\u6cd5\n\n```\n/instinct-status\n/instinct-status --domain code-style\n/instinct-status --low-confidence\n```\n\n## \u6267\u884c\u903b\u8f91\n\n1. \u4ece `~/.claude/homunculus/instincts/personal/` \u8bfb\u53d6\u6240\u6709\u4e2a\u4eba\u76f4\u89c9\u6587\u4ef6\n2. \u4ece `~/.claude/homunculus/instincts/inherited/` \u8bfb\u53d6\u7ee7\u627f\u7684\u76f4\u89c9\n3. \u6309\u9886\u57df\u5206\u7ec4\u663e\u793a\uff0c\u5e76\u9644\u5e26\u7f6e\u4fe1\u5ea6\u8fdb\u5ea6\u6761\n\n## \u8f93\u51fa\u683c\u5f0f\n\n```\n\ud83d\udcca \u76f4\u89c9\u72b6\u6001 (Instinct Status)\n==================\n\n## \u4ee3\u7801\u98ce\u683c (4 \u4e2a\u76f4\u89c9)\n\n### prefer-functional-style\n\u89e6\u53d1\u6761\u4ef6 (Trigger)\uff1a\u7f16\u5199\u65b0\u51fd\u6570\u65f6\n\u52a8\u4f5c (Action)\uff1a\u4f18\u5148\u4f7f\u7528\u51fd\u6570\u5f0f\u6a21\u5f0f\u800c\u975e\u7c7b\n\u7f6e\u4fe1\u5ea6 (Confidence)\uff1a\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591 80%\n\u6765\u6e90 (Source)\uff1asession-observation | \u6700\u540e\u66f4\u65b0\uff1a2025-01-22\n\n### use-path-aliases\n\u89e6\u53d1\u6761\u4ef6 (Trigger)\uff1a\u5bfc\u5165\u6a21\u5757\u65f6\n\u52a8\u4f5c (Action)\uff1a\u4f7f\u7528 @/ \u8def\u5f84\u522b\u540d\u800c\u975e\u76f8\u5bf9\u5bfc\u5165\n\u7f6e\u4fe1\u5ea6 (Confidence)\uff1a\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591 60%\n\u6765\u6e90 (Source)\uff1arepo-analysis (github.com/acme/webapp)\n\n## \u6d4b\u8bd5 (2 \u4e2a\u76f4\u89c9)\n\n### test-first-workflow\n\u89e6\u53d1\u6761\u4ef6 (Trigger)\uff1a\u6dfb\u52a0\u65b0\u529f\u80fd\u65f6\n\u52a8\u4f5c (Action)\uff1a\u5148\u5199\u6d4b\u8bd5\uff0c\u518d\u5199\u5b9e\u73b0\n\u7f6e\u4fe1\u5ea6 (Confidence)\uff1a\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2591 90%\n\u6765\u6e90 (Source)\uff1asession-observation\n\n## \u5de5\u4f5c\u6d41 (3 \u4e2a\u76f4\u89c9)\n\n### grep-before-edit\n\u89e6\u53d1\u6761\u4ef6 (Trigger)\uff1a\u4fee\u6539\u4ee3\u7801\u65f6\n\u52a8\u4f5c (Action)\uff1a\u5148\u7528 Grep \u641c\u7d22\uff0c\u7528 Read \u786e\u8ba4\uff0c\u518d\u8fdb\u884c\u7f16\u8f91 (Edit)\n\u7f6e\u4fe1\u5ea6 (Confidence)\uff1a\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591\u2591 70%\n\u6765\u6e90 (Source)\uff1asession-observation\n\n---\n\u603b\u8ba1\uff1a9 \u4e2a\u76f4\u89c9\uff084 \u4e2a\u4e2a\u4eba\uff0c5 \u4e2a\u7ee7\u627f\uff09\n\u89c2\u5bdf\u5668 (Observer)\uff1a\u8fd0\u884c\u4e2d\uff08\u4e0a\u6b21\u5206\u6790\uff1a5 \u5206\u949f\u524d\uff09\n```\n\n## \u53c2\u6570 (Flags)\n\n- `--domain <name>`\uff1a\u6309\u9886\u57df\u8fc7\u6ee4\uff08code-style\u3001testing\u3001git \u7b49\uff09\n- `--low-confidence`\uff1a\u4ec5\u663e\u793a\u7f6e\u4fe1\u5ea6 < 0.5 \u7684\u76f4\u89c9\n- `--high-confidence`\uff1a\u4ec5\u663e\u793a\u7f6e\u4fe1\u5ea6 >= 0.7 \u7684\u76f4\u89c9\n- `--source <type>`\uff1a\u6309\u6765\u6e90\u8fc7\u6ee4\uff08session-observation\u3001repo-analysis\u3001inherited\uff09\n- `--json`\uff1a\u4ee5 JSON \u683c\u5f0f\u8f93\u51fa\uff0c\u4f9b\u7a0b\u5e8f\u5316\u4f7f\u7528\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/continuous-learning-v2/commands/evolve.md": {
-    "md5": "38788e8e8e5ee69c2f6236ff70bfa55a",
-    "content": "---\nname: evolve\ndescription: \u5c06\u76f8\u5173\u672c\u80fd\uff08Instincts\uff09\u805a\u7c7b\u4e3a\u6280\u80fd\u3001\u547d\u4ee4\u6216\u667a\u80fd\u4f53\ncommand: /evolve\nimplementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve\n---\n\n# \u6f14\u8fdb\uff08Evolve\uff09\u547d\u4ee4\n\n## \u5b9e\u73b0\n\n```bash\npython3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]\n```\n\n\u5206\u6790\u672c\u80fd\uff08Instincts\uff09\u5e76\u5c06\u76f8\u5173\u7684\u672c\u80fd\u805a\u7c7b\u4e3a\u66f4\u9ad8\u7ea7\u522b\u7684\u7ed3\u6784\uff1a\n- **\u547d\u4ee4\uff08Commands\uff09**\uff1a\u5f53\u672c\u80fd\u63cf\u8ff0\u7684\u662f\u7528\u6237\u8c03\u7528\u7684\u64cd\u4f5c\u65f6\n- **\u6280\u80fd\uff08Skills\uff09**\uff1a\u5f53\u672c\u80fd\u63cf\u8ff0\u7684\u662f\u81ea\u52a8\u89e6\u53d1\u7684\u884c\u4e3a\u65f6\n- **\u667a\u80fd\u4f53\uff08Agents\uff09**\uff1a\u5f53\u672c\u80fd\u63cf\u8ff0\u7684\u662f\u590d\u6742\u7684\u3001\u591a\u6b65\u9aa4\u7684\u8fc7\u7a0b\u65f6\n\n## \u7528\u6cd5\n\n```\n/evolve                    # \u5206\u6790\u6240\u6709\u672c\u80fd\u5e76\u5efa\u8bae\u6f14\u8fdb\u65b9\u6848\n/evolve --domain testing   # \u4ec5\u6f14\u8fdb\u6d4b\u8bd5\u9886\u57df\uff08testing domain\uff09\u4e2d\u7684\u672c\u80fd\n/evolve --dry-run          # \u663e\u793a\u5c06\u8981\u521b\u5efa\u7684\u5185\u5bb9\u800c\u4e0d\u5b9e\u9645\u6267\u884c\n/evolve --threshold 5      # \u8981\u6c42 5 \u4e2a\u6216\u66f4\u591a\u76f8\u5173\u672c\u80fd\u624d\u8fdb\u884c\u805a\u7c7b\n```\n\n## \u6f14\u8fdb\u89c4\u5219\n\n### \u2192 \u547d\u4ee4\uff08Command\uff0c\u7528\u6237\u8c03\u7528\uff09\n\u5f53\u672c\u80fd\u63cf\u8ff0\u7528\u6237\u4f1a\u663e\u5f0f\u8bf7\u6c42\u7684\u64cd\u4f5c\u65f6\uff1a\n- \u591a\u4e2a\u5173\u4e8e\u201c\u5f53\u7528\u6237\u8981\u6c42...\u201d\u7684\u672c\u80fd\n- \u5e26\u6709\u201c\u5728\u521b\u5efa\u65b0\u7684 X \u65f6\u201d\u7b49\u89e6\u53d1\u5668\u7684\u672c\u80fd\n- \u9075\u5faa\u53ef\u91cd\u590d\u5e8f\u5217\u7684\u672c\u80fd\n\n\u793a\u4f8b\uff1a\n- `new-table-step1`\uff1a\u201c\u5728\u6dfb\u52a0\u6570\u636e\u5e93\u8868\u65f6\uff0c\u521b\u5efa\u8fc1\u79fb\u6587\u4ef6\u201d\n- `new-table-step2`\uff1a\u201c\u5728\u6dfb\u52a0\u6570\u636e\u5e93\u8868\u65f6\uff0c\u66f4\u65b0 schema\u201d\n- `new-table-step3`\uff1a\u201c\u5728\u6dfb\u52a0\u6570\u636e\u5e93\u8868\u65f6\uff0c\u91cd\u65b0\u751f\u6210\u7c7b\u578b\u201d\n\n\u2192 \u521b\u5efa\uff1a`/new-table` \u547d\u4ee4\n\n### \u2192 \u6280\u80fd\uff08Skill\uff0c\u81ea\u52a8\u89e6\u53d1\uff09\n\u5f53\u672c\u80fd\u63cf\u8ff0\u5e94\u8be5\u81ea\u52a8\u53d1\u751f\u7684\u884c\u4e3a\u65f6\uff1a\n- \u6a21\u5f0f\u5339\u914d\u89e6\u53d1\u5668\n- \u9519\u8bef\u5904\u7406\u54cd\u5e94\n- \u4ee3\u7801\u98ce\u683c\u5f3a\u5236\u6267\u884c\n\n\u793a\u4f8b\uff1a\n- `prefer-functional`\uff1a\u201c\u5728\u7f16\u5199\u51fd\u6570\u65f6\uff0c\u4f18\u5148\u4f7f\u7528\u51fd\u6570\u5f0f\u98ce\u683c\u201d\n- `use-immutable`\uff1a\u201c\u5728\u4fee\u6539\u72b6\u6001\u65f6\uff0c\u4f7f\u7528\u4e0d\u53ef\u53d8\u6a21\u5f0f\u201d\n- `avoid-classes`\uff1a\u201c\u5728\u8bbe\u8ba1\u6a21\u5757\u65f6\uff0c\u907f\u514d\u57fa\u4e8e\u7c7b\u7684\u8bbe\u8ba1\u201d\n\n\u2192 \u521b\u5efa\uff1a`functional-patterns` \u6280\u80fd\n\n### \u2192 \u667a\u80fd\u4f53\uff08Agent\uff0c\u9700\u8981\u6df1\u5ea6/\u9694\u79bb\uff09\n\u5f53\u672c\u80fd\u63cf\u8ff0\u53d7\u76ca\u4e8e\u9694\u79bb\u7684\u590d\u6742\u3001\u591a\u6b65\u9aa4\u8fc7\u7a0b\u65f6\uff1a\n- \u8c03\u8bd5\u5de5\u4f5c\u6d41\uff08Workflow\uff09\n- \u91cd\u6784\u5e8f\u5217\n- \u7814\u7a76\u4efb\u52a1\n\n\u793a\u4f8b\uff1a\n- `debug-step1`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u5148\u68c0\u67e5\u65e5\u5fd7\u201d\n- `debug-step2`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u9694\u79bb\u6545\u969c\u7ec4\u4ef6\u201d\n- `debug-step3`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u521b\u5efa\u6700\u5c0f\u590d\u73b0\u201d\n- `debug-step4`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u901a\u8fc7\u6d4b\u8bd5\u9a8c\u8bc1\u4fee\u590d\u201d\n\n\u2192 \u521b\u5efa\uff1a`debugger` \u667a\u80fd\u4f53\n\n## \u6267\u884c\u6b65\u9aa4\n\n1. \u4ece `~/.claude/homunculus/instincts/` \u8bfb\u53d6\u6240\u6709\u672c\u80fd\n2. \u6309\u4ee5\u4e0b\u7ef4\u5ea6\u5bf9\u672c\u80fd\u8fdb\u884c\u5206\u7ec4\uff1a\n   - \u9886\u57df\u76f8\u4f3c\u6027\n   - \u89e6\u53d1\u6a21\u5f0f\u91cd\u53e0\n   - \u52a8\u4f5c\u5e8f\u5217\u5173\u7cfb\n3. \u5bf9\u4e8e\u6bcf\u4e2a\u5305\u542b 3 \u4e2a\u6216\u66f4\u591a\u76f8\u5173\u672c\u80fd\u7684\u805a\u7c7b\uff1a\n   - \u786e\u5b9a\u6f14\u8fdb\u7c7b\u578b\uff08\u547d\u4ee4/\u6280\u80fd/\u667a\u80fd\u4f53\uff09\n   - \u751f\u6210\u76f8\u5e94\u7684\u6587\u4ef6\n   - \u4fdd\u5b58\u5230 `~/.claude/homunculus/evolved/{commands,skills,agents}/`\n4. \u5c06\u6f14\u8fdb\u540e\u7684\u7ed3\u6784\u94fe\u63a5\u56de\u6e90\u672c\u80fd\n\n## \u8f93\u51fa\u683c\u5f0f\n\n```\n\ud83e\uddec \u6f14\u8fdb\u5206\u6790\uff08Evolve Analysis\uff09\n==================\n\n\u53d1\u73b0 3 \u4e2a\u5df2\u51c6\u5907\u597d\u6f14\u8fdb\u7684\u805a\u7c7b\uff1a\n\n## \u805a\u7c7b 1: \u6570\u636e\u5e93\u8fc1\u79fb\u5de5\u4f5c\u6d41\n\u672c\u80fd: new-table-migration, update-schema, regenerate-types\n\u7c7b\u578b: \u547d\u4ee4 (Command)\n\u7f6e\u4fe1\u5ea6: 85% (\u57fa\u4e8e 12 \u6b21\u89c2\u5bdf)\n\n\u5c06\u521b\u5efa: /new-table \u547d\u4ee4\n\u6587\u4ef6:\n  - ~/.claude/homunculus/evolved/commands/new-table.md\n\n## \u805a\u7c7b 2: \u51fd\u6570\u5f0f\u4ee3\u7801\u98ce\u683c\n\u672c\u80fd: prefer-functional, use-immutable, avoid-classes, pure-functions\n\u7c7b\u578b: \u6280\u80fd (Skill)\n\u7f6e\u4fe1\u5ea6: 78% (\u57fa\u4e8e 8 \u6b21\u89c2\u5bdf)\n\n\u5c06\u521b\u5efa: functional-patterns \u6280\u80fd\n\u6587\u4ef6:\n  - ~/.claude/homunculus/evolved/skills/functional-patterns.md\n\n## \u805a\u7c7b 3: \u8c03\u8bd5\u8fc7\u7a0b\n\u672c\u80fd: debug-check-logs, debug-isolate, debug-reproduce, debug-verify\n\u7c7b\u578b: \u667a\u80fd\u4f53 (Agent)\n\u7f6e\u4fe1\u5ea6: 72% (\u57fa\u4e8e 6 \u6b21\u89c2\u5bdf)\n\n\u5c06\u521b\u5efa: debugger \u667a\u80fd\u4f53\n\u6587\u4ef6:\n  - ~/.claude/homunculus/evolved/agents/debugger.md\n\n---\n\u8fd0\u884c `/evolve --execute` \u6765\u521b\u5efa\u8fd9\u4e9b\u6587\u4ef6\u3002\n```\n\n## \u6807\u5fd7\uff08Flags\uff09\n\n- `--execute`\uff1a\u5b9e\u9645\u521b\u5efa\u6f14\u8fdb\u540e\u7684\u7ed3\u6784\uff08\u9ed8\u8ba4\u4e3a\u9884\u89c8\uff09\n- `--dry-run`\uff1a\u9884\u89c8\u800c\u4e0d\u521b\u5efa\n- `--domain <name>`\uff1a\u4ec5\u6f14\u8fdb\u6307\u5b9a\u9886\u57df\u4e2d\u7684\u672c\u80fd\n- `--threshold <n>`\uff1a\u5f62\u6210\u805a\u7c7b\u6240\u9700\u7684\u6700\u5c0f\u672c\u80fd\u6570\u91cf\uff08\u9ed8\u8ba4\uff1a3\uff09\n- `--type <command|skill|agent>`\uff1a\u4ec5\u521b\u5efa\u6307\u5b9a\u7c7b\u578b\n\n## \u751f\u6210\u6587\u4ef6\u683c\u5f0f\n\n### \u547d\u4ee4 (Command)\n```markdown\n---\nname: new-table\ndescription: \u521b\u5efa\u5e26\u6709\u8fc1\u79fb\u3001schema \u66f4\u65b0\u548c\u7c7b\u578b\u751f\u6210\u7684\u6570\u636e\u5e93\u65b0\u8868\ncommand: /new-table\nevolved_from:\n  - new-table-migration\n  - update-schema\n  - regenerate-types\n---\n\n# New Table \u547d\u4ee4\n\n[\u57fa\u4e8e\u805a\u7c7b\u672c\u80fd\u751f\u6210\u7684\u5177\u4f53\u5185\u5bb9]\n\n## \u6b65\u9aa4\n1. ...\n2. ...\n```\n\n### \u6280\u80fd (Skill)\n```markdown\n---\nname: functional-patterns\ndescription: \u5f3a\u5236\u6267\u884c\u51fd\u6570\u5f0f\u7f16\u7a0b\u6a21\u5f0f\nevolved_from:\n  - prefer-functional\n  - use-immutable\n  - avoid-classes\n---\n\n# Functional Patterns \u6280\u80fd\n\n[\u57fa\u4e8e\u805a\u7c7b\u672c\u80fd\u751f\u6210\u7684\u5177\u4f53\u5185\u5bb9]\n```\n\n### \u667a\u80fd\u4f53 (Agent)\n```markdown\n---\nname: debugger\ndescription: \u7cfb\u7edf\u5316\u8c03\u8bd5\u667a\u80fd\u4f53\nmodel: sonnet\nevolved_from:\n  - debug-check-logs\n  - debug-isolate\n  - debug-reproduce\n---\n\n# Debugger \u667a\u80fd\u4f53\n\n[\u57fa\u4e8e\u805a\u7c7b\u672c\u80fd\u751f\u6210\u7684\u5177\u4f53\u5185\u5bb9]\n```\n"
+    "md5": "cfe5918aa83686faa00eaa3efd77f697",
+    "content": "---\nname: evolve\ndescription: \u5c06\u76f8\u5173\u672c\u80fd (Instincts) \u805a\u7c7b\u4e3a\u6280\u80fd (Skills)\u3001\u547d\u4ee4 (Commands) \u6216\u667a\u80fd\u4f53 (Agents)\ncommand: /evolve\nimplementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve\n---\n\n# \u6f14\u8fdb (Evolve) \u547d\u4ee4\n\n## \u5b9e\u73b0\n\n```bash\npython3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]\n```\n\n\u5206\u6790\u672c\u80fd (Instincts) \u5e76\u5c06\u76f8\u5173\u7684\u672c\u80fd\u805a\u7c7b\u4e3a\u66f4\u9ad8\u7ea7\u522b\u7684\u7ed3\u6784\uff1a\n- **\u547d\u4ee4 (Commands)**\uff1a\u5f53\u672c\u80fd\u63cf\u8ff0\u7684\u662f\u7528\u6237\u8c03\u7528\u7684\u64cd\u4f5c\u65f6\n- **\u6280\u80fd (Skills)**\uff1a\u5f53\u672c\u80fd\u63cf\u8ff0\u7684\u662f\u81ea\u52a8\u89e6\u53d1\u7684\u884c\u4e3a\u65f6\n- **\u667a\u80fd\u4f53 (Agents)**\uff1a\u5f53\u672c\u80fd\u63cf\u8ff0\u7684\u662f\u590d\u6742\u7684\u3001\u591a\u6b65\u9aa4\u7684\u8fc7\u7a0b\u65f6\n\n## \u7528\u6cd5\n\n```\n/evolve                    # \u5206\u6790\u6240\u6709\u672c\u80fd\u5e76\u5efa\u8bae\u6f14\u8fdb\u65b9\u6848\n/evolve --domain testing   # \u4ec5\u6f14\u8fdb\u6d4b\u8bd5\u9886\u57df (testing domain) \u4e2d\u7684\u672c\u80fd\n/evolve --dry-run          # \u663e\u793a\u5c06\u8981\u521b\u5efa\u7684\u5185\u5bb9\u800c\u4e0d\u5b9e\u9645\u6267\u884c\n/evolve --threshold 5      # \u8981\u6c42 5 \u4e2a\u6216\u66f4\u591a\u76f8\u5173\u672c\u80fd\u624d\u8fdb\u884c\u805a\u7c7b\n```\n\n## \u6f14\u8fdb\u89c4\u5219\n\n### \u2192 \u547d\u4ee4 (Command\uff0c\u7528\u6237\u8c03\u7528)\n\u5f53\u672c\u80fd\u63cf\u8ff0\u7528\u6237\u4f1a\u663e\u5f0f\u8bf7\u6c42\u7684\u64cd\u4f5c\u65f6\uff1a\n- \u591a\u4e2a\u5173\u4e8e\u201c\u5f53\u7528\u6237\u8981\u6c42...\u201d\u7684\u672c\u80fd\n- \u5e26\u6709\u201c\u5728\u521b\u5efa\u65b0\u7684 X \u65f6\u201d\u7b49\u89e6\u53d1\u5668\u7684\u672c\u80fd\n- \u9075\u5faa\u53ef\u91cd\u590d\u5e8f\u5217\u7684\u672c\u80fd\n\n\u793a\u4f8b\uff1a\n- `new-table-step1`\uff1a\u201c\u5728\u6dfb\u52a0\u6570\u636e\u5e93\u8868\u65f6\uff0c\u521b\u5efa\u8fc1\u79fb\u6587\u4ef6\u201d\n- `new-table-step2`\uff1a\u201c\u5728\u6dfb\u52a0\u6570\u636e\u5e93\u8868\u65f6\uff0c\u66f4\u65b0 schema\u201d\n- `new-table-step3`\uff1a\u201c\u5728\u6dfb\u52a0\u6570\u636e\u5e93\u8868\u65f6\uff0c\u91cd\u65b0\u751f\u6210\u7c7b\u578b\u201d\n\n\u2192 \u521b\u5efa\uff1a`/new-table` \u547d\u4ee4\n\n### \u2192 \u6280\u80fd (Skill\uff0c\u81ea\u52a8\u89e6\u53d1)\n\u5f53\u672c\u80fd\u63cf\u8ff0\u5e94\u8be5\u81ea\u52a8\u53d1\u751f\u7684\u884c\u4e3a\u65f6\uff1a\n- \u6a21\u5f0f\u5339\u914d\u89e6\u53d1\u5668\n- \u9519\u8bef\u5904\u7406\u54cd\u5e94\n- \u4ee3\u7801\u98ce\u683c\u5f3a\u5236\u6267\u884c\n\n\u793a\u4f8b\uff1a\n- `prefer-functional`\uff1a\u201c\u5728\u7f16\u5199\u51fd\u6570\u65f6\uff0c\u4f18\u5148\u4f7f\u7528\u51fd\u6570\u5f0f\u98ce\u683c\u201d\n- `use-immutable`\uff1a\u201c\u5728\u4fee\u6539\u72b6\u6001\u65f6\uff0c\u4f7f\u7528\u4e0d\u53ef\u53d8\u6a21\u5f0f\u201d\n- `avoid-classes`\uff1a\u201c\u5728\u8bbe\u8ba1\u6a21\u5757\u65f6\uff0c\u907f\u514d\u57fa\u4e8e\u7c7b\u7684\u8bbe\u8ba1\u201d\n\n\u2192 \u521b\u5efa\uff1a`functional-patterns` \u6280\u80fd\n\n### \u2192 \u667a\u80fd\u4f53 (Agent\uff0c\u9700\u8981\u6df1\u5ea6/\u9694\u79bb)\n\u5f53\u672c\u80fd\u63cf\u8ff0\u53d7\u76ca\u4e8e\u9694\u79bb\u7684\u590d\u6742\u3001\u591a\u6b65\u9aa4\u8fc7\u7a0b\u65f6\uff1a\n- \u8c03\u8bd5\u5de5\u4f5c\u6d41 (Workflow)\n- \u91cd\u6784\u5e8f\u5217\n- \u7814\u7a76\u4efb\u52a1\n\n\u793a\u4f8b\uff1a\n- `debug-step1`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u5148\u68c0\u67e5\u65e5\u5fd7\u201d\n- `debug-step2`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u9694\u79bb\u6545\u969c\u7ec4\u4ef6\u201d\n- `debug-step3`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u521b\u5efa\u6700\u5c0f\u590d\u73b0\u201d\n- `debug-step4`\uff1a\u201c\u8c03\u8bd5\u65f6\uff0c\u901a\u8fc7\u6d4b\u8bd5\u9a8c\u8bc1\u4fee\u590d\u201d\n\n\u2192 \u521b\u5efa\uff1a`debugger` \u667a\u80fd\u4f53\n\n## \u6267\u884c\u6b65\u9aa4\n\n1. \u4ece `~/.claude/homunculus/instincts/` \u8bfb\u53d6\u6240\u6709\u672c\u80fd\n2. \u6309\u4ee5\u4e0b\u7ef4\u5ea6\u5bf9\u672c\u80fd\u8fdb\u884c\u5206\u7ec4\uff1a\n   - \u9886\u57df\u76f8\u4f3c\u6027\n   - \u89e6\u53d1\u6a21\u5f0f\u91cd\u53e0\n   - \u52a8\u4f5c\u5e8f\u5217\u5173\u7cfb\n3. \u5bf9\u4e8e\u6bcf\u4e2a\u5305\u542b 3 \u4e2a\u6216\u66f4\u591a\u76f8\u5173\u672c\u80fd\u7684\u805a\u7c7b\uff1a\n   - \u786e\u5b9a\u6f14\u8fdb\u7c7b\u578b\uff08\u547d\u4ee4/\u6280\u80fd/\u667a\u80fd\u4f53\uff09\n   - \u751f\u6210\u76f8\u5e94\u7684\u6587\u4ef6\n   - \u4fdd\u5b58\u5230 `~/.claude/homunculus/evolved/{commands,skills,agents}/`\n4. \u5c06\u6f14\u8fdb\u540e\u7684\u7ed3\u6784\u94fe\u63a5\u56de\u6e90\u672c\u80fd\n\n## \u8f93\u51fa\u683c\u5f0f\n\n```\n\ud83e\uddec \u6f14\u8fdb\u5206\u6790 (Evolve Analysis)\n==================\n\n\u53d1\u73b0 3 \u4e2a\u5df2\u51c6\u5907\u597d\u6f14\u8fdb\u7684\u805a\u7c7b\uff1a\n\n## \u805a\u7c7b 1: \u6570\u636e\u5e93\u8fc1\u79fb\u5de5\u4f5c\u6d41\n\u672c\u80fd: new-table-migration, update-schema, regenerate-types\n\u7c7b\u578b: \u547d\u4ee4 (Command)\n\u7f6e\u4fe1\u5ea6: 85% (\u57fa\u4e8e 12 \u6b21\u89c2\u5bdf)\n\n\u5c06\u521b\u5efa: /new-table \u547d\u4ee4\n\u6587\u4ef6:\n  - ~/.claude/homunculus/evolved/commands/new-table.md\n\n## \u805a\u7c7b 2: \u51fd\u6570\u5f0f\u4ee3\u7801\u98ce\u683c\n\u672c\u80fd: prefer-functional, use-immutable, avoid-classes, pure-functions\n\u7c7b\u578b: \u6280\u80fd (Skill)\n\u7f6e\u4fe1\u5ea6: 78% (\u57fa\u4e8e 8 \u6b21\u89c2\u5bdf)\n\n\u5c06\u521b\u5efa: functional-patterns \u6280\u80fd\n\u6587\u4ef6:\n  - ~/.claude/homunculus/evolved/skills/functional-patterns.md\n\n## \u805a\u7c7b 3: \u8c03\u8bd5\u8fc7\u7a0b\n\u672c\u80fd: debug-check-logs, debug-isolate, debug-reproduce, debug-verify\n\u7c7b\u578b: \u667a\u80fd\u4f53 (Agent)\n\u7f6e\u4fe1\u5ea6: 72% (\u57fa\u4e8e 6 \u6b21\u89c2\u5bdf)\n\n\u5c06\u521b\u5efa: debugger \u667a\u80fd\u4f53\n\u6587\u4ef6:\n  - ~/.claude/homunculus/evolved/agents/debugger.md\n\n---\n\u8fd0\u884c `/evolve --execute` \u6765\u521b\u5efa\u8fd9\u4e9b\u6587\u4ef6\u3002\n```\n\n## \u6807\u5fd7 (Flags)\n\n- `--execute`\uff1a\u5b9e\u9645\u521b\u5efa\u6f14\u8fdb\u540e\u7684\u7ed3\u6784\uff08\u9ed8\u8ba4\u4e3a\u9884\u89c8\uff09\n- `--dry-run`\uff1a\u9884\u89c8\u800c\u4e0d\u521b\u5efa\n- `--domain <name>`\uff1a\u4ec5\u6f14\u8fdb\u6307\u5b9a\u9886\u57df\u4e2d\u7684\u672c\u80fd\n- `--threshold <n>`\uff1a\u5f62\u6210\u805a\u7c7b\u6240\u9700\u7684\u6700\u5c0f\u672c\u80fd\u6570\u91cf\uff08\u9ed8\u8ba4\uff1a3\uff09\n- `--type <command|skill|agent>`\uff1a\u4ec5\u521b\u5efa\u6307\u5b9a\u7c7b\u578b\n\n## \u751f\u6210\u6587\u4ef6\u683c\u5f0f\n\n### \u547d\u4ee4 (Command)\n```markdown\n---\nname: new-table\ndescription: \u521b\u5efa\u5e26\u6709\u8fc1\u79fb\u3001schema \u66f4\u65b0\u548c\u7c7b\u578b\u751f\u6210\u7684\u6570\u636e\u5e93\u65b0\u8868\ncommand: /new-table\nevolved_from:\n  - new-table-migration\n  - update-schema\n  - regenerate-types\n---\n\n# New Table \u547d\u4ee4\n\n[\u57fa\u4e8e\u805a\u7c7b\u672c\u80fd\u751f\u6210\u7684\u5177\u4f53\u5185\u5bb9]\n\n## \u6b65\u9aa4\n1. ...\n2. ...\n```\n\n### \u6280\u80fd (Skill)\n```markdown\n---\nname: functional-patterns\ndescription: \u5f3a\u5236\u6267\u884c\u51fd\u6570\u5f0f\u7f16\u7a0b\u6a21\u5f0f\nevolved_from:\n  - prefer-functional\n  - use-immutable\n  - avoid-classes\n---\n\n# Functional Patterns \u6280\u80fd\n\n[\u57fa\u4e8e\u805a\u7c7b\u672c\u80fd\u751f\u6210\u7684\u5177\u4f53\u5185\u5bb9]\n```\n\n### \u667a\u80fd\u4f53 (Agent)\n```markdown\n---\nname: debugger\ndescription: \u7cfb\u7edf\u5316\u8c03\u8bd5\u667a\u80fd\u4f53\nmodel: sonnet\nevolved_from:\n  - debug-check-logs\n  - debug-isolate\n  - debug-reproduce\n---\n\n# Debugger \u667a\u80fd\u4f53\n\n[\u57fa\u4e8e\u805a\u7c7b\u672c\u80fd\u751f\u6210\u7684\u5177\u4f53\u5185\u5bb9]\n```\n"
   },
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/skills/verification-loop/SKILL.md": {
     "md5": "98d63dbc797baf9171b30b7da1080a0c",
@@ -294,5 +294,13 @@
   "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/commands/go-test.md": {
     "md5": "ea0812790d72de0251a961ad3a5a1534",
     "content": "---\ndescription: \u5f3a\u5236\u6267\u884c Go \u7684\u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\uff08TDD\uff09\u5de5\u4f5c\u6d41\u3002\u5148\u7f16\u5199\u8868\u9a71\u52a8\u6d4b\u8bd5\uff08Table-Driven Tests\uff09\uff0c\u7136\u540e\u8fdb\u884c\u5b9e\u73b0\u3002\u4f7f\u7528 go test -cover \u9a8c\u8bc1 80% \u4ee5\u4e0a\u7684\u8986\u76d6\u7387\u3002\n---\n\n# Go TDD \u547d\u4ee4\n\n\u6b64\u547d\u4ee4\u4f7f\u7528\u5730\u9053\u7684 Go \u6d4b\u8bd5\u6a21\u5f0f\u4e3a Go \u4ee3\u7801\u5f3a\u5236\u6267\u884c\u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\uff08Test-Driven Development\uff0cTDD\uff09\u65b9\u6cd5\u8bba\u3002\n\n## \u6b64\u547d\u4ee4\u7684\u4f5c\u7528\n\n1. **\u5b9a\u4e49\u7c7b\u578b/\u63a5\u53e3**\uff1a\u9996\u5148\u642d\u5efa\u51fd\u6570\u7b7e\u540d\u7684\u652f\u67b6\n2. **\u7f16\u5199\u8868\u9a71\u52a8\u6d4b\u8bd5\uff08Table-Driven Tests\uff09**\uff1a\u521b\u5efa\u5168\u9762\u7684\u6d4b\u8bd5\u7528\u4f8b\uff08RED/\u7ea2\u706f\uff09\n3. **\u8fd0\u884c\u6d4b\u8bd5**\uff1a\u9a8c\u8bc1\u6d4b\u8bd5\u56e0\u9884\u671f\u7684\u539f\u56e0\u5931\u8d25\n4. **\u5b9e\u73b0\u4ee3\u7801**\uff1a\u7f16\u5199\u901a\u8fc7\u6d4b\u8bd5\u6240\u9700\u7684\u6700\u5c11\u4ee3\u7801\uff08GREEN/\u7eff\u706f\uff09\n5. **\u91cd\u6784\uff08Refactor\uff09**\uff1a\u5728\u4fdd\u6301\u6d4b\u8bd5\u901a\u8fc7\u7684\u540c\u65f6\u4f18\u5316\u4ee3\u7801\n6. **\u68c0\u67e5\u8986\u76d6\u7387**\uff1a\u786e\u4fdd 80% \u4ee5\u4e0a\u7684\u8986\u76d6\u7387\n\n## \u4f55\u65f6\u4f7f\u7528\n\n\u5728\u4ee5\u4e0b\u573a\u666f\u4f7f\u7528 `/go-test`\uff1a\n- \u5b9e\u73b0\u65b0\u7684 Go \u51fd\u6570\n- \u4e3a\u73b0\u6709\u4ee3\u7801\u589e\u52a0\u6d4b\u8bd5\u8986\u76d6\u7387\n- \u4fee\u590d Bug\uff08\u5148\u7f16\u5199\u5931\u8d25\u7684\u6d4b\u8bd5\uff09\n- \u6784\u5efa\u6838\u5fc3\u4e1a\u52a1\u903b\u8f91\n- \u5728 Go \u4e2d\u5b66\u4e60 TDD \u5de5\u4f5c\u6d41\uff08Workflow\uff09\n\n## TDD \u5468\u671f\n\n```\nRED\uff08\u7ea2\u706f\uff09      \u2192 \u7f16\u5199\u5931\u8d25\u7684\u8868\u9a71\u52a8\u6d4b\u8bd5\nGREEN\uff08\u7eff\u706f\uff09    \u2192 \u5b9e\u73b0\u901a\u8fc7\u6d4b\u8bd5\u6240\u9700\u7684\u6700\u5c11\u4ee3\u7801\nREFACTOR\uff08\u91cd\u6784\uff09 \u2192 \u4f18\u5316\u4ee3\u7801\uff0c\u4fdd\u6301\u6d4b\u8bd5\u901a\u8fc7\nREPEAT\uff08\u5faa\u73af\uff09   \u2192 \u4e0b\u4e00\u4e2a\u6d4b\u8bd5\u7528\u4f8b\n```\n\n## \u4f1a\u8bdd\u793a\u4f8b\n\n```text\nUser: /go-test \u6211\u9700\u8981\u4e00\u4e2a\u9a8c\u8bc1\u7535\u5b50\u90ae\u4ef6\u5730\u5740\u7684\u51fd\u6570\n\nAgent:\n# TDD \u4f1a\u8bdd\uff1a\u7535\u5b50\u90ae\u4ef6\u9a8c\u8bc1\u5668\n\n## \u7b2c 1 \u6b65\uff1a\u5b9a\u4e49\u63a5\u53e3\n\n```go\n// validator/email.go\npackage validator\n\n// ValidateEmail \u68c0\u67e5\u7ed9\u5b9a\u7684\u5b57\u7b26\u4e32\u662f\u5426\u4e3a\u6709\u6548\u7684\u7535\u5b50\u90ae\u4ef6\u5730\u5740\u3002\n// \u5982\u679c\u6709\u6548\u8fd4\u56de nil\uff0c\u5426\u5219\u8fd4\u56de\u63cf\u8ff0\u95ee\u9898\u7684\u9519\u8bef\u3002\nfunc ValidateEmail(email string) error {\n    panic(\"not implemented\")\n}\n```\n\n## \u7b2c 2 \u6b65\uff1a\u7f16\u5199\u8868\u9a71\u52a8\u6d4b\u8bd5 (RED)\n\n```go\n// validator/email_test.go\npackage validator\n\nimport (\n    \"testing\"\n)\n\nfunc TestValidateEmail(t *testing.T) {\n    tests := []struct {\n        name    string\n        email   string\n        wantErr bool\n    }{\n        // \u6709\u6548\u90ae\u7bb1\n        {\"simple email\", \"user@example.com\", false},\n        {\"with subdomain\", \"user@mail.example.com\", false},\n        {\"with plus\", \"user+tag@example.com\", false},\n        {\"with dots\", \"first.last@example.com\", false},\n\n        // \u65e0\u6548\u90ae\u7bb1\n        {\"empty string\", \"\", true},\n        {\"no at sign\", \"userexample.com\", true},\n        {\"no domain\", \"user@\", true},\n        {\"no local part\", \"@example.com\", true},\n        {\"double at\", \"user@@example.com\", true},\n        {\"spaces\", \"user @example.com\", true},\n        {\"no tld\", \"user@example\", true},\n    }\n\n    for _, tt := range tests {\n        t.Run(tt.name, func(t *testing.T) {\n            err := ValidateEmail(tt.email)\n            if tt.wantErr && err == nil {\n                t.Errorf(\"ValidateEmail(%q) = nil; want error\", tt.email)\n            }\n            if !tt.wantErr && err != nil {\n                t.Errorf(\"ValidateEmail(%q) = %v; want nil\", tt.email, err)\n            }\n        })\n    }\n}\n```\n\n## \u7b2c 3 \u6b65\uff1a\u8fd0\u884c\u6d4b\u8bd5 - \u9a8c\u8bc1\u5931\u8d25\n\n```bash\n$ go test ./validator/...\n\n--- FAIL: TestValidateEmail (0.00s)\n    --- FAIL: TestValidateEmail/simple_email (0.00s)\n        panic: not implemented\n\nFAIL\n```\n\n\u2713 \u6d4b\u8bd5\u5982\u9884\u671f\u822c\u5931\u8d25 (panic)\u3002\n\n## \u7b2c 4 \u6b65\uff1a\u5b9e\u73b0\u6700\u5c11\u4ee3\u7801 (GREEN)\n\n```go\n// validator/email.go\npackage validator\n\nimport (\n    \"errors\"\n    \"regexp\"\n)\n\nvar emailRegex = regexp.MustCompile(`^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$`)\n\nvar (\n    ErrEmailEmpty   = errors.New(\"email cannot be empty\")\n    ErrEmailInvalid = errors.New(\"email format is invalid\")\n)\n\nfunc ValidateEmail(email string) error {\n    if email == \"\" {\n        return ErrEmailEmpty\n    }\n    if !emailRegex.MatchString(email) {\n        return ErrEmailInvalid\n    }\n    return nil\n}\n```\n\n## \u7b2c 5 \u6b65\uff1a\u8fd0\u884c\u6d4b\u8bd5 - \u9a8c\u8bc1\u901a\u8fc7\n\n```bash\n$ go test ./validator/...\n\nPASS\nok      project/validator    0.003s\n```\n\n\u2713 \u6240\u6709\u6d4b\u8bd5\u901a\u8fc7\uff01\n\n## \u7b2c 6 \u6b65\uff1a\u68c0\u67e5\u8986\u76d6\u7387\n\n```bash\n$ go test -cover ./validator/...\n\nPASS\ncoverage: 100.0% of statements\nok      project/validator    0.003s\n```\n\n\u2713 \u8986\u76d6\u7387\uff1a100%\n\n## TDD \u5b8c\u6210\uff01\n```\n\n## \u6d4b\u8bd5\u6a21\u5f0f\n\n### \u8868\u9a71\u52a8\u6d4b\u8bd5\uff08Table-Driven Tests\uff09\n```go\ntests := []struct {\n    name     string\n    input    InputType\n    want     OutputType\n    wantErr  bool\n}{\n    {\"case 1\", input1, want1, false},\n    {\"case 2\", input2, want2, true},\n}\n\nfor _, tt := range tests {\n    t.Run(tt.name, func(t *testing.T) {\n        got, err := Function(tt.input)\n        // \u65ad\u8a00\u903b\u8f91\n    })\n}\n```\n\n### \u5e76\u884c\u6d4b\u8bd5\uff08Parallel Tests\uff09\n```go\nfor _, tt := range tests {\n    tt := tt // \u95ed\u5305\u6355\u83b7\u53d8\u91cf\n    t.Run(tt.name, func(t *testing.T) {\n        t.Parallel()\n        // \u6d4b\u8bd5\u4e3b\u4f53\n    })\n}\n```\n\n### \u6d4b\u8bd5\u52a9\u624b\uff08Test Helpers\uff09\n```go\nfunc setupTestDB(t *testing.T) *sql.DB {\n    t.Helper()\n    db := createDB()\n    t.Cleanup(func() { db.Close() })\n    return db\n}\n```\n\n## \u8986\u76d6\u7387\u547d\u4ee4\n\n```bash\n# \u57fa\u7840\u8986\u76d6\u7387\ngo test -cover ./...\n\n# \u751f\u6210\u8986\u76d6\u7387\u5206\u6790\u6587\u4ef6\ngo test -coverprofile=coverage.out ./...\n\n# \u5728\u6d4f\u89c8\u5668\u4e2d\u67e5\u770b\u7ed3\u679c\ngo tool cover -html=coverage.out\n\n# \u6309\u51fd\u6570\u67e5\u770b\u8986\u76d6\u7387\ngo tool cover -func=coverage.out\n\n# \u914d\u5408\u7ade\u6001\u68c0\u6d4b\u8fd0\u884c\ngo test -race -cover ./...\n```\n\n## \u8986\u76d6\u7387\u76ee\u6807\n\n| \u4ee3\u7801\u7c7b\u578b | \u76ee\u6807 |\n|-----------|--------|\n| \u6838\u5fc3\u4e1a\u52a1\u903b\u8f91 | 100% |\n| \u516c\u5171 API | 90%+ |\n| \u901a\u7528\u4ee3\u7801 | 80%+ |\n| \u751f\u6210\u7684\u4ee3\u7801 | \u6392\u9664 |\n\n## TDD \u6700\u4f73\u5b9e\u8df5\n\n**\u5efa\u8bae\u8fd9\u6837\u505a\uff1a**\n- **\u5148**\u5199\u6d4b\u8bd5\uff0c\u5728\u8fdb\u884c\u4efb\u4f55\u5b9e\u73b0\u4e4b\u524d\n- \u6bcf\u6b21\u4fee\u6539\u540e\u90fd\u8fd0\u884c\u6d4b\u8bd5\n- \u4f7f\u7528\u8868\u9a71\u52a8\u6d4b\u8bd5\u4ee5\u5b9e\u73b0\u5168\u9762\u7684\u8986\u76d6\n- \u6d4b\u8bd5\u884c\u4e3a\uff0c\u800c\u4e0d\u662f\u5b9e\u73b0\u7ec6\u8282\n- \u5305\u542b\u8fb9\u754c\u60c5\u51b5\uff08\u7a7a\u503c\u3001nil\u3001\u6700\u5927\u503c\uff09\n\n**\u4e0d\u8981\u8fd9\u6837\u505a\uff1a**\n- \u5728\u6d4b\u8bd5\u4e4b\u524d\u7f16\u5199\u5b9e\u73b0\u4ee3\u7801\n- \u8df3\u8fc7 RED\uff08\u7ea2\u706f\uff09\u9636\u6bb5\n- \u76f4\u63a5\u6d4b\u8bd5\u79c1\u6709\u51fd\u6570\n- \u5728\u6d4b\u8bd5\u4e2d\u4f7f\u7528 `time.Sleep`\n- \u5ffd\u7565\u4e0d\u7a33\u5b9a\u7684\u6d4b\u8bd5\uff08Flaky tests\uff09\n\n## \u76f8\u5173\u547d\u4ee4\n\n- `/go-build` - \u4fee\u590d\u6784\u5efa\u9519\u8bef\n- `/go-review` - \u5b9e\u73b0\u540e\u8bc4\u5ba1\u4ee3\u7801\n- `/verify` - \u8fd0\u884c\u5b8c\u6574\u9a8c\u8bc1\u5faa\u73af\n\n## \u76f8\u5173\u5185\u5bb9\n\n- \u6280\u80fd\uff08Skill\uff09\uff1a`skills/golang-testing/`\n- \u6280\u80fd\uff08Skill\uff09\uff1a`skills/tdd-workflow/`\n"
+  },
+  "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/docs/zh-TW/README.md": {
+    "md5": "fdb36f50f829447225f5dd8efa7e5aa2",
+    "content": "# Everything Claude Code\n\n[![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)\n![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)\n![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)\n![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)\n\n**\u6765\u81ea Anthropic \u9ed1\u5ba2\u677e\u51a0\u519b\u7684\u5b8c\u6574 Claude Code \u914d\u7f6e\u96c6\u3002**\n\n\u7ecf\u8fc7 10 \u4e2a\u6708\u4ee5\u4e0a\u5bc6\u96c6\u65e5\u5e38\u4f7f\u7528\u3001\u6253\u9020\u771f\u5b9e\u4ea7\u54c1\u6240\u6dec\u70bc\u51fa\u7684\u751f\u4ea7\u5c31\u7eea\u667a\u80fd\u4f53\uff08Agents\uff09\u3001\u6280\u80fd\uff08Skills\uff09\u3001\u94a9\u5b50\uff08Hooks\uff09\u3001\u6307\u4ee4\uff08Commands\uff09\u3001\u89c4\u5219\uff08Rules\uff09\u548c MCP \u914d\u7f6e\u3002\n\n---\n\n## \u6307\u5357\n\n\u672c\u4ed3\u5e93\u4ec5\u5305\u542b\u539f\u59cb\u4ee3\u7801\u3002\u6307\u5357\u4f1a\u89e3\u91ca\u6240\u6709\u5185\u5bb9\u3002\n\n<table>\n<tr>\n<td width=\"50%\">\n<a href=\"https://x.com/affaanmustafa/status/2012378465664745795\">\n<img src=\"https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef\" alt=\"Everything Claude Code \u7b80\u660e\u6307\u5357\" />\n</a>\n</td>\n<td width=\"50%\">\n<a href=\"https://x.com/affaanmustafa/status/2014040193557471352\">\n<img src=\"https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0\" alt=\"Everything Claude Code \u5b8c\u6574\u6307\u5357\" />\n</a>\n</td>\n</tr>\n<tr>\n<td align=\"center\"><b>\u7b80\u660e\u6307\u5357</b><br/>\u914d\u7f6e\u3001\u57fa\u7840\u3001\u7406\u5ff5\u3002<b>\u8bf7\u5148\u9605\u8bfb\u6b64\u6307\u5357\u3002</b></td>\n<td align=\"center\"><b>\u5b8c\u6574\u6307\u5357</b><br/>Token \u4f18\u5316\u3001\u8bb0\u5fc6\u6301\u4e45\u5316\u3001\u8bc4\u4f30\u3001\u5e76\u884c\u5904\u7406\u3002</td>\n</tr>\n</table>\n\n| \u4e3b\u9898 | \u5b66\u4e60\u5185\u5bb9 |\n|------|----------|\n| Token \u4f18\u5316 | \u6a21\u578b\u9009\u62e9\u3001\u7cfb\u7edf\u63d0\u793a\u7cbe\u7b80\u3001\u540e\u53f0\u8fdb\u7a0b |\n| \u8bb0\u5fc6\u6301\u4e45\u5316 | \u81ea\u52a8\u8de8\u4f1a\u8bdd\uff08Session\uff09\u4fdd\u5b58/\u52a0\u8f7d\u4e0a\u4e0b\u6587\u7684\u94a9\u5b50\uff08Hooks\uff09 |\n| \u6301\u7eed\u5b66\u4e60 | \u4ece\u4f1a\u8bdd\u4e2d\u81ea\u52a8\u63d0\u53d6\u6a21\u5f0f\u5e76\u8f6c\u5316\u4e3a\u53ef\u91cd\u7528\u6280\u80fd\uff08Skills\uff09 |\n| \u9a8c\u8bc1\u5faa\u73af | \u68c0\u67e5\u70b9 vs \u6301\u7eed\u8bc4\u4f30\u3001\u8bc4\u5206\u5668\u7c7b\u578b\u3001pass@k \u6307\u6807 |\n| \u5e76\u884c\u5904\u7406 | Git worktrees\u3001\u4e32\u8054\u65b9\u6cd5\u3001\u4f55\u65f6\u6269\u5c55\u5b9e\u4f8b |\n| \u5b50\u667a\u80fd\u4f53\u534f\u8c03 | \u4e0a\u4e0b\u6587\u95ee\u9898\u3001\u6e10\u8fdb\u5f0f\u68c0\u7d22\u6a21\u5f0f |\n\n---\n\n## \u8de8\u5e73\u53f0\u652f\u6301\n\n\u6b64\u63d2\u4ef6\u73b0\u5df2\u5b8c\u6574\u652f\u6301 **Windows\u3001macOS \u548c Linux**\u3002\u6240\u6709\u94a9\u5b50\u548c\u811a\u672c\u5df2\u4f7f\u7528 Node.js \u91cd\u5199\u4ee5\u83b7\u5f97\u6700\u4f73\u517c\u5bb9\u6027\u3002\n\n### \u5305\u7ba1\u7406\u5668\u68c0\u6d4b\n\n\u63d2\u4ef6\u4f1a\u81ea\u52a8\u68c0\u6d4b\u60a8\u504f\u597d\u7684\u5305\u7ba1\u7406\u5668\uff08npm\u3001pnpm\u3001yarn \u6216 bun\uff09\uff0c\u4f18\u5148\u7ea7\u5982\u4e0b\uff1a\n\n1. **\u73af\u5883\u53d8\u91cf**\uff1a`CLAUDE_PACKAGE_MANAGER`\n2. **\u9879\u76ee\u914d\u7f6e**\uff1a`.claude/package-manager.json`\n3. **package.json**\uff1a`packageManager` \u5b57\u6bb5\n4. **\u9501\u6587\u4ef6**\uff1a\u4ece package-lock.json\u3001yarn.lock\u3001pnpm-lock.yaml \u6216 bun.lockb \u68c0\u6d4b\n5. **\u5168\u5c40\u914d\u7f6e**\uff1a`~/.claude/package-manager.json`\n6. **\u5907\u9009\u65b9\u6848**\uff1a\u7b2c\u4e00\u4e2a\u53ef\u7528\u7684\u5305\u7ba1\u7406\u5668\n\n\u8bbe\u7f6e\u60a8\u504f\u597d\u7684\u5305\u7ba1\u7406\u5668\uff1a\n\n```bash\n# \u901a\u8fc7\u73af\u5883\u53d8\u91cf\nexport CLAUDE_PACKAGE_MANAGER=pnpm\n\n# \u901a\u8fc7\u5168\u5c40\u914d\u7f6e\nnode scripts/setup-package-manager.js --global pnpm\n\n# \u901a\u8fc7\u9879\u76ee\u914d\u7f6e\nnode scripts/setup-package-manager.js --project bun\n\n# \u68c0\u6d4b\u5f53\u524d\u914d\u7f6e\nnode scripts/setup-package-manager.js --detect\n```\n\n\u6216\u5728 Claude Code \u4e2d\u4f7f\u7528 `/setup-pm` \u6307\u4ee4\u3002\n\n---\n\n## \u5185\u5bb9\u6982\u89c8\n\n\u672c\u4ed3\u5e93\u662f\u4e00\u4e2a **Claude Code \u63d2\u4ef6** - \u53ef\u76f4\u63a5\u5b89\u88c5\u6216\u624b\u52a8\u590d\u5236\u7ec4\u4ef6\u3002\n\n```\neverything-claude-code/\n|-- .claude-plugin/   # \u63d2\u4ef6\u548c\u5e02\u573a\u6e05\u5355\n|   |-- plugin.json         # \u63d2\u4ef6\u5143\u6570\u636e\u548c\u7ec4\u4ef6\u8def\u5f84\n|   |-- marketplace.json    # \u7528\u4e8e /plugin marketplace add \u7684\u5e02\u573a\u76ee\u5f55\n|\n|-- agents/           # \u7528\u4e8e\u59d4\u6d3e\u4efb\u52a1\u7684\u4e13\u95e8\u5b50\u667a\u80fd\u4f53\uff08Agents\uff09\n|   |-- planner.md           # \u529f\u80fd\u5b9e\u73b0\u89c4\u5212\n|   |-- architect.md         # \u7cfb\u7edf\u8bbe\u8ba1\u51b3\u7b56\n|   |-- tdd-guide.md         # \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\n|   |-- code-reviewer.md     # \u8d28\u91cf\u4e0e\u5b89\u5168\u5ba1\u67e5\n|   |-- security-reviewer.md # \u6f0f\u6d1e\u5206\u6790\n|   |-- build-error-resolver.md\n|   |-- e2e-runner.md        # Playwright E2E \u6d4b\u8bd5\n|   |-- refactor-cleaner.md  # \u65e0\u7528\u4ee3\u7801\u6e05\u7406\n|   |-- doc-updater.md       # \u6587\u6863\u540c\u6b65\n|   |-- go-reviewer.md       # Go \u4ee3\u7801\u5ba1\u67e5\uff08\u65b0\u589e\uff09\n|   |-- go-build-resolver.md # Go \u6784\u5efa\u9519\u8bef\u89e3\u51b3\uff08\u65b0\u589e\uff09\n|\n|-- skills/           # \u5de5\u4f5c\u6d41\uff08Workflow\uff09\u5b9a\u4e49\u548c\u9886\u57df\u77e5\u8bc6\n|   |-- coding-standards/           # \u7f16\u7a0b\u8bed\u8a00\u6700\u4f73\u5b9e\u8df5\n|   |-- backend-patterns/           # API\u3001\u6570\u636e\u5e93\u3001\u7f13\u5b58\u6a21\u5f0f\n|   |-- frontend-patterns/          # React\u3001Next.js \u6a21\u5f0f\n|   |-- continuous-learning/        # \u4ece\u4f1a\u8bdd\u4e2d\u81ea\u52a8\u63d0\u53d6\u6a21\u5f0f\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- continuous-learning-v2/     # \u57fa\u4e8e\u672c\u80fd\u7684\u5b66\u4e60\u4e0e\u4fe1\u5fc3\u8bc4\u5206\n|   |-- iterative-retrieval/        # \u5b50\u4ee3\u7406\u7684\u6e10\u8fdb\u5f0f\u4e0a\u4e0b\u6587\u7cbe\u70bc\n|   |-- strategic-compact/          # \u624b\u52a8\u538b\u7f29\u5efa\u8bae\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- tdd-workflow/               # TDD \u65b9\u6cd5\u8bba\n|   |-- security-review/            # \u5b89\u5168\u6027\u68c0\u67e5\u6e05\u5355\n|   |-- eval-harness/               # \u9a8c\u8bc1\u5faa\u73af\u8bc4\u4f30\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- verification-loop/          # \u6301\u7eed\u9a8c\u8bc1\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- golang-patterns/            # Go \u60ef\u7528\u6cd5\u548c\u6700\u4f73\u5b9e\u8df5\uff08\u65b0\u589e\uff09\n|   |-- golang-testing/             # Go \u6d4b\u8bd5\u6a21\u5f0f\u3001TDD\u3001\u57fa\u51c6\u6d4b\u8bd5\uff08\u65b0\u589e\uff09\n|\n|-- commands/         # \u5feb\u901f\u6267\u884c\u7684\u659c\u6760\u6307\u4ee4\uff08Commands\uff09\n|   |-- tdd.md              # /tdd - \u6d4b\u8bd5\u9a71\u52a8\u5f00\u53d1\n|   |-- plan.md             # /plan - \u5b9e\u73b0\u89c4\u5212\n|   |-- e2e.md              # /e2e - E2E \u6d4b\u8bd5\u751f\u6210\n|   |-- code-review.md      # /code-review - \u8d28\u91cf\u5ba1\u67e5\n|   |-- build-fix.md        # /build-fix - \u4fee\u590d\u6784\u5efa\u9519\u8bef\n|   |-- refactor-clean.md   # /refactor-clean - \u79fb\u9664\u65e0\u7528\u4ee3\u7801\n|   |-- learn.md            # /learn - \u4f1a\u8bdd\u4e2d\u63d0\u53d6\u6a21\u5f0f\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- checkpoint.md       # /checkpoint - \u4fdd\u5b58\u9a8c\u8bc1\u72b6\u6001\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- verify.md           # /verify - \u6267\u884c\u9a8c\u8bc1\u5faa\u73af\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- setup-pm.md         # /setup-pm - \u8bbe\u7f6e\u5305\u7ba1\u7406\u5668\n|   |-- go-review.md        # /go-review - Go \u4ee3\u7801\u5ba1\u67e5\uff08\u65b0\u589e\uff09\n|   |-- go-test.md          # /go-test - Go TDD \u5de5\u4f5c\u6d41\uff08\u65b0\u589e\uff09\n|   |-- go-build.md         # /go-build - \u4fee\u590d Go \u6784\u5efa\u9519\u8bef\uff08\u65b0\u589e\uff09\n|\n|-- rules/            # \u5fc5\u987b\u9075\u5b88\u7684\u51c6\u5219\uff08Rules\uff09\uff08\u590d\u5236\u5230 ~/.claude/rules/\uff09\n|   |-- security.md         # \u5f3a\u5236\u6027\u5b89\u5168\u68c0\u67e5\n|   |-- coding-style.md     # \u4e0d\u53d8\u6027\u3001\u6587\u4ef6\u7ec4\u7ec7\n|   |-- testing.md          # TDD\u300180% \u8986\u76d6\u7387\u8981\u6c42\n|   |-- git-workflow.md     # \u63d0\u4ea4\u683c\u5f0f\u3001PR \u6d41\u7a0b\n|   |-- agents.md           # \u4f55\u65f6\u59d4\u6d3e\u7ed9\u5b50\u667a\u80fd\u4f53\n|   |-- performance.md      # \u6a21\u578b\u9009\u62e9\u3001\u4e0a\u4e0b\u6587\u7ba1\u7406\n|\n|-- hooks/            # \u57fa\u4e8e\u89e6\u53d1\u5668\u7684\u81ea\u52a8\u5316\u94a9\u5b50\uff08Hooks\uff09\n|   |-- hooks.json                # \u6240\u6709\u94a9\u5b50\u914d\u7f6e\uff08PreToolUse\u3001PostToolUse\u3001Stop \u7b49\uff09\n|   |-- memory-persistence/       # \u4f1a\u8bdd\u751f\u547d\u5468\u671f\u94a9\u5b50\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- strategic-compact/        # \u538b\u7f29\u5efa\u8bae\uff08\u5b8c\u6574\u6307\u5357\uff09\n|\n|-- scripts/          # \u8de8\u5e73\u53f0 Node.js \u811a\u672c\uff08\u65b0\u589e\uff09\n|   |-- lib/                     # \u5171\u4eab\u5de5\u5177\n|   |   |-- utils.js             # \u8de8\u5e73\u53f0\u6587\u4ef6/\u8def\u5f84/\u7cfb\u7edf\u5de5\u5177\n|   |   |-- package-manager.js   # \u5305\u7ba1\u7406\u5668\u68c0\u6d4b\u4e0e\u9009\u62e9\n|   |-- hooks/                   # \u94a9\u5b50\u5b9e\u73b0\n|   |   |-- session-start.js     # \u4f1a\u8bdd\u5f00\u59cb\u65f6\u52a0\u8f7d\u4e0a\u4e0b\u6587\n|   |   |-- session-end.js       # \u4f1a\u8bdd\u7ed3\u675f\u65f6\u4fdd\u5b58\u72b6\u6001\n|   |   |-- pre-compact.js       # \u538b\u7f29\u524d\u72b6\u6001\u4fdd\u5b58\n|   |   |-- suggest-compact.js   # \u7b56\u7565\u6027\u538b\u7f29\u5efa\u8bae\n|   |   |-- evaluate-session.js  # \u4ece\u4f1a\u8bdd\u4e2d\u63d0\u53d6\u6a21\u5f0f\n|   |-- setup-package-manager.js # \u4ea4\u4e92\u5f0f\u5305\u7ba1\u7406\u5668\u8bbe\u7f6e\n|\n|-- tests/            # \u6d4b\u8bd5\u5957\u4ef6\uff08\u65b0\u589e\uff09\n|   |-- lib/                     # \u5e93\u6d4b\u8bd5\n|   |-- hooks/                   # \u94a9\u5b50\u6d4b\u8bd5\n|   |-- run-all.js               # \u6267\u884c\u6240\u6709\u6d4b\u8bd5\n|\n|-- contexts/         # \u52a8\u6001\u7cfb\u7edf\u63d0\u793a\u8bcd\uff08Prompt\uff09\u6ce8\u5165\u4e0a\u4e0b\u6587\uff08\u5b8c\u6574\u6307\u5357\uff09\n|   |-- dev.md              # \u5f00\u53d1\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|   |-- review.md           # \u4ee3\u7801\u5ba1\u67e5\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|   |-- research.md         # \u7814\u7a76/\u63a2\u7d22\u6a21\u5f0f\u4e0a\u4e0b\u6587\n|\n|-- examples/         # \u793a\u4f8b\u914d\u7f6e\u548c\u4f1a\u8bdd\n|   |-- CLAUDE.md           # \u9879\u76ee\u7ea7\u914d\u7f6e\u793a\u4f8b\n|   |-- user-CLAUDE.md      # \u7528\u6237\u7ea7\u914d\u7f6e\u793a\u4f8b\n|\n|-- mcp-configs/      # MCP \u670d\u52a1\u5668\u914d\u7f6e\n|   |-- mcp-servers.json    # GitHub\u3001Supabase\u3001Vercel\u3001Railway \u7b49\n|\n|-- marketplace.json  # \u81ea\u6258\u7ba1\u5e02\u573a\u914d\u7f6e\uff08\u7528\u4e8e /plugin marketplace add\uff09\n```\n\n---\n\n## \u751f\u6001\u7cfb\u7edf\u5de5\u5177\n\n### ecc.tools - \u6280\u80fd\u751f\u6210\u5668\n\n\u4ece\u60a8\u7684\u4ed3\u5e93\u81ea\u52a8\u751f\u6210 Claude Code \u6280\u80fd\uff08Skills\uff09\u3002\n\n[\u5b89\u88c5 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)\n\n\u5206\u6790\u60a8\u7684\u4ed3\u5e93\u5e76\u521b\u5efa\uff1a\n- **SKILL.md \u6587\u4ef6** - \u53ef\u76f4\u63a5\u7528\u4e8e Claude Code \u7684\u6280\u80fd\n- **\u672c\u80fd\u96c6\u5408** - \u7528\u4e8e continuous-learning-v2\n- **\u6a21\u5f0f\u63d0\u53d6** - \u4ece\u60a8\u7684\u63d0\u4ea4\u5386\u53f2\u5b66\u4e60\n\n```bash\n# \u5b89\u88c5 GitHub App \u540e\uff0c\u6280\u80fd\u4f1a\u51fa\u73b0\u5728\uff1a\n~/.claude/skills/generated/\n```\n\n\u4e0e `continuous-learning-v2` \u6280\u80fd\u65e0\u7f1d\u6574\u5408\u4ee5\u7ee7\u627f\u672c\u80fd\u3002\n\n---\n\n## \u5b89\u88c5\n\n### \u9009\u9879 1\uff1a\u4ee5\u63d2\u4ef6\uff08Plugin\uff09\u5b89\u88c5\uff08\u63a8\u8350\uff09\n\n\u4f7f\u7528\u672c\u4ed3\u5e93\u6700\u7b80\u5355\u7684\u65b9\u5f0f - \u5b89\u88c5\u4e3a Claude Code \u63d2\u4ef6\uff1a\n\n```bash\n# \u5c06\u6b64\u4ed3\u5e93\u6dfb\u52a0\u4e3a\u5e02\u573a\n/plugin marketplace add affaan-m/everything-claude-code\n\n# \u5b89\u88c5\u63d2\u4ef6\n/plugin install everything-claude-code@everything-claude-code\n```\n\n\u6216\u76f4\u63a5\u6dfb\u52a0\u5230\u60a8\u7684 `~/.claude/settings.json`\uff1a\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"everything-claude-code\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"affaan-m/everything-claude-code\"\n      }\n    }\n  },\n  \"enabledPlugins\": {\n    \"everything-claude-code@everything-claude-code\": true\n  }\n}\n```\n\n\u8fd9\u4f1a\u8ba9\u60a8\u7acb\u5373\u8bbf\u95ee\u6240\u6709\u6307\u4ee4\u3001\u667a\u80fd\u4f53\u3001\u6280\u80fd\u548c\u94a9\u5b50\u3002\n\n---\n\n### \u9009\u9879 2\uff1a\u624b\u52a8\u5b89\u88c5\n\n\u5982\u679c\u60a8\u504f\u597d\u624b\u52a8\u63a7\u5236\u5b89\u88c5\u5185\u5bb9\uff1a\n\n```bash\n# \u514b\u9686\u4ed3\u5e93\ngit clone https://github.com/affaan-m/everything-claude-code.git\n\n# \u5c06\u667a\u80fd\u4f53\u590d\u5236\u5230\u60a8\u7684 Claude \u914d\u7f6e\ncp everything-claude-code/agents/*.md ~/.claude/agents/\n\n# \u590d\u5236\u89c4\u5219\ncp everything-claude-code/rules/*.md ~/.claude/rules/\n\n# \u590d\u5236\u6307\u4ee4\ncp everything-claude-code/commands/*.md ~/.claude/commands/\n\n# \u590d\u5236\u6280\u80fd\ncp -r everything-claude-code/skills/* ~/.claude/skills/\n```\n\n#### \u5c06\u94a9\u5b50\u6dfb\u52a0\u5230 settings.json\n\n\u5c06 `hooks/hooks.json` \u4e2d\u7684\u94a9\u5b50\u590d\u5236\u5230\u60a8\u7684 `~/.claude/settings.json`\u3002\n\n#### \u914d\u7f6e MCP\n\n\u5c06 `mcp-configs/mcp-servers.json` \u4e2d\u6240\u9700\u7684 MCP \u670d\u52a1\u5668\u914d\u7f6e\u590d\u5236\u5230\u60a8\u7684 `~/.claude.json`\u3002\n\n**\u91cd\u8981\uff1a** \u5c06 `YOUR_*_HERE` \u5360\u4f4d\u7b26\u66ff\u6362\u4e3a\u60a8\u5b9e\u9645\u7684 API \u5bc6\u94a5\u3002\n\n---\n\n## \u6838\u5fc3\u6982\u5ff5\n\n### \u667a\u80fd\u4f53\uff08Agents\uff09\n\n\u5b50\u667a\u80fd\u4f53\u4ee5\u6709\u9650\u8303\u56f4\u5904\u7406\u59d4\u6d3e\u7684\u4efb\u52a1\u3002\u793a\u4f8b\uff1a\n\n```markdown\n---\nname: code-reviewer\ndescription: Reviews code for quality, security, and maintainability\ntools: [\"Read\", \"Grep\", \"Glob\", \"Bash\"]\nmodel: opus\n---\n\nYou are a senior code reviewer...\n```\n\n### \u6280\u80fd\uff08Skills\uff09\n\n\u6280\u80fd\u662f\u7531\u6307\u4ee4\u6216\u667a\u80fd\u4f53\u8c03\u7528\u7684\u5de5\u4f5c\u6d41\u5b9a\u4e49\uff1a\n\n```markdown\n# TDD Workflow\n\n1. Define interfaces first\n2. Write failing tests (RED)\n3. Implement minimal code (GREEN)\n4. Refactor (IMPROVE)\n5. Verify 80%+ coverage\n```\n\n### \u94a9\u5b50\uff08Hooks\uff09\n\n\u94a9\u5b50\u5728\u5de5\u5177\uff08Tool\uff09\u4e8b\u4ef6\u65f6\u89e6\u53d1\u3002\u793a\u4f8b - \u8b66\u544a console.log\uff1a\n\n```json\n{\n  \"matcher\": \"tool == \\\"Edit\\\" && tool_input.file_path matches \\\"\\\\.(ts|tsx|js|jsx)$\\\"\",\n  \"hooks\": [{\n    \"type\": \"command\",\n    \"command\": \"#!/bin/bash\\ngrep -n 'console\\\\.log' \\\"$file_path\\\" && echo '[Hook] Remove console.log' >&2\"\n  }]\n}\n```\n\n### \u89c4\u5219\uff08Rules\uff09\n\n\u89c4\u5219\u662f\u5fc5\u987b\u9075\u5b88\u7684\u51c6\u5219\u3002\u4fdd\u6301\u6a21\u5757\u5316\uff1a\n\n```\n~/.claude/rules/\n  security.md      # \u7981\u6b62\u786c\u7f16\u7801\u5bc6\u94a5\n  coding-style.md  # \u4e0d\u53d8\u6027\u3001\u6587\u4ef6\u7ec4\u7ec7\n  testing.md       # TDD\u300180% \u8986\u76d6\u7387\u8981\u6c42\n```\n\n---\n\n## \u6267\u884c\u6d4b\u8bd5\n\n\u63d2\u4ef6\u5305\u542b\u5b8c\u6574\u7684\u6d4b\u8bd5\u5957\u4ef6\uff1a\n\n```bash\n# \u6267\u884c\u6240\u6709\u6d4b\u8bd5\nnode tests/run-all.js\n\n# \u6267\u884c\u4e2a\u522b\u6d4b\u8bd5\u6587\u4ef6\nnode tests/lib/utils.test.js\nnode tests/lib/package-manager.test.js\nnode tests/hooks/hooks.test.js\n```\n\n---\n\n## \u8d21\u732e\n\n**\u6b22\u8fce\u5e76\u9f13\u52b1\u8d21\u732e\u3002**\n\n\u672c\u4ed3\u5e93\u65e8\u5728\u6210\u4e3a\u793e\u533a\u8d44\u6e90\u3002\u5982\u679c\u60a8\u6709\uff1a\n- \u5b9e\u7528\u7684\u667a\u80fd\u4f53\u6216\u6280\u80fd\n- \u5de7\u5999\u7684\u94a9\u5b50\n- \u66f4\u597d\u7684 MCP \u914d\u7f6e\n- \u6539\u8fdb\u7684\u89c4\u5219\n\n\u8bf7\u8d21\u732e\uff01\u8be6\u89c1 [CONTRIBUTING.md](CONTRIBUTING.md) \u7684\u6307\u5357\u3002\n\n### \u8d21\u732e\u60f3\u6cd5\n\n- \u7279\u5b9a\u8bed\u8a00\u7684\u6280\u80fd\uff08Python\u3001Rust \u6a21\u5f0f\uff09- Go \u73b0\u5df2\u5305\u542b\uff01\n- \u7279\u5b9a\u6846\u67b6\u7684\u914d\u7f6e\uff08Django\u3001Rails\u3001Laravel\uff09\n- DevOps \u667a\u80fd\u4f53\uff08Kubernetes\u3001Terraform\u3001AWS\uff09\n- \u6d4b\u8bd5\u7b56\u7565\uff08\u4e0d\u540c\u6846\u67b6\uff09\n- \u7279\u5b9a\u9886\u57df\u77e5\u8bc6\uff08ML\u3001\u6570\u636e\u5de5\u7a0b\u3001\u79fb\u52a8\u5f00\u53d1\uff09\n\n---\n\n## \u80cc\u666f\n\n\u6211\u4ece\u5b9e\u9a8c\u6027\u63a8\u51fa\u5c31\u5f00\u59cb\u4f7f\u7528 Claude Code\u30022025 \u5e74 9 \u6708\u4e0e [@DRodriguezFX](https://x.com/DRodriguezFX) \u4e00\u8d77\u4f7f\u7528 Claude Code \u6253\u9020 [zenith.chat](https://zenith.chat)\uff0c\u8d62\u5f97\u4e86 Anthropic x Forum Ventures \u9ed1\u5ba2\u677e\u3002\n\n\u8fd9\u4e9b\u914d\u7f6e\u5df2\u5728\u591a\u4e2a\u751f\u4ea7\u5e94\u7528\u7a0b\u5e8f\u4e2d\u7ecf\u8fc7\u5b9e\u6218\u6d4b\u8bd5\u3002\n\n---\n\n## \u91cd\u8981\u6ce8\u610f\u4e8b\u9879\n\n### \u4e0a\u4e0b\u6587\u7a97\u53e3\u7ba1\u7406\n\n**\u5173\u952e\uff1a** \u4e0d\u8981\u540c\u65f6\u542f\u7528\u6240\u6709 MCP\u3002\u542f\u7528\u8fc7\u591a\u5de5\u5177\u4f1a\u8ba9\u60a8\u7684 200k \u4e0a\u4e0b\u6587\u7a97\u53e3\u7f29\u51cf\u81f3 70k\u3002\n\n\u7ecf\u9a8c\u6cd5\u5219\uff1a\n- \u8bbe\u7f6e 20-30 \u4e2a MCP\n- \u6bcf\u4e2a\u9879\u76ee\u542f\u7528\u5c11\u4e8e 10 \u4e2a\n- \u542f\u7528\u7684\u5de5\u5177\u5c11\u4e8e 80 \u4e2a\n\n\u5728\u9879\u76ee\u914d\u7f6e\u4e2d\u4f7f\u7528 `disabledMcpServers` \u6765\u7981\u7528\u672a\u4f7f\u7528\u7684 MCP\u3002\n\n### \u81ea\u5b9a\u4e49\n\n\u8fd9\u4e9b\u914d\u7f6e\u9002\u5408\u6211\u7684\u5de5\u4f5c\u6d41\u3002\u60a8\u5e94\u8be5\uff1a\n1. \u4ece\u60a8\u8ba4\u540c\u7684\u90e8\u5206\u5f00\u59cb\n2. \u6839\u636e\u60a8\u7684\u6280\u672f\u6808\u4fee\u6539\n3. \u79fb\u9664\u4e0d\u9700\u8981\u7684\u90e8\u5206\n4. \u6dfb\u52a0\u60a8\u81ea\u5df1\u7684\u6a21\u5f0f\n\n---\n\n## Star \u5386\u53f2\n\n[![Star History Chart](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code&type=Date)](https://star-history.com/#affaan-m/everything-claude-code&Date)\n\n---\n\n## \u94fe\u63a5\n\n- **\u7b80\u660e\u6307\u5357\uff08\u4ece\u8fd9\u91cc\u5f00\u59cb\uff09\uff1a** [Everything Claude Code \u7b80\u660e\u6307\u5357](https://x.com/affaanmustafa/status/2012378465664745795)\n- **\u5b8c\u6574\u6307\u5357\uff08\u8fdb\u9636\uff09\uff1a** [Everything Claude Code \u5b8c\u6574\u6307\u5357](https://x.com/affaanmustafa/status/2014040193557471352)\n- **\u5173\u6ce8\uff1a** [@affaanmustafa](https://x.com/affaanmustafa)\n- **zenith.chat\uff1a** [zenith.chat](https://zenith.chat)\n\n---\n\n## \u6388\u6743\n\nMIT - \u81ea\u7531\u4f7f\u7528\u3001\u4f9d\u9700\u6c42\u4fee\u6539\u3001\u5982\u53ef\u80fd\u8bf7\u56de\u9988\u8d21\u732e\u3002\n\n---\n\n**\u5982\u679c\u6709\u5e2e\u52a9\u8bf7\u4e3a\u672c\u4ed3\u5e93\u70b9\u8d5e\uff08Star\uff09\u3002\u9605\u8bfb\u4e24\u4efd\u6307\u5357\u3002\u6253\u9020\u4f1f\u5927\u7684\u4f5c\u54c1\u3002**\n"
+  },
+  "/Users/Library/Applications/xx/code/github/everything-claude-code-zh/.claude-plugin/README.md": {
+    "md5": "8b6aa77ad9181456133d28e477db962e",
+    "content": "### \u63d2\u4ef6\u6e05\u5355\u6ce8\u610f\u4e8b\u9879\uff08Plugin Manifest Gotchas\uff09\n\n\u5982\u679c\u4f60\u8ba1\u5212\u7f16\u8f91 `.claude-plugin/plugin.json`\uff0c\u8bf7\u6ce8\u610f Claude \u63d2\u4ef6\u9a8c\u8bc1\u5668\uff08plugin validator\uff09\u5f3a\u5236\u6267\u884c\u4e86\u4e00\u4e9b**\u672a\u516c\u5f00\u4f46\u4e25\u683c\u7684\u7ea6\u675f**\uff0c\u8fd9\u4e9b\u7ea6\u675f\u53ef\u80fd\u5bfc\u81f4\u5b89\u88c5\u5931\u8d25\u5e76\u663e\u793a\u6a21\u7cca\u7684\u9519\u8bef\uff08\u4f8b\u5982\uff0c`agents: Invalid input`\uff09\u3002\u7279\u522b\u662f\uff0c\u7ec4\u4ef6\u5b57\u6bb5\u5fc5\u987b\u662f\u6570\u7ec4\uff08arrays\uff09\uff0c`agents` \u5fc5\u987b\u4f7f\u7528\u660e\u786e\u7684\u6587\u4ef6\u8def\u5f84\u800c\u975e\u76ee\u5f55\uff0c\u4e14\u4e3a\u4e86\u5b9e\u73b0\u53ef\u9760\u7684\u9a8c\u8bc1\u548c\u5b89\u88c5\uff0c\u5fc5\u987b\u5305\u542b `version` \u5b57\u6bb5\u3002\n\n\u8fd9\u4e9b\u7ea6\u675f\u5728\u516c\u5f00\u793a\u4f8b\u4e2d\u5e76\u4e0d\u660e\u663e\uff0c\u4e14\u5728\u8fc7\u53bb\u66fe\u591a\u6b21\u5bfc\u81f4\u5b89\u88c5\u5931\u8d25\u3002\u5b83\u4eec\u5728 `.claude-plugin/PLUGIN_SCHEMA_NOTES.md` \u4e2d\u6709\u8be6\u7ec6\u8bb0\u5f55\uff0c\u5728\u5bf9\u63d2\u4ef6\u6e05\u5355\uff08plugin manifest\uff09\u8fdb\u884c\u4efb\u4f55\u66f4\u6539\u4e4b\u524d\uff0c\u5e94\u4ed4\u7ec6\u9605\u8bfb\u8be5\u6587\u6863\u3002\n"
   }
 }
\ No newline at end of file