智慧體底層技術概覽

AI程式設計工具，包括但不限於Claude Code、Codex、Cursor、Copilot、Windsurf等，都屬於Agent的一員。就像VS Code不僅是個編輯器，還是一個擴充套件平臺，智慧體也是一個可擴充套件、可定製的綜合體。

AI 智慧體有多種使用方式，可以在瀏覽器中使用，也可以在本地安裝使用，智慧體可以作為一個服務來執行，有IDE、CLI和IDE外掛等使用方式。無論在本地還是瀏覽器使用，一般都有ask、plan、agent（code）等多種模式。

AI程式設計工具的安裝和配置不難，你不妨先體驗一下各種使用方式，在對話方塊中輸入問題，由Agent回答問題或編寫程式碼。然而，僅僅體驗遠遠不夠，通過了解各種底層技術，你可以讓智慧體成為你的專屬工具，解決你專屬的問題。

Agent框架

基礎層（Memory.md）

基礎層是AI agent的長期記憶系統，核心是一份.md格式的文件。在Claude中，該文件的命名為CLAUDE.md，在Codex中命名為Agent.md，在OpenClaw中為SOUL.md、MEMEORY.md、Identity.md等，其它智慧體都大同小異。

記憶檔案具有不同的層級，全域性、專案和專案的特定模組都可以有不同的記憶檔案。這些文件是智慧體長期記憶的載體，你可以在裡面寫下一些通用的專案規範、技術棧、專案的背景和目標、程式碼風格和規範等。

在每輪對話中，記憶檔案作為System Prompt存在，不會被上下文壓縮，因此必須要簡潔有效。

雖然系統可以生成預設的記憶檔案，但是在編寫個人專案時，還是強烈建議建立一個記憶檔案。以下是一個個人部落格專案的Memory.md內容：

# Project: personal academic blog

## Introduction
- ... 

## Technology Stack
- astro
- island architecture
- tailwind css
- Cult UI
- ...

## Code Sytle
- function length (max 5 lines)
- line length (max 120 characters)
- component-based design principles

## Rules
- tests first
- no comments to main directly
- no exceptions
- ...

task: 嘗試書寫專案Agent.md，需要參考記憶檔案中的內容，需要體現專案的特點。

擴充套件層

在真實的系統種，各個元件相互協作，共同完成複雜任務。

如果你需要“每次都必須執行”的操作（比如程式碼格式化），你需要 100% 確定性——選擇 Commands 或 Hooks。如果你希望 Claude “智慧判斷何時使用”（比如識別到安全問題時自動深入分析），你可以接受機率性——選擇 Skills。如果任務可能很重，你希望“既可以手動觸發，也可以讓 Claude 自己決定”，你需要可控性——選擇 SubAgents。

Commands

ai程式設計工具會內建部分核心能力，通過手動輸入/選擇來觸發，比如/plan可以觸發智慧體的計劃能力。

使用者也可能根據自身需求，將適合標準化操作的task編寫成固定的Commands，比定義/commit命令來約束團隊的提交格式。

task: 檢視某個agent的文件，嘗試執行各個command。

Skills

如下是一份Skill的內容：

如memory.md一樣，skill也是一個md文件，文件內部描述了agent擁有的能力，以及使用方法和注意事項。

與Tools相比，Tools是函式呼叫，而Skill封裝了條件判斷、提示詞、策略和呼叫順序等，Tools僅僅是Skill的一種引數。

Skill不是固定化的標準執行流程，而是具備強烈的“領域感”（安全、架構、效能）的專家判斷，依賴上下文而非關鍵詞，Agent會自動判斷（語義推理）是否啟用相應技能。

Agent內部內建了建立skill的skill，你可以自定義一個skill，也可以讓Agent去學習，自動建立skill。

task：閱讀skill，嘗試編寫自己的skill。

SubAgent

子代理解決agent系統規模膨脹的問題，單一的agent上下文無法承載過多的許可權和職責。

因此，複雜任務需要拆解為簡單任務，每個任務交給一個sub agent來完成，每個sub agent具有獨立的職責和受限的許可權。SubAgents 適合隔離執行——高噪聲任務（比如在大量日誌中尋找出錯資訊，在大量文件中檢索相關資源）、需要特定許可權的任務。

其觸發方式可以由 Claude 決定或使用者指定。

Hooks

鉤子是在特定事件觸發時自動執行的指令碼，監控所有工具呼叫。其觸發方式是事件自動觸發，適合自動化檢查——格式化、安全檢查、日誌記錄等。

繼承層

負責連結外部世界

Headless

無頭模式讓 Claude Code 在沒有人工互動的情況下執行，適合 CI/CD 整合——自動程式碼審查、自動修復、自動生成變更日誌等。

MCP(Model Context Protocol )

連線外部工具和服務，適合工具連線——可以把任何外部系統變成 Claude 可呼叫的工具。

程式設計介面層（Agent SDK）

當配置式的擴充套件不夠用時，你可以用程式碼來驅動 Claude。這種方式適合構建自定義 Agent——完全控制執行流程、自定義工具、複雜工作流。

Plugin

my-team-plugin/
├── commands/           # 斜槓命令
│   └── review.md
├── skills/             # 技能
│   └── security-check/
│       └── SKILL.md
├── agents/             # 子代理
│   └── test-runner.md
├── hooks/              # 鉤子
│   └── pre-edit.sh
└── plugin.json         # 外掛配置