AgentsAgent
Skills don't do everything themselves — they deploy specialized subagents, each running in its own context with its own tools. 20 of them, from planner to red-teamer. Most are advisory: they report findings and do not mutate the plan or code unless explicitly tasked. The orchestration rule caps it at 2 subagents per turn, so fan-out stays controllable.Skill không tự làm hết — chúng triển khai subagent chuyên biệt, mỗi cái chạy trong context riêng với bộ tool riêng. 20 agent, từ planner đến red-teamer. Phần lớn là tư vấn: chúng báo phát hiện và không sửa plan hay code trừ khi được giao rõ. Luật điều phối giới hạn 2 subagent mỗi lượt, nên fan-out vẫn kiểm soát được.
Agents vs skillsAgent vs skill
A skill is the workflowSkill là quy trình
Prose guidance that orchestrates a task — it decides when to spawn an agent and what to ask of it.Hướng dẫn prose điều phối một task — nó quyết khi nào sinh agent và hỏi gì.
An agent is the specialistAgent là chuyên gia
A focused worker with a sharp remit and an isolated context. It returns a report; the controlling session keeps merge decisions and approvals.Một thợ tập trung với phạm vi sắc và context cách ly. Nó trả về báo cáo; phiên điều khiển giữ quyết định gộp và duyệt.
Plan & researchLập kế hoạch & nghiên cứu
planner
Researches and writes a comprehensive, phased implementation plan before significant work begins.Nghiên cứu và viết kế hoạch triển khai đầy đủ, chia phase trước khi bắt tay việc lớn.
researcher
Surveys multiple sources, weighs evidence, and returns a ranked, cited research report.Khảo nhiều nguồn, cân bằng chứng, trả về báo cáo nghiên cứu xếp hạng có trích dẫn.
brainstormer
Explores solution space and debates architectural trade-offs with honest caveats.Khám phá không gian giải pháp và tranh luận đánh đổi kiến trúc với cảnh báo trung thực.
Build & repairXây & sửa
developer
Implements a scoped slice test-first in an isolated worktree, owning a disjoint set of file globs.Implement một lát có phạm vi, test-trước, trong worktree cách ly, sở hữu tập file glob rời nhau.
debugger
Investigates a failure to its root cause — logs, system behavior, performance — before any fix.Điều tra lỗi đến tận gốc — log, hành vi hệ thống, hiệu năng — trước mọi sửa chữa.
code-simplifier
Refines recently-changed code for clarity and consistency while preserving every behavior.Tinh chỉnh code vừa đổi cho rõ và nhất quán mà giữ nguyên mọi hành vi.
ui-ux-designer
Designs interfaces, wireframes, and design systems — responsive layouts, accessibility, and design documentation, returning production-ready HTML/CSS with annotations.Thiết kế giao diện, wireframe và design system — layout responsive, accessibility và tài liệu thiết kế, trả về HTML/CSS sẵn sàng production kèm chú thích.
Verify & challengeKiểm chứng & phản biện
The adversarial core. Several of these compose into the critique panel (below).Lõi đối nghịch. Vài cái trong số này hợp thành hội đồng critique (bên dưới).
code-reviewer
Comprehensive review with scout-based edge-case detection — bugs, regressions, security.Review toàn diện với dò edge-case kiểu scout — bug, regression, bảo mật.
tester
Validates through unit / integration tests, coverage, and error-handling checks.Validate qua test unit / integration, coverage, và kiểm xử-lý-lỗi.
red-teamer
Adversarially attacks an artifact about to execute — a plan before cook, a migration before it runs.Tấn công đối nghịch một artifact sắp chạy — plan trước cook, migration trước khi chạy.
independent-revalidator
Re-derives a load-bearing conclusion from primary evidence before reading the original reasoning, then flags disagreement.Suy lại một kết luận trọng yếu từ bằng chứng gốc trước khi đọc lập luận cũ, rồi nêu chỗ bất đồng.
critique-consolidator
Merges findings from several critique lenses into one ranked, de-duplicated verdict.Gộp phát hiện từ nhiều lăng kính critique thành một verdict xếp hạng, khử trùng lặp.
product-value-critic
Neutral product lens — does the artifact build something users actually need? Job-to-be-done, value mapping, and the riskiest unproven assumption.Lăng kính sản phẩm trung lập — artifact có xây thứ user thật sự cần? Job-to-be-done, ánh xạ giá trị, và giả định rủi ro nhất chưa kiểm chứng.
market-fit-critic
Neutral market lens — does it stand up against the alternatives? Differentiation, defensibility, and the path to capturing value.Lăng kính thị trường trung lập — có trụ được trước các lựa chọn thay thế? Khác biệt hoá, khả năng phòng thủ, và đường thu giá trị.
Docs & coordinationTài liệu & điều phối
docs-manager
Manages technical documentation and standards, keeping docs in sync with the codebase.Quản lý tài liệu kỹ thuật và standards, giữ docs đồng bộ với codebase.
project-manager
Tracks progress against the plan, consolidates agent reports, and surfaces status.Theo dõi tiến độ theo plan, gộp báo cáo agent, và hiển thị trạng thái.
git-manager
Stages, commits, and pushes with conventional commits and a pre-commit secret scan.Stage, commit, push với conventional commit và quét secret trước commit.
journal-writer
Writes technical journal entries with a deliberate brutal-honesty candor — fixed at every voice_level.Viết nhật ký kỹ thuật với độ thẳng tàn nhẫn có chủ đích — cố định ở mọi voice_level.
Composition: the critique panelKết hợp: hội đồng critique
Agents are most powerful composed. hs:critique fans independent lenses at one artifact, then consolidates them into a single verdict — the pattern behind critique-consensus.json, the gate artifact required at pr / ship.Agent mạnh nhất khi kết hợp. hs:critique toả các lăng kính độc lập vào một artifact, rồi gộp thành một verdict — chính là mẫu sau critique-consensus.json, artifact gate bị đòi ở pr / ship.
- Advisory agents report; they don't merge code or approve plans — the controlling session does. The "deployed by" chips show the skills that commonly spawn each one; the live source is
harness/plugins/hs/agents/.Agent tư vấn báo cáo; chúng không gộp code hay duyệt plan — phiên điều khiển làm. Chip "triển khai bởi" cho thấy skill thường sinh ra mỗi agent; nguồn trực tiếp ởharness/plugins/hs/agents/. - An agent's own candor is fixed in its spec — the journal-writer stays brutal, the critique stays neutral — independent of the terminal voice.Độ thẳng riêng của agent cố định trong spec — journal-writer giữ tàn nhẫn, critique giữ trung tính — độc lập với giọng terminal.
FAQHỏi đáp
Do agents change my code on their own?Agent có tự đổi code không?
developer agent is the main builder, and it works inside an isolated worktree on owned file globs.Phần lớn là tư vấn — báo phát hiện, không sửa plan/code trừ khi một skill giao rõ. Agent developer là thợ xây chính, và làm trong worktree cách ly trên các glob file được sở hữu.