一、CLAUDE.md 配置原則

核心原則：保持簡(jiǎn)短

• 控制在 60 行以內(nèi)
• ，硬上限 300 行
• LLM 能可靠遵循約 150-200 條指令，Claude Code 系統(tǒng)提示已占用約 50 條
• 只放 Claude 可能忽略的信息
• ：構(gòu)建命令、測(cè)試命令、分支命名規(guī)范、項(xiàng)目特定架構(gòu)決策
• 能從代碼推斷的內(nèi)容不要寫進(jìn)去
• 規(guī)則太多？拆分到 .claude/rules/ 目錄下按需加載
• 關(guān)鍵規(guī)則用標(biāo)簽包裹
• 防止被忽略
• 運(yùn)行 /doctor 可檢查 CLAUDE.md 中有哪些內(nèi)容 Claude 其實(shí)能自行推導(dǎo)，把冗余指令刪掉

示例：好的 CLAUDE.md 結(jié)構(gòu)

## 工作流
-?每次代碼變更后運(yùn)行?`npm test`
-?每個(gè)任務(wù)創(chuàng)建新分支，絕不直接提交到 main
-?使用 Conventional Commits（feat:, fix:, refactor:, docs:）
-?每次提交前運(yùn)行?`eslint . --fix`
-?完成后通過?`gh pr create`?創(chuàng)建 PR
## 技術(shù)棧
-?Node.js 18+, Express 4.x, PostgreSQL 16
-?測(cè)試：Jest + React Testing Library
-?認(rèn)證：JWT + bcrypt

二、工作流最佳實(shí)踐

1. 復(fù)雜任務(wù)用 Plan Mode

• 按 Shift+Tab 兩次進(jìn)入計(jì)劃模式
• Claude 只研究和規(guī)劃，不寫代碼
• 確認(rèn)計(jì)劃后再切換回正常模式執(zhí)行
• 官方推薦流程
• ：探索 → 規(guī)劃 → 實(shí)現(xiàn) → 提交

2. 讓 Claude 先采訪你

• 給出簡(jiǎn)單需求描述，讓 Claude 用 AskUserQuestion 工具采訪你
• 它能發(fā)現(xiàn)你忽略的邊緣情況
• 采訪后開新會(huì)話執(zhí)行
• （采訪對(duì)話會(huì)污染上下文）

3. 分階段工作流

• 理解代碼庫(kù) → 修改
• 先規(guī)劃 → 再實(shí)現(xiàn)
• 生成 → 驗(yàn)證
• 不要把所有步驟壓縮到一個(gè)大提示詞里

4. 小任務(wù)別用復(fù)雜工作流

• 3-5 分鐘能完成的事，直接用原生 Claude Code
• 復(fù)雜工作流（Superpowers、Workflows 等）適用于多文件、多步驟的大任務(wù)
• 重命名變量這種小事，一句話就行

5. 善用 ! 命令的自動(dòng)響應(yīng)

• Bash 模式下執(zhí)行命令后，Claude 會(huì)自動(dòng)分析輸出并判斷是否需要行動(dòng)，不需要額外指示
• 如果你需要聚焦自己讀輸出，可以在 settings.json 中設(shè)置 "respondToBashCommands": false

6. 用大模型做大活，用小模型做小活

• 日常編碼
• 用 Sonnet 5（默認(rèn)模型，1M 上下文窗口，性價(jià)比最高）
• 復(fù)雜架構(gòu)設(shè)計(jì)
• 切 Opus 4.8（更高精度）
• 極限推理任務(wù)
• 切 Fable 5（最強(qiáng)推理能力）
• 臨時(shí)切換：/model claude-fable-5
• 備用模型配置：設(shè)置 fallbackModel 防止主模型不可用時(shí)卡住

7. 重復(fù)性監(jiān)控用 /loop

• /loop
•  讓 Claude 按固定間隔反復(fù)執(zhí)行一個(gè)任務(wù)，適用于：
  • 監(jiān)控部署狀態(tài)：/loop 5m 檢查 staging 部署是否完成
  • 等待外部依賴：/loop 30s 看看 CI 跑完了沒有
  • 定時(shí)檢查告警：/loop 10m 檢查日志中有沒有新增的 error
• /loop <間隔> <提示詞>
• ，間隔支持 5m（分鐘）、30s（秒）、1h（小時(shí)）
• /proactive
•  是 /loop 的別名，兩者功能相同
• 按 Esc 取消等待中的下一次喚醒
• 注意
• ：/loop 在遠(yuǎn)程會(huì)話中不會(huì)被持續(xù)喚醒，遠(yuǎn)程環(huán)境建議用替代方案

8. 輸出復(fù)雜結(jié)果用 Artifacts 發(fā)布頁(yè)面

• 依賴 project-artifact 插件
• 當(dāng)終端文字不夠直觀時(shí)，讓 Claude 發(fā)布一個(gè)交互頁(yè)面（Artifact），發(fā)布到 claude.ai 的私有鏈接
• 適用場(chǎng)景：
• PR 走查
  • ：讓 Claude 把 diff 逐行標(biāo)注發(fā)布為可交互頁(yè)面，比看終端輸出直觀得多
• 數(shù)據(jù)儀表盤
  • ：從會(huì)話數(shù)據(jù)生成圖表、儀表盤發(fā)布為網(wǎng)頁(yè)
• 文檔輸出
  • ：復(fù)雜的技術(shù)文檔直接渲染為 HTML 頁(yè)面
• 用法：做一個(gè) artifact，用 diff 逐行標(biāo)注的方式走查這個(gè) PR
  • Claude 會(huì)先創(chuàng)建內(nèi)容，然后請(qǐng)求你批準(zhǔn)發(fā)布
  • Artifact 會(huì)隨著會(huì)話更新實(shí)時(shí)刷新，不需要重復(fù)發(fā)布
• 注意
  • ：Artifacts 目前在 Team 和 Enterprise 計(jì)劃上 beta 可用

三、調(diào)試與糾錯(cuò)

1. 粘貼 bug，說"fix"

• 把錯(cuò)誤信息粘貼給 Claude，說一個(gè)字：“fix”
• 不要指導(dǎo)怎么修
• ，不要猜測(cè)原因，不要指定解決方案
• Claude 的調(diào)試能力比想象中強(qiáng)，管得越多越容易帶偏
• 直接讓 Claude 修的成功率 80%+

2. 兩次失敗 = /clear

• 同一個(gè)問題修正超過兩次，/clear 重新開始
• 上下文污染會(huì)降低性能
• 官方建議：修正超過兩次就重啟
• 如果清空后又想找回歷史，可以用 /rewind 回退到 /clear 之前的對(duì)話

3. 走偏了？Esc Esc 回滾

• 按兩次 Esc（或 /rewind）直接回滾到上一個(gè)檢查點(diǎn)
• 在同一上下文中糾正偏差往往更糟
• 同一個(gè)問題偏差兩次？/clear 重啟

4. 要求重寫平庸方案

• 當(dāng) Claude 給出能工作但不優(yōu)雅的解決方案時(shí)，不要修補(bǔ)
• 說：“知道你現(xiàn)在知道的一切，拋棄這個(gè)，實(shí)現(xiàn)優(yōu)雅的解決方案”
• 重寫版本通常比修補(bǔ)版本好得多

5. 用 /doctor 做定期健康檢查

• 每隔一段時(shí)間運(yùn)行 /doctor，它會(huì)檢查：安裝健康度、未使用的 Skills/MCP/插件、重復(fù)的 CLAUDE.md、慢速 Hooks
• 把不用的東西清掉，既省上下文也省 token

6. 配置出問題時(shí)用 --safe-mode

• 如果懷疑自定義配置（CLAUDE.md、插件、Hooks 等）導(dǎo)致 Claude 行為異常，用 --safe-mode 啟動(dòng)
• 所有自定義配置被禁用，能快速定位問題源

四、上下文管理

1. 50% 時(shí)手動(dòng)壓縮

• 上下文使用超過 60-70% 時(shí)，性能明顯下降
• 在 50% 時(shí)手動(dòng)執(zhí)行 /compact
  • ，不要等自動(dòng)壓縮
• 用 /statusline 實(shí)時(shí)監(jiān)控使用情況
• 或使用 /clear 開新會(huì)話
• Sonnet 5 擁有 100 萬(wàn) token 窗口，長(zhǎng)上下文會(huì)話更需要主動(dòng)管理，不要等到快滿了才壓縮

2. /compact 可指定壓縮策略

# 聚焦 API 變更壓縮
/compact focusing on API changes
# 保留測(cè)試相關(guān)歷史
/compact keep test-related?history
# 保留錯(cuò)誤解決歷史
/compact keep error resolution

3. 切換目錄用 /cd 不要用 /clear

• 需要切到項(xiàng)目另一個(gè)子目錄繼續(xù)工作時(shí)，用 /cd <新路徑>
• 不會(huì)破壞提示緩存，上下文窗口不受影響
• 比 /clear + 重新啟動(dòng)效率高得多

4. Checkpoints（檢查點(diǎn)）

• 每次 Claude 操作自動(dòng)創(chuàng)建
• 可獨(dú)立回滾對(duì)話或代碼
• 跨會(huì)話持久化
• 不是 git 的替代品

五、Subagents（子智能體）

1. 什么時(shí)候該用子智能體

• 當(dāng)任務(wù)可以自然拆分為多個(gè)獨(dú)立單元時(shí)，在提示詞中加 “use subagents”
• 典型場(chǎng)景：代碼審查、大規(guī)模重構(gòu)、多模塊并行開發(fā)
• 子智能體有獨(dú)立的上下文窗口，研究、驗(yàn)證、審查隔離進(jìn)行，防止污染和偏見

2. 專用子智能體 > 通用 mega-agent

• 創(chuàng)建功能特定的子智能體（如"前端組件智能體"），而不是通用的（如"QA 智能體"）
• 功能越具體，上下文越精準(zhǔn)，效果越好
• 子智能體可嵌套最多 5 層，復(fù)雜任務(wù)可以逐層抽象，但日常使用 1-2 層就夠了

3. 后臺(tái)子智能體可以在重啟后自動(dòng)恢復(fù)

• 長(zhǎng)時(shí)間運(yùn)行的任務(wù)放到后臺(tái)執(zhí)行（/bg 或 ←←）
• daemon 升級(jí)或重啟后，后臺(tái)子智能體會(huì)自動(dòng)恢復(fù)，不再丟失進(jìn)度
• 通過 claude agents 列表查看和管理所有運(yùn)行中的會(huì)話

4. 子智能體有獨(dú)立上下文窗口

• 研究、驗(yàn)證、審查隔離在獨(dú)立上下文中
• 防止污染和偏見
• 不污染主上下文

5. 典型用法

# 讓 Claude 自動(dòng)拆分任務(wù)并行處理
> 審查用戶認(rèn)證模塊，use subagents
# 跨文件批量修改
> 重命名所有文件中的 User 為 Account，use subagents

六、Skills（技能）管理

1. 技能應(yīng)該是文件夾結(jié)構(gòu)

skills/
? api-design/
? ? SKILL.md ? ? ? ? ?# 主文件：核心規(guī)則和索引
? ? references/ ? ? ? # 語(yǔ)料庫(kù)、參考資料
? ? scripts/ ? ? ? ? ?# 輔助腳本
? ? examples/ ? ? ? ? # 示例代碼

• 主文件只包含核心規(guī)則和索引
• 語(yǔ)料庫(kù)、檢查表放在 references/
• 漸進(jìn)式披露
• ：Claude 只在需要時(shí)讀取子目錄內(nèi)容

2. 嵌套 Skills 自動(dòng)按路徑加載

• 把技能放在 .claude/skills/ 的子目錄中，在該目錄下工作時(shí)會(huì)自動(dòng)加載
• 名稱沖突時(shí)顯示為 <目錄名>:<技能名>，兩者都可訪問
• 最佳實(shí)踐：按模塊/領(lǐng)域組織技能目錄，不用把所有技能塞在一個(gè)平鋪目錄里

3. 堆疊調(diào)用多個(gè)技能

• 一行調(diào)用多個(gè)技能：/skill-a /skill-b do XYZ（最多 5 個(gè)）
• 適合組合多種專業(yè)技能的復(fù)雜任務(wù)，不用分多次對(duì)話

4. 添加 Gotchas（坑點(diǎn)記錄）部分

這是長(zhǎng)期最有價(jià)值的技術(shù)：每次 Claude 犯錯(cuò)時(shí)記錄失敗模式，長(zhǎng)期積累成為信噪比最高的內(nèi)容。

Gotchas 結(jié)構(gòu)示例

# SKILL.md
## Gotchas（坑點(diǎn)記錄）
### 2026-04-15: API 分頁(yè)參數(shù)遺漏
-?**問題**：生成 API 時(shí)忘記添加分頁(yè)參數(shù)
-?**表現(xiàn)**：返回所有數(shù)據(jù)導(dǎo)致性能問題
-?**修復(fù)**：在 SKILL.md 中添加分頁(yè)規(guī)則
-?**預(yù)防**：檢查清單中增加"是否包含分頁(yè)"

Gotchas 維護(hù)原則

• 每次犯錯(cuò)必記錄
• ：不要等，立即記錄
• 包含四個(gè)要素
• ：?jiǎn)栴}描述、表現(xiàn)形式、修復(fù)方法、預(yù)防措施
• 定期回顧
• ：每周回顧一次，識(shí)別重復(fù)出現(xiàn)的模式
• 轉(zhuǎn)化為規(guī)則
• ：如果某個(gè)坑點(diǎn)出現(xiàn) 3 次以上，轉(zhuǎn)化為正式規(guī)則
• 歸檔已解決的
• ：超過 30 天未出現(xiàn)的問題，移到歸檔區(qū)

七、Superpowers 使用詳解

1. 什么是 Superpowers？

Superpowers 是由 Jesse Vincent 和 Prime Radiant 團(tuán)隊(duì)開發(fā)的 Claude Code 插件，解決工程紀(jì)律問題。

核心功能：

• 強(qiáng)制結(jié)構(gòu)化工作流：頭腦風(fēng)暴 → 分支隔離 → 詳細(xì)計(jì)劃 → 執(zhí)行
• TDD（測(cè)試驅(qū)動(dòng)開發(fā)）
• 代碼審查
• 系統(tǒng)調(diào)試
• 驗(yàn)證完成

2. 安裝與配置

# 在 Claude Code 會(huì)話中安裝
/plugin install superpowers@claude-plugins-official
# 下次啟動(dòng)時(shí)看到"You have Superpowers"即表示成功

3. 技能激活方式

## Superpowers 工作流規(guī)則
### 新功能開發(fā)
-?使用 /opsx:propose 開始（路由到 OpenSpec）
-?跳過 brainstorming/writing-plans（避免重復(fù)）
### 編碼紀(jì)律
-?使用 /opsx:apply 時(shí)，始終遵循 TDD：先寫失敗的測(cè)試，再實(shí)現(xiàn)代碼
-?遇到 bug 時(shí)，使用 systematic-debugging 技能
-?完成主要實(shí)現(xiàn)后，自動(dòng)觸發(fā) code-reviewer
### 驗(yàn)證規(guī)則
-?聲稱工作完成前，必須通過 verification-before-completion
-?所有測(cè)試必須通過，無(wú)跳過測(cè)試

5. 四步強(qiáng)制序列

• 頭腦風(fēng)暴
• ：解決重大架構(gòu)決策（比寫代碼便宜）
• 分支隔離
• ：每個(gè)功能在獨(dú)立分支上開發(fā)
• 詳細(xì)計(jì)劃
• ：編寫可審查的計(jì)劃文檔
• 執(zhí)行
• ：按計(jì)劃實(shí)施，每步都有檢查點(diǎn)

6. 管理已安裝的插件

• /plugin list
•  查看所有插件，用 --enabled/--disabled 過濾
• 長(zhǎng)時(shí)間未用的插件會(huì)被提示清理，節(jié)省上下文
• 插件鉤子的標(biāo)識(shí)符匹配規(guī)則：含連字符的鉤子名（如 code-reviewer）現(xiàn)在精確匹配，不會(huì)誤觸

八、Spec Kit（OpenSpec）使用詳解

1. 什么是 OpenSpec？

OpenSpec 是 Fission AI 開發(fā)的開源框架，解決需求不匹配問題。將一句話需求擴(kuò)展為四個(gè)結(jié)構(gòu)化文檔。

核心功能：

• proposal.md：為什么、范圍、不在范圍內(nèi)什么（防止 AI 添加未請(qǐng)求的功能）
• specs/：使用 GIVEN/WHEN/THEN 場(chǎng)景的行為規(guī)范
• design.md：技術(shù)決策及推理
• tasks.md：實(shí)現(xiàn)清單，每個(gè)任務(wù) 2-5 分鐘可完成

2. 安裝與配置

# 需要 Node.js 20.19.0+
npm install -g @fission-ai/openspec@latest
cd?your-project
openspec init ?# 選擇 Claude Code
# 創(chuàng)建 openspec/ 目錄，包含 specs/、changes/archive/、AGENTS.md

3. 與 Claude Code 集成

// .claude/settings.json
{
??"mcpServers":?{
? ??"openspec":?{
? ? ??"command":?"npx",
? ? ??"args":?["-y",?"@fission-ai/openspec-mcp"]
? ??}
??},
??"permissions":?{
? ??"allow":?["Bash:openspec:*",?"Bash:npm:*",?"Bash:git:*"]
??}
}

4. 工作流程

# 會(huì)話 1：需求 → 規(guī)范
> /opsx:propose 用戶認(rèn)證 API，Express + MongoDB + JWT
# 生成：
# - openspec/changes/YYYY-MM-DD--proposal.md
# - openspec/changes/YYYY-MM-DD--specs/
# - openspec/changes/YYYY-MM-DD--design.md
# - openspec/changes/YYYY-MM-DD--tasks.md
# 會(huì)話 2：規(guī)范 → 實(shí)現(xiàn)
> /opsx:apply
# 會(huì)話 3：獨(dú)立驗(yàn)證
> /opsx:archive ?# 歸檔當(dāng)前迭代

5. Delta/Archive 機(jī)制

• Delta
• ：每次迭代保留決策歷史
• Archive
• ：歸檔已完成的迭代，保留審計(jì)追蹤
• 解決設(shè)計(jì)決策在迭代中丟失的問題

6. 五大常見陷阱

九、權(quán)限與安全

1. Hooks vs CLAUDE.md

2. Allowlist 減少審批疲勞

{
??"permissions":?{
? ??"allow":?[
? ? ??"Bash(npm run lint:*)",
? ? ??"Bash(npm run test:*)",
? ? ??"Bash(git status)",
? ? ??"Read",
? ? ??"Glob",
? ? ??"Grep"
? ??]
??}
}

3. deny 比 Hooks 更安全

{
??"permissions":?{
? ??"deny":?[
? ? ??"Read(./.env)",
? ? ??"Read(./.env.*)",
? ? ??"Read(./secrets/**)",
? ? ??"Bash(curl:*)"
? ??]
??}
}

• 權(quán)限評(píng)估順序：deny → ask → allow
• 設(shè)為 deny 后文件對(duì) Claude"不可見"

4. 權(quán)限規(guī)則進(jìn)階用法

• 參數(shù)化匹配
• ：Agent(model:opus) 可精確禁止 Opus 子智能體
• Glob 模式
• ："*" 在 deny 規(guī)則中匹配所有工具
• 安全強(qiáng)化
• ：破壞性 git 命令（git reset --hard、git checkout -- . 等）自動(dòng)模式已默認(rèn)阻止，除非你明確要求
• rm -rf
•  在自動(dòng)模式下也需要確認(rèn)

5. --dangerously-skip-permissions 正確使用

重要：應(yīng)在無(wú)互聯(lián)網(wǎng)的隔離環(huán)境中使用。企業(yè)可設(shè)置 disableBypassPermissionsMode: true 全局禁用。

十、規(guī)格與實(shí)現(xiàn)分離

推薦流程

• Session 1
• ：通過采訪創(chuàng)建規(guī)格
• Session 2
• ：基于規(guī)格實(shí)現(xiàn)
• Session 3
• ：獨(dú)立驗(yàn)證

為什么分離？

• 采訪和規(guī)格討論污染上下文
• 新會(huì)話有干凈的上下文窗口
• 規(guī)格文檔作為實(shí)現(xiàn)依據(jù)
• 驗(yàn)證會(huì)話獨(dú)立于實(shí)現(xiàn)偏見

十一、Claude Code 常見陷阱（Gotchas）

8 大陷阱

陷阱 1：過早放棄

表現(xiàn)：

我已實(shí)現(xiàn)大部分功能。功能在 XX 情況下工作正常。
但 YY 情況下不工作。代碼已充分測(cè)試，這是好的開始。

緩解：

• 拆分任務(wù)為更小、更隔離的單元
• 即使人類認(rèn)為可以分組，Claude Code 也需要分離
• 示例：兩個(gè)相似表 → 分兩個(gè) PR，每個(gè) 10 分鐘完成

陷阱 2：上下文壓縮后變笨

表現(xiàn)：

• 不知道之前看的文件
• 重復(fù)之前糾正的錯(cuò)誤
• 性能明顯下降

緩解：

• 50% 時(shí)手動(dòng) /compact
• 指定壓縮策略（保留什么）
• 必要時(shí) /clear + git reset --hard
• 如果已經(jīng) /clear 了又想找回之前的對(duì)話，用 /rewind

陷阱 3 & 4：測(cè)試問題

表現(xiàn)：

• 生成看起來對(duì)但失敗的測(cè)試
• 修改測(cè)試匹配錯(cuò)誤代碼
• 降低測(cè)試標(biāo)準(zhǔn)

緩解：

• TDD 模式：先寫測(cè)試
• 仔細(xì)審查生成的測(cè)試
• 嚴(yán)格審查測(cè)試變更（比代碼變更更嚴(yán)格）

陷阱 5：忘記編譯

表現(xiàn)：

• 測(cè)試循環(huán)失敗因?yàn)槲淳幾g
• 依賴變更后忘記重新編譯

緩解：

• CLAUDE.md 中明確編譯步驟
• 測(cè)試前強(qiáng)制編譯
• 注意：編譯語(yǔ)言 vs 解釋語(yǔ)言混合時(shí)特別容易出錯(cuò)

陷阱 6 & 7：工作目錄和 Git

表現(xiàn)：

• 留下測(cè)試腳本、數(shù)據(jù)庫(kù)文件
• Git 操作錯(cuò)誤導(dǎo)致 PR 混亂

緩解：

• 每次完成后 git status 檢查
• 人工執(zhí)行 Git 操作
• （分支、提交、推送）
• Claude Code 只修改文件，不操作 Git

陷阱 8：重寫但不刪除

表現(xiàn)：

• 創(chuàng)建新文件但不刪除舊文件
• 新舊代碼共存導(dǎo)致混淆

緩解：

• 審查 diff 確認(rèn)刪除
• 明確指示"刪除舊實(shí)現(xiàn)"
• 檢查文件列表確認(rèn)清理

新陷阱：后臺(tái)會(huì)話意外中斷

表現(xiàn)：

• 后臺(tái)會(huì)話在 daemon 重啟后消失
• 狀態(tài)顯示異常（一直"Working"或空白）

緩解：

• 更新到最新版本，后臺(tái)會(huì)話已支持自動(dòng)恢復(fù)
• 如果后臺(tái)卡住，在 claude agents 中檢查狀態(tài)
• 通過 claude agents 的過濾功能按狀態(tài)定位問題會(huì)話

十二、工具組合策略

Claude Code + OpenSpec + Superpowers 三重棧

解決三個(gè)核心問題：

分工明確

OpenSpec 負(fù)責(zé)：思考 WHAT（構(gòu)建什么、為什么）
Superpowers 負(fù)責(zé)：確保 HOW（如何構(gòu)建好）
Claude Code 負(fù)責(zé)：執(zhí)行（編輯文件、運(yùn)行測(cè)試、處理 Git）

配置協(xié)作

# CLAUDE.md 中的路由規(guī)則
## 規(guī)劃階段
-?任何新功能：從 /opsx:propose 開始
-?跳過 brainstorming/writing-plans（避免重復(fù)）
## 編碼階段
-?使用 /opsx:apply 時(shí)：始終遵循 TDD
-?遇到 bug：使用 systematic-debugging
-?完成實(shí)現(xiàn)：觸發(fā) code-reviewer
-?聲稱完成：通過 verification-before-completion

十三、核心原則總結(jié)

上下文是寶貴資源

• 保持簡(jiǎn)潔、及時(shí)壓縮、污染就重置
• 50% 時(shí)手動(dòng) /compact
• 兩次失敗 = /clear
• /cd
•  切目錄不破壞緩存
• /rewind
•  可找回 /clear 之前的對(duì)話

系統(tǒng)約束 > 提示詞約束

• 用 Hooks 和權(quán)限配置代替"希望 Claude 記住"
• deny
•  比 Hooks 更安全
• 關(guān)鍵規(guī)則用標(biāo)簽包裹
• 定期運(yùn)行 /doctor 清理冗余

分而治之

• 子智能體、分階段工作流、規(guī)格與實(shí)現(xiàn)分離
• 專用子智能體 > 通用 mega-agent
• Skills 按目錄組織、可嵌套加載和堆疊調(diào)用

不要過度工程

• 3-5 分鐘能完成的事，直接用原生 Claude Code
• 復(fù)雜工作流適用于多文件、多步驟的大任務(wù)
• 重命名變量這種小事，一句話就行

持續(xù)改進(jìn)

• 每次犯錯(cuò)必記錄 Gotchas
• 定期回顧，識(shí)別重復(fù)模式
• 將高頻問題轉(zhuǎn)化為正式規(guī)則
• 用 /doctor 定期清理不用的插件和配置

參考資料

• Claude Code 官方文檔：https://code.claude.com/docs/en
• Claude Code 發(fā)布日志：https://github.com/anthropics/claude-code/releases
• Superpowers 插件：https://github.com/obra/superpowers
• OpenSpec 框架：https://openspec.dev/
• 10 個(gè)必備最佳實(shí)踐：https://discuss.huggingface.co/t/10-essential-claude-code-best-practices-you-need-to-know/174731
• Claude Code Gotchas：https://www.dolthub.com/blog/2025-06-30-claude-code-gotchas/
• Superpowers 插件詳解：https://www.builder.io/blog/claude-code-superpowers-plugin
• OpenSpec + Superpowers 三重棧：https://www.heyuan110.com/posts/ai/2026-04-09-claude-code-openspec-superpowers/

到此這篇關(guān)于Claude Code 最佳實(shí)踐完整指南(最新更新)的文章就介紹到這了,更多相關(guān)Claude Code最佳實(shí)踐內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論