# Subagen Claude Code: Struktur, Lima Peranan dan Penyelarasan

> Fail ejen, perihalan, lima templat lengkap, pelaksanaan selari, Managed Agents, batasan dan kos dengan contoh dikekalkan.

Source: https://ailoot.ai/blog/ms/claude-code-subagents/
Canonical: https://ailoot.ai/blog/ms/claude-code-subagents/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-222
Revision: sha256-43c35db8e2873c49839d423bf1d2c732a63b5ca22ff58b6863181d945fdef041


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Subagen dalam Claude Code ialah pembantu AI khusus yang mempunyai konteks, set alat dan gesaan sistem sendiri. Sembang utama menentukan sendiri sama ada hendak menyerahkan tugas kepadanya, atau anda boleh memanggilnya mengikut nama menggunakan `@agent-`. Subagen mengendalikan tugas khusus tanpa memenuhi perbualan utama, lalu hanya memulangkan ringkasan akhir. Dalam panduan ini, saya menerangkan perbezaan subagen dengan Skill, cara menulis perihalan supaya Claude benar-benar memanggilnya, dan cara menyediakan 5 peranan yang berfungsi dalam 30 minit.

</div>

<div class="aside" data-semantic="ailoot-docs-link" aria-label="Dokumentasi Ailoot">

Arahan praktikal untuk menggunakan Ailoot terdapat dalam [dokumentasi](https://ailoot.ai/docs/).

</div>

## Apakah Subagen dalam Claude Code, dan Mengapa Ia Bukan “Sekadar Skill Lain”?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Subagen ialah pembantu AI khusus yang mempunyai konteks, gesaan sistem dan set alat sendiri. Dokumentasi rasmi Anthropic menerangkannya sebagai pembantu yang mengambil tugas sampingan dalam konteks berasingan dan hanya memulangkan ringkasan hasilnya. Berbeza daripada [Skills](https://ailoot.ai/blog/ms/claude-code-skills-library/), yang dimuatkan ke dalam sembang utama dan menggunakan memorinya, subagen berfungsi secara berasingan—dan itulah nilai utamanya.

</div>

Dokumentasi Claude Code mentakrifkannya begini:

<figure>
<blockquote>
<p>Subagen ialah pembantu AI khusus untuk jenis tugas tertentu. Gunakan subagen apabila tugas sampingan akan memenuhi perbualan utama dengan hasil carian, log atau kandungan fail yang tidak akan anda rujuk semula: subagen melakukan kerja itu dalam konteksnya sendiri dan hanya memulangkan hasilnya.</p>
</blockquote>
<figcaption>— Dokumentasi Claude Code, https://code.claude.com/docs/en/sub-agents</figcaption>
</figure>

Dalam istilah yang mudah difahami oleh usahawan: bayangkan sebuah agensi hartanah. Ada pengarah, pemasar, peguam dan pengurus jualan. Seorang pekerja yang bertukar-tukar antara semua peranan ini bukanlah sebuah pasukan; dia seorang yang terlalu dibebani tugas. Sebuah pasukan terbentuk apabila setiap orang mempunyai konteks dan bidang tanggungjawab sendiri, sementara pengarah hanya memberikan tugasan dan menyatukan hasilnya.

Subagen dalam Claude Code berfungsi dengan cara yang sama. Sembang utama ialah pengarah. Subagen ialah pakar dengan tugas khusus, konteks sendiri dan set alatnya sendiri. Apabila sesuatu tugas sepadan dengan perihalan seorang pakar, pengarah menyerahkannya kepada pakar itu—tanpa terbeban dengan butirannya.

### 5 Tujuan Anthropic Membina Subagen

Dokumentasi Anthropic menyenaraikan tepat lima sebab untuk mencipta subagen sendiri:

<figure>
<blockquote>
<p>Subagen membantu anda mengekalkan konteks dengan memastikan penyelidikan dan pelaksanaan tidak memenuhi perbualan utama; menguatkuasakan kekangan dengan mengehadkan alat yang boleh digunakan oleh subagen; menggunakan semula konfigurasi merentas projek melalui subagen peringkat pengguna; mengkhususkan tingkah laku untuk domain tertentu melalui gesaan sistem yang terarah; dan mengawal kos dengan menghalakan tugas kepada model yang lebih pantas dan murah seperti Haiku.</p>
</blockquote>
<figcaption>— Dokumentasi Claude Code, https://code.claude.com/docs/en/sub-agents</figcaption>
</figure>

Perkara paling praktikal dalam senarai ini bagi bukan pengatur cara ialah **kawalan kos**. Anda boleh menghantar tugas penyelidikan berat kepada model Haiku yang murah sambil meneruskan perbualan utama dengan Sonnet atau Opus. Penjimatan token berkadar terus.

### Semak Sokongan Penyarangan untuk Versi Dipasang

Templat panduan ini menggunakan satu sesi utama yang menyerahkan terus kepada pekerja. Jangan anggap dokumentasi lama yang menyatakan “subagen tidak boleh melancarkan subagen lain” sebagai peraturan sepanjang zaman: tingkah laku penyarangan bergantung pada versi dipasang dan alat dibenarkan. [Panduan subagen bersarang berasingan](https://ailoot.ai/blog/ms/subagen-bersarang-claude-code/) membincangkan resipi khusus versi. Sahkan sokongan pemasangan anda sebelum merancang delegasi lebih dalam.

## Apakah Perbezaan Subagen dengan Skill, Perintah Sengkang dan Hook?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Claude Code mempunyai empat mekanisme peluasan, dan semuanya tidak boleh saling menggantikan. CLAUDE.md ialah pengetahuan kekal yang sentiasa dimuatkan. Skills ialah metodologi sedia guna yang dimuatkan ke dalam sembang utama apabila dicetuskan. Perintah sengkang ialah butang `/command` eksplisit untuk tindakan sekali sahaja. Subagen ialah pakar dengan konteks sendiri, yang menerima tugasan daripada sembang utama. Kesilapan paling lazim ialah mencipta subagen apabila yang diperlukan sebenarnya Skill.

</div>

Panduan terdahulu tentang [Skills](https://ailoot.ai/blog/ms/claude-code-skills-library/) menerangkan bahawa skills dan perintah sengkang dalam Claude Code pada asasnya telah digabungkan dalam satu format. Namun, subagen ialah entiti yang berbeza—bukan sekadar “skill yang lebih besar”.

Jadual ringkasan bagi empat mekanisme:

| Ciri | CLAUDE.md | Skill | Perintah sengkang | Subagen |
|----|----|----|----|----|
| Bila dimuatkan | Sentiasa | Apabila perihalan dicetuskan | Apabila arahan `/name` diberikan secara eksplisit | Apabila ditugaskan atau melalui `@agent-name` |
| Tempat ia berfungsi | Dalam konteks utama | Dalam konteks utama | Dalam konteks utama | Dalam konteks terasingnya sendiri |
| Model | Sama seperti sembang utama | Sama | Sama | Mana-mana—Haiku, Sonnet, Opus, warisi |
| Alat | Semua yang tersedia | Warisi | Warisi | Boleh dihadkan dengan `tools:` |
| Perkara yang dipulangkan | \- | Sebaris dalam perbualan utama | Sebaris | Hanya ringkasan akhir |
| Pelaksanaan selari | \- | Tidak | Tidak | Ya—beberapa serentak |
| Memori antara sesi | Fail berdekatan | Fail berdekatan | Fail berdekatan | Medan `memory: user/project/local` |

Cara yang baik untuk menjelaskannya dalam panduan berbahasa Inggeris: skills ialah resipi; subagen ialah rakan sekerja khusus.

Put simply: skills ibarat resipi; subagen ibarat rakan sekerja khusus.

Dalam amalan, ia berfungsi begini: skills diaktifkan secara automatik apabila perihalannya sepadan dengan tugas, manakala subagen dipanggil secara eksplisit—sama ada sembang utama memutuskan untuk menyerahkan tugas atau anda memanggilnya mengikut nama.

### Carta Keputusan: “Yang Mana Patut Saya Pilih?”

Apabila anda berfikir, “Saya perlukan Claude melakukan X,” ajukan empat soalan ini:

1.  **Adakah ini pengetahuan yang patut sentiasa tersedia?** Contohnya, “kita menyetempatkan kandungan ke dalam bahasa pilihan pengguna,” atau “kita tidak menggunakan tanda pisah panjang.” Letakkannya dalam `CLAUDE.md`.
2.  **Adakah ini metodologi tercetus yang kini anda lakukan secara manual?** Contohnya, “Saya menulis laporan jualan setiap Isnin.” Cipta **skill**.
3.  **Adakah ini tugas yang akan menggunakan konteks sembang utama, atau boleh dijalankan secara selari?** Contohnya, “penyelidikan mendalam merentas 30 sumber,” atau “audit keselamatan semasa saya menulis ciri baharu.” Cipta **subagen**.
4.  **Adakah anda memerlukan respons automatik terhadap suatu peristiwa dalam Claude Code?** Contohnya, “jalankan linter selepas setiap Edit.” Tulis **hook**.

90% tugas usahawan termasuk dalam dua kategori pertama. Subagen ialah alat tahap seterusnya, apabila anda beralih daripada “satu tugas pada satu masa” kepada penyelarasan.

## Di Manakah Subagen Disimpan, dan Yang Mana Mempunyai Keutamaan?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Subagen Claude Code disimpan di lima tempat dengan keutamaan berbeza—daripada tetapan terurus organisasi hingga pemalam. Jika dua fail mempunyai nama yang sama, fail yang lebih tinggi dalam keutamaan akan digunakan. Tetapan paling lazim bagi usahawan solo ialah `~/.claude/agents/` untuk ejen peribadi serba guna dan `.claude/agents/` dalam projek tertentu untuk ejen khusus projek.

</div>

Hierarki subagen mempunyai lima tahap, disusun daripada keutamaan tertinggi kepada terendah:

| Tahap | Laluan | Digunakan untuk | Keutamaan |
|----|----|----|----|
| Perusahaan | Tetapan terurus organisasi | Semua pekerja syarikat | 1 (tertinggi) |
| Sesi | Bendera CLI `--agents` dengan JSON | Sesi semasa sahaja | 2 |
| Projek | `.claude/agents/name.md` | Projek ini sahaja | 3 |
| Peribadi | `~/.claude/agents/name.md` | Semua projek anda | 4 |
| Pemalam | `<plugin>/agents/name.md` | Di mana-mana pemalam diaktifkan | 5 (terendah) |

Logik keutamaan sama seperti untuk Skills dan CLAUDE.md: organisasi mengatasi CLI, CLI mengatasi projek, projek mengatasi peribadi, dan peribadi mengatasi pemalam.

### Perkara yang Perlu Diketahui tentang Pemuatan

Subagen dimuatkan apabila sesi Claude Code bermula. Jika anda menyunting fail ejen secara manual pada cakera, perubahan itu tidak akan digunakan sehingga anda memulakan semula sesi. Suntingan melalui UI interaktif `/agents` berkuat kuasa serta-merta.

Satu subagen bagi setiap skop bermaksud satu fail. Jika `.claude/agents/` mengandungi `code-reviewer.md` dan satu lagi `code-reviewer.md` di sebelahnya (contohnya, daripada sandaran lama), Claude Code akan mengabaikan salah satunya secara senyap. Tiada pemberitahuan akan muncul.

Subagen pemalam ialah perkara yang berasingan. Ia mempunyai sekatan keselamatan: ia **tidak menyokong** medan `hooks`, `mcpServers` dan `permissionMode`. Ini menghalang pemasangan pemalam pihak ketiga daripada memberinya kebenaran menjalankan kod sewenang-wenangnya pada mesin anda.

## Struktur Fail Subagen: Frontmatter dan Isi

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Subagen ialah satu fail Markdown dengan frontmatter YAML di bahagian atas dan gesaan sistem di bawahnya. Minimum ialah dua medan: `name` (huruf kecil + tanda sempang) dan `description` (bila Claude patut menyerahkan tugas kepadanya). Skema penuh merangkumi 16 medan: tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt. Anthropic mengesyorkan supaya perihalan dikekalkan ringkas—semakin jelas pencetusnya, semakin tepat Claude mengaktifkan ejen.

</div>

Contoh minimum daripada dokumentasi rasmi—hanya 9 baris:

```markdown
---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.
```

Itu sudah memadai. Jika pengguna berkata “semak PR saya” dalam sembang utama, Claude memadankan “penyemak / kod / kualiti” dengan perihalan lalu menyerahkan tugas kepada subagen. Subagen membaca perbezaan kod, menghasilkan komen dan memulangkan ringkasan ke sembang utama. Sembang utama tidak dipenuhi log dan analisis perantaraan.

### Skema Frontmatter Penuh

| Medan | Wajib | Fungsinya |
|----|----|----|
| `name` | Ya | Pengecam unik, huruf kecil + tanda sempang. Nama fail TIDAK semestinya sama |
| `description` | Ya | Bila Claude menyerahkan tugas. Ini pencetus automasi |
| `tools` | Tidak | Senarai alat yang dibenarkan. Jika ditinggalkan, semua alat daripada induk diwarisi |
| `disallowedTools` | Tidak | Senarai sekatan. Digunakan DAHULU, kemudian `tools` |
| `model` | Tidak | `haiku` / `sonnet` / `opus` / ID penuh / `inherit` (lalai) |
| `permissionMode` | Tidak | `default` / `acceptEdits` / `auto` / `dontAsk` / `bypassPermissions` / `plan` |
| `maxTurns` | Tidak | Had langkah sebelum berhenti |
| `skills` | Tidak | Skills yang dimuatkan ke dalam konteks subagen semasa permulaan |
| `mcpServers` | Tidak | Pelayan MCP yang hanya tersedia kepada subagen ini |
| `hooks` | Tidak | PreToolUse / PostToolUse / Stop, dikhususkan untuk subagen ini |
| `memory` | Tidak | `user` / `project` / `local` — folder untuk memori merentas sesi |
| `background` | Tidak | `true` — sentiasa berjalan di latar belakang. Lalai `false` |
| `effort` | Tidak | `low` / `medium` / `high` / `xhigh` / `max` — tahap penaakulan |
| `isolation` | Tidak | `worktree` — berjalan dalam worktree git berasingan |
| `color` | Tidak | Warna UI: red / blue / green / yellow / purple / orange / pink / cyan |
| `initialPrompt` | Tidak | Frasa pertama yang dilihat subagen apabila dilancarkan melalui `--agent` |

Medan `model: haiku` itulah “kawalan kos” daripada senarai lima tujuan tadi. Jika anda mempunyai ejen penyelidikan yang membaca 50 halaman dokumentasi, jalankannya menggunakan Haiku untuk menjimatkan kos 5–7 kali ganda berbanding Opus.

Medan `isolation: worktree` menangani masalah penting: subagen membuat perubahan yang mungkin berbahaya (pemfaktoran semula, migrasi), tetapi anda tidak mahu ia menyentuh salinan kerja anda. Tetapkan `isolation: worktree`, maka Claude Code akan mencipta salinan git sementara bagi projek; subagen bekerja di sana dan memulangkan perbezaan kod untuk disemak.

### Isi Fail ialah Gesaan Sistem

Selepas frontmatter, terdapat Markdown biasa—iaitu gesaan sistem subagen. Struktur khusus tidak diperlukan, tetapi corak ini terbukti berkesan:

1.  **Siapa anda** — satu ayat: “anda penyemak kod,” “anda juruaudit keselamatan,” “anda penyelenggara dokumentasi.”
2.  **Bila anda dipanggil dan perkara pertama yang anda lakukan** — 2–3 tindakan pertama selepas menerima tugas.
3.  **Senarai semak pemeriksaan atau langkah** — 5–10 perkara yang perlu diikuti oleh subagen.
4.  **Perkara yang anda pulangkan** — format laporan akhir. Ini penting: jika anda tidak menetapkan format, subagen akan menghasilkan “esei” dan bukannya ringkasan berstruktur.
5.  **Perkara yang TIDAK anda lakukan** — batasan eksplisit. Tanpa bahagian ini, subagen akan cenderung membuat improvisasi.

Kekalkan isi fail pada 200–500 baris. Jika lebih panjang, pindahkan rujukan yang panjang ke fail berdekatan yang berasingan dan pautkannya dalam gesaan.

## Cara Menulis Perihalan supaya Claude Pasti Memanggil Subagen Anda

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Description ialah satu-satunya medan yang dilihat Claude pada permulaan sesi dan digunakan untuk memutuskan sama ada tugas patut diserahkan. Aduan paling lazim di forum ialah “Saya menulis subagen, tetapi Claude tidak memanggilnya.” Penyelesaiannya ialah formula tiga bahagian: perkara yang dilakukannya + frasa pencetus dalam tanda petikan + bila TIDAK patut menggunakannya. Anthropic secara eksplisit mengesyorkan memasukkan frasa seperti “gunakan secara proaktif” atau “gunakan sejurus selepas” dalam perihalan untuk menggalakkan Claude menyerahkan tugas secara proaktif.

</div>

Titik kesakitan yang biasa ialah menyediakan subagen untuk semakan kod, tetapi Claude melakukan semuanya sendiri tanpa menggunakan ejen itu. Biasanya hanya ada satu sebab: perihalan ditulis sebagai “Pembantu untuk semakan kod.” Claude tidak faham bila ia patut mencetuskannya.

### Formula Perihalan Berkesan (3 Bahagian)

**Bahagian 1 — perkara yang dilakukannya.** Satu ayat tentang hasil, bukan proses. Bukan “menganalisis kod,” tetapi “mencari kelemahan dalam kod dan memulangkan senarai berserta tahap keterukan dan pembaikan.”

**Bahagian 2 — bila hendak mencetuskannya.** 3–5 frasa dalam tanda petikan, seperti permintaan sebenar pengguna. Jangan meneka—lihat sejarah sembang dan ungkapan sebenar.

**Bahagian 3 — bila TIDAK hendak mencetuskannya.** 1–2 frasa tentang tugas serupa yang tidak patut dijawab oleh subagen ini. Tanpa bahagian ini, dua ejen serupa sentiasa bercanggah.

### Frasa Ajaib “Gunakan Secara Proaktif”

Dokumentasi rasmi Anthropic memberikan saranan langsung:

<figure>
<blockquote>
<p>Claude menyerahkan tugas secara automatik berdasarkan tugas yang dinyatakan dalam permintaan anda, medan description dalam konfigurasi subagen dan konteks semasa. Untuk menggalakkan penyerahan tugas secara proaktif, tambahkan frasa seperti 'gunakan secara proaktif' pada perihalan subagen.</p>
</blockquote>
<figcaption>— Dokumentasi Claude Code, https://code.claude.com/docs/en/sub-agents</figcaption>
</figure>

Dengan kata lain, Claude cenderung **tidak** memanggil subagen secara lalai jika perihalannya tiada petunjuk yang jelas. Tambahkan “gunakan secara proaktif” atau “gunakan sejurus selepas menulis kod,” dan pengaktifannya meningkat dengan ketara.

### Beginilah Rupa Perihalan yang Kukuh

```yaml
description: |
  Pakar semakan kod. Menyemak kod secara proaktif demi kualiti,
  keselamatan dan kebolehselenggaraan. Gunakan sejurus selepas menulis atau
  mengubah suai kod. Memulangkan senarai isu mengikut keutamaan dengan tahap keterukan
  serta cadangan pembaikan.
  Jangan panggil untuk perubahan dokumentasi, suntingan README atau penulisan semula
  mesej commit - semua ini dikendalikan oleh doc-maintainer.
```

Perkara yang berkesan di sini:

- Kata kerja “menyemak” + “memulangkan” menyatakan hasil khusus, bukan proses.
- “Secara proaktif” dan “sejurus selepas” ialah pencetus eksplisit.
- “Jangan panggil untuk...” mengelakkan pertindihan dengan subagen serupa.
- Bahasa Inggeris dalam description ialah amalan biasa. Claude lebih baik membuat pemadanan dalam bahasa Inggeris.

## 5 Peranan Subagen Sedia Digunakan yang Berfungsi dalam 10 Minit

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Untuk mengelakkan daripada menulis subagen pertama anda dari kosong, gunakan corak yang terbukti dan sesuaikannya. Saya telah menghuraikan 5 peranan yang meliputi tugas lazim: code-reviewer (menyemak kod selepas perubahan), security-auditor (mencari kelemahan dan kebocoran), research-agent (penyelidikan mendalam merentas 8+ sumber), doc-maintainer (menyelaraskan dokumentasi dengan kod), dan refactor-agent (pemfaktoran semula yang selamat melalui worktree git). Setiap satunya disertakan templat sedia guna yang boleh anda salin dan sesuaikan.

</div>

Setiap peranan di bawah ialah satu fail, `.claude/agents/<name>.md`. Selepas mencipta fail itu, mulakan semula Claude Code, buka `/agents` dan semak sama ada ejen baharu itu muncul dalam senarai. Kemudian anda boleh memanggilnya dengan `@agent-name`.

### 1. code-reviewer — semak kod selepas setiap perubahan

Ini contoh rasmi daripada dokumentasi Anthropic, disesuaikan untuk proses kerja:

```markdown
---
name: code-reviewer
description: |
  Pakar semakan kod. Menyemak kod secara proaktif demi kualiti,
  keselamatan dan kebolehselenggaraan. Gunakan sejurus selepas menulis atau
  mengubah suai kod.
tools: Read, Grep, Glob
model: inherit
color: blue
---

Anda penyemak kod kanan yang memastikan piawaian kualiti kod yang tinggi.

Apabila dipanggil:
1. Baca diff dan senarai fail diubah yang dibekalkan sesi utama. Jika tiada, minta sesi utama membekalkannya.
2. Gunakan Read, Grep dan Glob untuk memeriksa fail berkaitan.
3. Pulangkan dapatan tanpa mengubah fail atau menjalankan arahan shell.

Senarai semak semakan:
- Kod jelas dan mudah dibaca
- Nama fungsi dan pemboleh ubah sesuai
- Tiada kod pendua
- Pengendalian ralat yang betul
- Tiada rahsia atau kunci API yang terdedah
- Pengesahan input dilaksanakan
- Liputan ujian memadai
- Pertimbangan prestasi ditangani

Berikan maklum balas mengikut keutamaan:
- Isu kritikal (mesti dibaiki sebelum penggabungan)
- Amaran (patut dibaiki)
- Cadangan (boleh dipertimbangkan untuk penambahbaikan)

Format: bagi setiap isu - fail:baris + 1 ayat yang menerangkan sebabnya masalah + pembaikan khusus.
```

Kuncinya ialah `tools: Read, Grep, Glob`: penyemak mempunyai alat baca fail dan carian, tanpa akses Bash, Write atau Edit. Sesi utama menyediakan diff dan memberikannya kepada penyemak. Sekadar mengarahkan ejen menjalankan `git diff` sahaja tidak menyekat alat Bash yang diberikan sepenuhnya.

### 2. security-auditor — cari kelemahan dan kebocoran

Peranan ini menggunakan `opus` untuk penaakulan lebih mendalam serta sekatan alat Read, Grep dan Glob yang sama. Memori berterusan dikeluarkan daripada templat baca sahaja ini kerana mendayakan memori ejen turut memberikannya keupayaan menulis memori:

```markdown
---
name: security-auditor
description: |
  Pakar audit keselamatan. Gunakan secara proaktif untuk mencari
  kelemahan OWASP Top 10, rahsia terdedah, risiko suntikan dan pengesahan yang rosak.
  Jalankan sebelum sebarang pelancaran atau penggabungan ke main.
tools: Read, Grep, Glob
model: opus
color: red
---

Anda juruaudit keselamatan. Cari kelemahan yang boleh dieksploitasi, bukan isu gaya.

Senarai semak audit:
- Suntikan SQL / NoSQL
- Risiko XSS (tersimpan, pantulan, berasaskan DOM)
- Risiko CSRF / SSRF
- Rahsia berkod keras (kunci API, token, kata laluan)
- Pengesahan / pengurusan sesi yang rosak
- Penyahsirian yang tidak selamat
- Pengesahan input tiada
- Rentasan laluan
- Pengalihan terbuka
- Rujukan objek langsung yang tidak selamat (IDOR)

Bagi setiap penemuan:
- Tahap keterukan: Kritikal / Tinggi / Sederhana / Rendah
- Fail:baris
- Senario serangan dalam 1–2 ayat
- Saranan pembaikan berserta contoh kod

Abaikan gangguan linter atau gaya. Laporkan hanya isu yang boleh dieksploitasi.
```

Akses baca sahaja dari segi alat, dengan `model: opus` untuk pemeriksaan rumit seperti rantaian kelemahan.

### 3. research-agent — penyelidikan mendalam merentas 8+ sumber

Corak ini diterangkan oleh Anthropic sendiri dalam artikelnya tentang sistem penyelidikan berbilang ejen. Kuncinya ialah format output yang eksplisit dan larangan menumpahkan hasil mentah:

```markdown
---
name: research-agent
description: |
  Pakar penyelidikan web mendalam. Gunakan secara proaktif untuk
  pencarian fakta, analisis persaingan, pengumpulan dokumentasi luaran dan perbandingan
  pendekatan merentas pelbagai sumber.
tools: WebFetch, WebSearch, Read, Write
model: sonnet
maxTurns: 30
color: purple
---

Anda penganalisis penyelidikan. Matlamat: ringkasan sintesis, bukan longgokan hasil carian.

Proses:
1. Pecahkan soalan kepada 3–5 pertanyaan kecil
2. Lakukan WebSearch untuk setiap pertanyaan kecil dan ambil 3–5 sumber teratas bagi setiap satunya
3. Sahkan dakwaan merentas sekurang-kurangnya 2 sumber bebas
4. Tolak kandungan ladang SEO dan agregator; utamakan sumber primer
5. Petik kata demi kata dengan atribusi URL untuk sebarang dakwaan khusus
6. Pulangkan: TL;DR (3 poin) + Penemuan + Sumber (minimum 8 domain)

Corak anti yang perlu dielakkan:
- Jangan petik fakta daripada satu sumber sahaja
- Jangan olah semula petikan seolah-olah ia dipetik kata demi kata
- Jangan pulangkan longgokan hasil carian mentah kepada ejen induk
- Jangan masukkan pengenalan / penutup kosong ("Semoga membantu")
```

`maxTurns: 30` ialah perlindungan daripada penyelidikan yang berlarutan tanpa penghujung. Anthropic melaporkan angka ini dalam sistem berbilang ejennya:

<figure>
<blockquote>
<p>Sistem berbilang ejen dengan Claude Opus 4 sebagai ejen utama dan Claude Sonnet 4 sebagai subagen mengatasi Claude Opus 4 tunggal sebanyak 90.2%.</p>
</blockquote>
<figcaption>— Kejuruteraan Anthropic, https://www.anthropic.com/engineering/multi-agent-research-system</figcaption>
</figure>

Sembilan puluh peratus merujuk kepada tugas penanda aras penyelidikan. Dalam amalan, peningkatan bagi tugas perniagaan lebih kecil, tetapi skalanya secara umum serupa.

### 4. doc-maintainer — pastikan dokumentasi selaras dengan kod

Peranan ini menggunakan `model: haiku`—contoh biasa “kawalan kos.” Dokumentasi tidak memerlukan Opus; Haiku mampu melakukannya dengan kos sepertiga harga:

```markdown
---
name: doc-maintainer
description: |
  Pakar penyelarasan dokumentasi. Gunakan selepas ciri digabungkan untuk mengemas kini
  README, dokumen API, CHANGELOG. Membaca commit terkini, mengenal pasti
  perubahan yang belum didokumenkan dan mengemas kini dokumen secara proaktif.
tools: Read, Write, Edit, Glob, Grep, Bash
model: haiku
memory: project
color: green
---

Anda menyelenggara dokumentasi supaya selaras dengan kod.

Apabila dipanggil:
1. Jalankan `git log --since="last release"` untuk melihat perubahan terkini
2. Baca README.md, docs/, CHANGELOG.md
3. Kenal pasti jurang: ciri baharu tanpa dokumen, API yang telah dibuang tetapi masih didokumenkan, versi yang tidak sepadan

Output:
- Fail yang dikemas kini (gunakan Edit, bukan Write - kekalkan struktur sedia ada)
- Entri CHANGELOG.md dalam format Keep-A-Changelog
- Senarai perubahan yang dibuat (ringkasan diff sebenar, bukan olahan semula)

Peraturan gaya:
- Ayat aktif, masa kini
- Contoh kod mesti boleh disalin dan ditampal
- Tiada bahasa pemasaran ("hebat", "teguh", "lancar")
- Tiada pengisi ("Panduan ini akan membantu anda...")
```

### 5. refactor-agent — pemfaktoran semula yang selamat melalui worktree

Peranan ini menggunakan `isolation: worktree`—subagen bekerja dalam salinan repositori berasingan dan anda hanya menggabungkan hasilnya jika sesuai:

```markdown
---
name: refactor-agent
description: |
  Pakar pemfaktoran semula yang selamat. Gunakan untuk penamaan semula, pengekstrakan dan penyerapan sebaris
  yang tidak patut menyentuh salinan kerja anda sebelum disemak. Berjalan dalam
  worktree git sementara.
tools: Read, Edit, Write, Bash, Grep, Glob
model: sonnet
isolation: worktree
permissionMode: acceptEdits
color: yellow
---

Anda memfaktorkan semula kod tanpa mengubah tingkah lakunya.

Peraturan tegas:
1. Ujian mesti lulus SEBELUM dan SELEPAS pemfaktoran semula.
   Jika ujian sebelum pemfaktoran semula gagal, BERHENTI dan laporkan.
2. Satu pemfaktoran semula atomik bagi setiap commit (ekstrak, namakan semula, serap sebaris).
3. Jangan sekali-kali mengubah API awam tanpa arahan eksplisit.
4. Jangan sekali-kali mengubah ujian melainkan ujian itu menguji pelaksanaan yang difaktorkan semula secara langsung.

Proses:
- Jalankan suite ujian -> garis dasar
- Lakukan pemfaktoran semula atomik
- Jalankan suite ujian -> sahkan
- Commit dengan mesej konvensional: refactor(scope): what

Pulangkan: ringkasan perubahan + laluan worktree supaya pengguna boleh membandingkan dan menggabungkan hasilnya.
```

Dengan peranan ini, masalah pemfaktoran semula yang paling menyakitkan—“saya merosakkannya dan tidak tahu cara untuk mengembalikannya”—dapat diatasi: salinan asal kekal utuh, dan subagen bekerja dalam worktree terasing.

Mahukan bukan sahaja menyalin subagen sedia guna tetapi juga memasang **gabungan yang menjadikan Claude alat yang stabil**? Subagen ialah sebahagian daripada **klon AI** anda: cara memberikan Claude pasukan khusus yang bekerja mengikut logik anda. Tiga tunjang metodologi ini ialah: **klon AI** (Skills + Subagen) + **[Otak Kedua](https://ailoot.ai/blog/ms/claude-code-second-brain/)** + **Kejuruteraan Konteks**. Gabungan ini mengubah Claude daripada pembantu yang meneka menjadi alat yang berfikir mengikut logik anda.

## Melancarkan 5 Subagen secara Selari: Penyelarasan + Pekerja

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Kekuatan utama subagen ialah pelaksanaan selari. Satu sembang utama memegang pelan, sementara lima (atau sepuluh) subagen khusus bekerja serentak pada fasa yang berlainan, masing-masing dalam konteksnya sendiri. Sembang utama mengumpulkan dan menyemak hasilnya. Ini mempercepat kerja 3–5 kali berbanding kerja berurutan—dan turut menghapuskan “pencemaran konteks,” apabila perbualan utama ditenggelami log dan analisis perantaraan.

</div>

Penyelarasan selari ialah persediaan “konduktor + orkestra”. Konduktor memegang pelan, tidak menulis not, dan menyemak permainan pemuzik. Jika seseorang memainkan not yang salah, konduktor menyuruhnya bermain semula dan bukannya cuba menyiapkan tugas itu bagi pihaknya.

Analogi yang lebih dekat bagi usahawan ialah agensi pemasaran yang menyediakan strategi untuk pelanggan baharu. Seorang penganalisis membuat SWOT, seorang lagi menjalankan analisis pesaing, orang ketiga menyediakan profil khalayak, penganalisis kanan menapis hipotesis yang tidak sesuai dengan bajet, dan pengurus projek menyusun pembentangan akhir. Dalam Claude Code, saluran kerja ini bermula dengan satu ayat—dan pengkritik telah dibina dalam proses itu, bukannya muncul selepas semuanya selesai.

### Gesaan Penyelarasan Minimum

Satu ayat dalam sembang utama sudah memadai:

```
Lancarkan lima subagen secara selari: tiga research-agents pada sumber berlainan
(dokumen Anthropic, repositori GitHub, penulis blog AI), satu critic-agent untuk menapis
kesimpulan yang lemah, dan satu summary-agent untuk dokumen akhir.

Konteks: Saya sedang menulis panduan tentang X. Panjang sasaran: 2,000 patah perkataan dengan sumber.
Sebelum bermula, setiap ejen membaca CLAUDE.md.
```

Claude kemudian menyerahkan tugas kepada lima ejen. Setiap satu bekerja dalam konteks sendiri: ejen penyelidikan menggunakan sumber masing-masing, pengkritik menapis, dan ejen ringkasan menyusun hasilnya. Hanya ringkasan akhir dikembalikan kepada sembang utama.

### Bila Pelaksanaan Selari Berbaloi

Bukan dalam semua keadaan. Pelaksanaan selari hanya munasabah apabila:

1.  Tugas **bebas antara satu sama lain**. Jika research-agent #2 menunggu hasil research-agent #1, tiada pelaksanaan selari—mereka pada hakikatnya akan bekerja secara berurutan.
2.  Tugas mengambil **masa yang lama**. Melaksanakan “buang ruang kosong di hujung baris” secara selari tidak bermakna; kos melancarkan subagen akan menghabiskan penjimatan.
3.  Anda mempunyai **had yang mencukupi**. Lebih lanjut tentang hal ini dalam bahagian berasingan di bawah—subagen selari menghabiskan token dengan cepat.

### Multi-Agent v2 daripada Anthropic: Langkah Seterusnya

Pada Mei 2026, Anthropic melancarkan Multi-Agent Orchestration v2 dengan tiga perbezaan penting berbanding pendekatan klasik melancarkan subagen secara selari. Maklumat lanjut dalam bahagian seterusnya.

## Perkara Baharu dalam Multi-Agent v2: Penyelarasan, Hasil, Dreaming

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Pada 6 Mei 2026, di persidangan Code with Claude di San Francisco, Anthropic mengumumkan tiga ciri Managed Agents v2—semuanya dalam beta awam. Multi-Agent Orchestration membolehkan ejen utama memecahkan kerja dan menyerahkannya kepada pakar secara selari dengan sistem fail kongsi. Outcomes membolehkan anda menulis rubrik kejayaan, kemudian ejen penggred berasingan menyemak hasilnya. Dreaming seperti tidur REM: proses berjadual membaca sesi terdahulu, mencari corak dan mengemas kini memori ejen.

</div>

### Multi-Agent Orchestration: Sistem Fail Kongsi + Semakan Semasa Aliran Kerja

Anthropic menerangkan ciri ini begini:

<figure>
<blockquote>
<p>Apabila kerja terlalu banyak untuk satu ejen, penyelarasan berbilang ejen membolehkan ejen utama memecahkan tugas kepada beberapa bahagian dan menyerahkan setiap bahagian kepada pakar dengan model, gesaan dan alatnya sendiri. Pakar-pakar ini bekerja secara selari pada sistem fail kongsi dan menyalurkan hasil mereka ke dalam konteks kongsi ejen utama.</p>
</blockquote>
<figcaption>— Anthropic - Baharu dalam Claude Managed Agents, https://claude.com/blog/new-in-claude-managed-agents</figcaption>
</figure>

Perbezaan utamanya daripada subagen klasik ialah **sistem fail kongsi**. Sebelum ini, setiap subagen bekerja secara terasing sepenuhnya, dan pertukaran maklumat hanya berlaku melalui ringkasan yang dipulangkan. Kini pakar boleh menulis ke folder kongsi, dan ejen utama membaca hasil semasa kerja berlangsung, bukan hanya pada penghujungnya. Ini menyelesaikan masalah “semua orang bekerja sepanjang hari, tetapi akhirnya diketahui bahawa dua orang menggunakan pendekatan yang tidak serasi.”

Kedua ialah **semakan semasa aliran kerja**. Ejen utama boleh berhenti seketika dan bertanya kepada mana-mana pakar “bagaimana perkembangannya,” kemudian melaraskan keseluruhan pelan. Ini hampir sama dengan cara pengurus pasukan sebenar bekerja.

### Outcomes: Rubrik dan Bukannya Arahan Langkah demi Langkah

Dengan Outcomes, anda menulis kriteria kejayaan, dan ejen mencari cara untuk memenuhinya. Penggred berasingan menyemak hasil dalam konteksnya sendiri supaya hasil itu tidak “tercemar” oleh penaakulan ejen utama.

<figure>
<blockquote>
<p>Ini meningkatkan kejayaan penyelesaian tugas sehingga 10 mata berbanding gelung gesaan standard, dengan peningkatan terbesar pada tugas yang paling mencabar.</p>
</blockquote>
<figcaption>— Anthropic - Baharu dalam Claude Managed Agents, https://claude.com/blog/new-in-claude-managed-agents</figcaption>
</figure>

Peningkatan sepuluh peratus bagi tugas mencabar ialah pencapaian besar. Terutamanya apabila tugas dirangka sebagai “hasilkan artikel panjang yang memenuhi kriteria kualiti ini,” bukannya “ikut langkah 1–7.”

### Dreaming: Ejen Mengumpul Pengalaman antara Sesi

Ini ciri yang paling baharu dari segi konsep. Ejen meneliti sesi terdahulu, mencari corak kejayaan dan kesilapan, lalu mengemas kini stor memori. Anda boleh mengkonfigurasi semakan manual sebelum perubahan digunakan, atau membenarkan ejen menyunting memori sendiri.

Anthropic melaporkan bahawa Harvey (syarikat teknologi perundangan) menyaksikan peningkatan kejayaan kira-kira enam kali ganda dalam tugas penggubalan dokumen undang-undang selepas melaksanakan Dreaming. Ini sudah berfungsi dalam pengeluaran, bukan sekadar demonstrasi.

### Maksudnya bagi Usahawan yang Tidak Mengatur Cara

Multi-Agent Orchestration kini tersedia melalui Claude Agent SDK, bukan terus melalui CLI Claude Code. Namun, arahnya jelas: penyelarasan sedang beralih daripada “anda melancarkan N subagen secara manual” kepada “anda menerangkan tugas, lalu ejen utama menentukan kepada siapa tugas diserahkan dan bagaimana.” Jika anda baru mula menggunakan subagen, jangan bimbang tentang v2 dahulu. Pelajari corak klasik “1 sembang utama + 3–5 subagen dengan peranan berbeza,” dan dalam 3–6 bulan anda boleh beralih secara semula jadi kepada Managed Agents.

## 7 Kesilapan yang Menyebabkan Subagen Gagal Berfungsi

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Masalah subagen paling lazim bukan pepijat Claude tetapi kesilapan dalam subagen itu sendiri. Perihalan tanpa frasa pencetus, cuba menggunakan subagen untuk tugas yang sesuai bagi Skill, menjalankan 60 ejen secara selari “sebab nampak hebat,” memberikan semua alat kepada setiap ejen, tiada format output yang eksplisit, seruan yang kabur, dan seni bina berasaskan peranan dan bukannya tugas. Setiap kesilapan ini merosakkan sama ada pengaktifan atau hasil subagen.

</div>

### Kesilapan 1. Perihalan “Pembantu untuk X” Tidak Mencetuskan Pengaktifan

Gejala: anda menulis subagen, menyemak strukturnya dan semuanya sah, tetapi Claude tidak memanggilnya apabila menerima permintaan pengguna. Sebabnya hampir selalu sama: perihalan itu abstrak, seperti “Pembantu untuk semakan kod.” Penyelesaiannya: tulis 3–5 frasa sebenar pengguna dalam tanda petikan terus dalam perihalan, serta “gunakan secara proaktif” / “gunakan sejurus selepas.”

### Kesilapan 2. Mencipta Subagen Sedangkan Skill yang Diperlukan

Kos subagen lebih tinggi daripada Skill—ia mencipta konteks sendiri, memuatkan gesaan sistem sendiri dan menggunakan lebih banyak token. Jika tugas itu ringkas, tidak menggunakan konteks utama dan boleh diselesaikan dalam satu langkah, jadikannya Skill, bukan subagen. Contoh corak anti: subagen `format-validator` yang menyemak skema JSON berdasarkan 20 peraturan. Ini patut menjadi Skill: satu model, tidak memerlukan pengasingan dan tidak memuatkan konteks tambahan.

### Kesilapan 3. Melancarkan “60 Ejen Selari” Sejak Awal

Ini ilusi yang paling meluas. Anda melihat ciapan yang mengatakan, “Saya ada 1,500 ejen yang bekerja,” lalu berfikir, “Saya patut buat begitu juga.” Dalam amalan, 60 ejen menghabiskan had pelan Pro dalam masa sejam, menghasilkan timbunan hasil yang bercanggah dan pada penghujung hari anda tidak menyiapkan apa-apa.

Seorang pengamal di Medium menerangkannya begini:



Penyelesaiannya: mulakan dengan satu subagen untuk satu tugas. Setelah mahir, tambahkan subagen kedua dengan peranan yang berbeza. Setelah mahir menyelaras dua ejen, teruskan kepada pasukan 3–5 orang. Melompat daripada “semalam baru memasang Claude Code” kepada “20 ejen berjalan serentak hari ini” pasti akan merosakkan kod dan menghabiskan had.

### Kesilapan 4. Memberikan Semua Alat kepada Setiap Ejen

Jika penyemak kod anda mempunyai akses kepada Bash, Write dan WebFetch, itu merupakan lubang keselamatan dan kos yang besar. Penyemak tidak sepatutnya dibenarkan menulis fail, apatah lagi mengakses internet.



Penyelesaiannya: hadkan `tools` dengan ketat. Penyemak kod hanya menerima `Read, Grep, Glob`. Juruaudit keselamatan menerima alat baca/carian yang sama dan diff daripada sesi utama. Menambah Bash memberikan keupayaan shell; ia tidak menyekat ejen kepada `git diff` secara automatik. Ejen penyelidikan menerima `WebFetch, WebSearch, Read, Write`. Jangan berikan subagen kebenaran melebihi keperluan tugas khususnya.

### Kesilapan 5. Subagen Menumpahkan Hasil Mentah ke dalam Konteks Utama

Jika ejen penyelidikan memulangkan “ini semua 30 halaman yang saya temui; fikir sendiri” kepada sembang utama, kelebihan terbesar subagen telah hilang: pengasingan hingar. Penyelesaiannya: wajibkan format output secara eksplisit dalam gesaan sistem subagen. “Pulangkan HANYA: TL;DR 3 poin + senarai 5 sumber. TIADA longgokan kod, TIADA hasil carian mentah.” Format ini perlu **ketat**—subagen tidak sepatutnya bebas “menukarkannya menjadi esei.”

### Kesilapan 6. Seruan Kabur: Permintaan Penyerahan Tugas Tidak Jelas

Subagen **tidak dapat melihat** sejarah dialog utama. Ia bermula dengan konteks kosong + CLAUDE.md + apa-apa sahaja yang anda tulis kepadanya secara eksplisit. Jika anda menulis “baiki pengesahan”, subagen akan mereka-reka butirannya. Sebaliknya: “Baiki gelung pengalihan OAuth apabila, selepas log masuk berjaya, pengguna dihalakan semula ke /login dan bukannya /dashboard. Fail: src/lib/auth.ts.”

Peraturan yang jelas: apabila menyerahkan tugas, berikan subagen konteks sebanyak yang akan anda berikan kepada kontraktor baharu yang baru menyertai projek.

### Kesilapan 7. Ejen Berasaskan Peranan dan Bukannya Ejen Berasaskan Tugas

Corak yang menggoda ialah: “mari kita cipta frontend-developer, backend-developer dan qa-engineer, dan minta mereka bekerja sebagai satu pasukan.” Ia tidak berkesan. Setiap “peranan” kehilangan konteks tentang keseluruhan projek, dan mereka tidak dapat bersetuju tentang butiran kerana tidak dapat melihat satu sama lain.

Penyelesaiannya: subagen patut mengendalikan **tugas** berulang dengan output yang jelas, bukan **peranan**. Bukan “frontend-developer,” tetapi “explore-ui-tree,” “refactor-component,” “audit-accessibility.” Setiap subagen berasaskan tugas melakukan satu kerja khusus dan memulangkan satu hasil khusus.

## Berapakah Kos Subagen Selari, dan Bila Ia Berbaloi?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Subagen selari menghabiskan token 3–5 kali lebih pantas berbanding kerja berurutan. Dengan pelan Pro (\$20/bulan), melancarkan 5 subagen selari bermakna menghabiskan kuota dalam masa sejam. Max 5x (\$100/bulan) ialah minimum yang realistik untuk kerja selari secara kerap. Subagen berbaloi untuk tugas yang memerlukan sekurang-kurangnya 10 minit kerja tertumpu—melancarkan satu hanya untuk kesilapan taip dalam README akan menggunakan lebih banyak token daripada masa yang dijimatkan.

</div>



| Konfigurasi | Penggunaan harian dengan kerja aktif |
|----|----|
| 1 sesi Claude Code | ~\$13 |
| 3 subagen selari | ~\$30-40 |
| 5–10 secara selari | \$50-130 |
| 30 ejen (10 pembangun × 3 subagen) | \$300-400 |

Pelan Pro akan habis dalam masa sejam jika anda melancarkan 5 subagen selari untuk tugas rumit. Max 5x ($100) ialah minimum yang realistik untuk kerja selari secara kerap. Bagi pasukan dan Enterprise, soal kos sudah dikendalikan pada peringkat belanjawan alat.

Untuk mengetahui lebih lanjut tentang penjimatan token dalam Claude Code, lihat [panduan berasingan tentang had](https://ailoot.ai/blog/ms/claude-code-token-limits-saving/). Bagi subagen, peraturan utamanya ialah ia berbaloi untuk tugas yang memerlukan **sekurang-kurangnya 10 minit** kerja tertumpu. Jika tugas lebih singkat, jangan cipta subagen; lakukan dalam sembang utama atau dengan Skill.

## Bagaimanakah Subagen Disepadukan ke dalam Klon AI dan Otak Kedua Anda?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Rumusan utama">

Rumusan utama

Subagen ialah langkah keempat dalam metodologi Claude Code. Urutan logiknya: mula-mula [CLAUDE.md](https://ailoot.ai/blog/ms/claude-md-template/) (konteks kekal), kemudian [Skills](https://ailoot.ai/blog/ms/claude-code-skills-library/) (metodologi sedia guna), seterusnya [Otak Kedua](https://ailoot.ai/blog/ms/claude-code-second-brain/) (struktur pengetahuan projek), dan hanya selepas itu Subagen (pekerja khusus). Songsangkan urutan ini, dan anda akan mendapat gembar-gembur tanpa hasil. Subagen tanpa CLAUDE.md akan mereka-reka perkara; tanpa Skills, ia mengulangi kerja yang sama dari awal setiap kali; tanpa struktur pengetahuan, ia memberikan jawapan biasa.

</div>

Subagen bergantung pada tiga perkara yang patut ada dalam projek anda sebelum mencipta pakar pertama:

1.  **[CLAUDE.md](https://ailoot.ai/blog/ms/claude-md-template/) yang betul.** Subagen membaca CLAUDE.md sebelum bermula—ia ialah “kontrak pekerjaannya.” Tanpanya, subagen tidak tahu konteks projek, batasan atau nadanya. Ia akan mereka-reka perkara.

2.  **[Skills](https://ailoot.ai/blog/ms/claude-code-skills-library/) asas.** Skill ialah metodologi berbungkus. Subagen hanya memuatkan Skills yang diperlukan, bukan semuanya sekali gus. Tanpa Skills, subagen mengulangi kerja yang sama dari awal setiap kali.

3.  **[Otak Kedua](https://ailoot.ai/blog/ms/claude-code-second-brain/): struktur pengetahuan.** Folder `business/` (atau padanannya dalam bidang anda) ialah pustaka yang dirujuk oleh semua subagen. Tanpanya, subagen memberikan jawapan ChatGPT biasa yang tidak dapat dibezakan daripada jawapan orang lain.

Menterbalikkan urutan ini bermakna mendapat gembar-gembur tanpa hasil. “Saya ada 60 subagen selari” dengan folder `business/` yang kosong bermakna 60 sesi ChatGPT biasa dengan pendekatan yang sama.

Gabungan lengkap—**Klon AI + Otak Kedua + Kejuruteraan Konteks**—ialah **tiga tunjang** yang menjadikan Claude konsisten. Subagen ialah sebahagian daripada klon AI: cara memberikan Claude pasukan khusus yang bekerja mengikut logik anda.

<div class="section" role="doc-bibliography" aria-label="Sumber">

### Sumber

- [Cipta subagen tersuai - Dokumentasi Claude Code](https://code.claude.com/docs/en/sub-agents)
- [Membolehkan Claude Code bekerja dengan lebih autonomi - Berita Anthropic](https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously)
- [Cara kami membina sistem penyelidikan berbilang ejen - Kejuruteraan Anthropic](https://www.anthropic.com/engineering/multi-agent-research-system)
- [Melengkapkan ejen untuk dunia sebenar dengan Agent Skills - Kejuruteraan Anthropic](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
- [Baharu dalam Claude Managed Agents (Multi-Agent v2, Outcomes, Dreaming) - Blog Anthropic](https://claude.com/blog/new-in-claude-managed-agents)

</div>

Cara terpantas untuk bermula ialah menyalin `code-reviewer` daripada contoh pertama di atas ke dalam `.claude/agents/code-reviewer.md`, memulakan semula Claude Code dan memanggil `@agent-code-reviewer` untuk commit anda yang seterusnya. Dalam 5 minit, anda akan tahu sama ada anda memerlukan subagen atau sembang utama sudah memadai.



<div class="aside" data-semantic="ailoot-link" aria-label="Ailoot">

Anda boleh terus meneroka Ailoot di [ailoot.ai](https://ailoot.ai/).

</div>

## Soalan lazim: Subagen Claude Code: Struktur, Lima Peranan dan Penyelarasan

### Bolehkah penyemak menjalankan git diff sahaja hanya kerana prompt menyatakannya?

Tidak. Memberikan alat Bash memberikan keupayaan shell; prompt bukan senarai benarkan arahan. Templat penyemak baca sahaja membuang Bash, Write dan Edit, serta menerima diff daripada sesi utama.

### Bagaimanakah penyemak memeriksa perubahan terkini tanpa Bash?

Sesi utama membekalkan diff dan senarai fail diubah dalam delegasi. Penyemak kemudian membaca serta mencari fail itu dengan Read, Grep dan Glob lalu memulangkan dapatan tanpa menyuntingnya.


## Ailoot · Syarikat dan portfolio projeknya

Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.
