AgentsAgent
Skills don't do everything themselves — they deploy specialized subagents, each running in its own context with its own tools. 26 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 fan-out to the number of distinct concerns (default 8, hard ceiling 10), so it 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. 26 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 fan-out theo số mối-quan-tâm khác biệt (mặc định 8, trần cứng 10), nên 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.
advisor
Runs the interview-driven advisory workflow in isolation — scouts, asks one question at a time to reframe a raw idea into exact requirements, then gives honest advice and better alternatives.Chạy luồng tư vấn dẫn-dắt-phỏng-vấn trong context cách ly — scout, hỏi từng câu một để nắn ý tưởng thô thành yêu cầu chính xác, rồi đưa lời khuyên trung thực và phương án tốt hơn.
grid-axis-selector
Picks the coverage axes for a plan's coverage-grid planning mode — which dimensions get swept before cells get filled.Chọn các trục coverage cho chế độ lập-kế-hoạch coverage-grid — trục nào được quét trước khi điền ô.
grid-filler
Fills a skeleton coverage grid under an anti-confab contract — defaults to an honest stub whenever a cell can't be grounded in evidence.Điền một grid coverage khung xương theo hợp đồng chống-bịa — mặc định về stub trung thực khi một ô không thể neo bằng chứng.
Build & repairXây & sửa
developer
Implements a scoped slice test-first — in-place for a sequential phase, or in an isolated worktree for a parallel slice — owning a disjoint set of file globs.Implement một lát có phạm vi, test-trước — tại chỗ cho phase tuần tự, hoặc trong worktree cách ly cho lát song song — 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ị.
spec-craft-critic
A critique lens for spec-family artifacts (vision/BRD/PRD/epic/story) — judges writing quality: plain language, clarity, consistency, and testable phrasing.Lăng kính phê bình cho tài liệu họ-spec (vision/BRD/PRD/epic/story) — chấm chất lượng viết: ngôn ngữ rõ, mạch lạc, nhất quán, và cách diễn đạt kiểm thử được.
spec-tech-critic
A critique lens for spec-family artifacts — judges whether the artifact is actually buildable and testable, surfacing hidden dependencies and untestable acceptance criteria.Lăng kính phê bình cho tài liệu họ-spec — xét xem tài liệu có thực sự xây và kiểm thử được không, phát hiện phụ thuộc ẩn và tiêu chí nghiệm thu không kiểm thử được.
decision-reconciler
Tier-2 of decision-flip governance — a deep judgment pass over the whole Decision Register: finds semantic contradictions between rulings and checks whether the code still honors each DEC.Tầng-2 của quản trị lật-quyết-định — một lượt phán xét sâu trên toàn Decision Register: tìm mâu thuẫn ngữ nghĩa giữa các ruling và kiểm tra code còn tôn trọng từng DEC không.
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.
Delegation & external lanesUỷ thác & lane ngoài
workflow-orchestrator
Designs a spawn strategy before you delegate — subagents vs Workflow vs Agent Teams, groups the fan-out by concern, sizes the sub-count and batch cadence — without spawning anything itself.Thiết kế chiến lược spawn trước khi uỷ thác — subagent vs Workflow vs Agent Teams, nhóm fan-out theo mối-quan-tâm, định cỡ số sub và nhịp batch — mà không tự spawn gì.
escalation-consultant
Autonomous counsel from the strongest model (fable) in one run — spawn it from a lower tier or a stuck subagent for hard design, debugging, or trade-off calls. Advisory-only. Since v6.2.0 it also reads for the --ultra/--debate panel — the separate synthesizer over N independent producers — and is who a repeated stuck state escalates to.Cố vấn tự chủ từ model mạnh nhất (fable) trong một lượt — spawn từ tier thấp hơn hoặc từ subagent bị kẹt cho các quyết định thiết kế/gỡ lỗi/đánh đổi khó. Chỉ tư vấn. Từ v6.2.0 nó còn làm người ĐỌC cho panel --ultra/--debate — người tổng hợp riêng đứng trên N nhà sản xuất độc lập — và là nơi một trạng thái kẹt lặp lại được leo thang tới.
lane-relayer
Carries ONE advisory/coding request to a partner lane — gemini or a named ccs provider — and returns its provenance envelope verbatim. One courier for every lane: the lane skill builds the whole command, the relayer runs only allowlisted companions, and the lane's I/O never floods the main thread.Chuyển MỘT yêu cầu tư vấn/code sang một lane đối tác — gemini hoặc một provider ccs có tên — và trả envelope xuất xứ nguyên văn. Một courier cho mọi lane: skill của lane dựng nguyên lệnh, relayer chỉ chạy companion nằm trong allowlist, và I/O của lane không tràn vào luồng chính.
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, an opt-in gate artifact a stage can require 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 tùy chọn mà một stage có thể đò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/.
FAQHỏi đáp
Do agents change my code on their own?Agent có tự đổi code không?
developer agent is the main builder — it works in-place for a sequential phase, or in an isolated worktree for a parallel slice, 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 — làm tại chỗ cho phase tuần tự, hoặc trong worktree cách ly cho lát song song, trên các glob file được sở hữu.Why cap the fan-out?Vì sao giới hạn fan-out?
hs-usage admit --want N, which answers the smallest of what was asked, what the machine's load carries and what the quota allows; with the quota unknown it admits one and asks you.Luật điều phối giới hạn fan-out để điều phối, gộp và duyệt ở lại phiên điều khiển — và để một lượt không sinh ra bầy agent vô hạn khó kiểm. Trước mọi lượt fan-out hơn một agent, nó hỏi hs-usage admit --want N, lệnh trả về số nhỏ nhất giữa số được xin, mức tải máy gánh được và quota cho phép; khi chưa biết quota thì chỉ cho một và hỏi bạn.