v2.1.0

v2.1.0 — Skill & agent nâng cấp theo obra/superpowers

Bản 2.1.0 thêm ba skill, viết lại ba skill cũ, và sửa một lỗi khiến một skill đi kèm package không bao giờ được chọn. Không có breaking change: không đổi tên tool, không đổi format config, không đổi chỗ lưu dữ liệu.

Skill mới

Skill	Giải quyết việc gì
using-hive	Bảng chọn skill theo ý định ("xây X" → brainstorming; "sửa bug" → systematic-debugging; đang nhận review → receiving-code-review). Trước đây danh sách available_skills có tồn tại nhưng không agent nào được dặn phải đọc, nên skill sống mà không được nạp
receiving-code-review	Nhận feedback: kiểm chứng với code trước khi sửa, được phản biện có lý do kỹ thuật, cấm "Bạn nói đúng hoàn toàn!" và cấm sửa nửa vời khi còn item chưa rõ
finishing-a-development-branch	Kết thúc công việc: kiểm tra xanh trước, đưa đúng 3 lựa chọn (merge local / PR / giữ nguyên), rồi chạy lại test trên kết quả đã merge mới dọn dẹp. Menu không có mục "discard" — xoá việc chỉ khi người dùng nói rõ

Skill viết lại

• brainstorming — bản cũ 53 dòng, bắt hỏi từng câu kể cả khi request đã quyết. Bản mới có cổng "bạn thực sự biết gì?": việc đã rõ thì làm luôn; chỉ hỏi khi đoán sai sẽ khiến người dùng phải làm lại. Mỗi câu hỏi phải nói câu trả lời sẽ đổi gì. Sửa luôn chỗ mâu thuẫn: bản cũ dặn ghi design vào docs/plans/ trong khi Hive lưu ở .hive/features/<f>/plan.md.
• executing-plans — có sổ tiến độ .hive/features/<feature>/progress.md. Ghi base commit trước khi dispatch, ghi một dòng khi task xong (commit từ..đến, số test, minor để lại). Sau compaction đọc sổ và git log, không đoán. Đây là lỗi đắt nhất mà superpowers ghi nhận: controller mất trí nhớ rồi chạy lại cả loạt task đã merge. Review chạy mỗi batch thay vì hỏi từng lần; không còn bắt chờ duyệt giữa các batch của một plan đã duyệt.
• code-reviewer — vòng sửa có trần: minor không vào vòng lặp, vòng 1–3 quay lại người làm cũ, vòng 4–5 đổi người làm và tăng bậc model, tối đa 5 vòng, hết trần thì phán quyết có ghi sổ chứ không bỏ lặng. Thêm mục Do Not Pre-Judge: cấm dặn reviewer "đừng báo lỗi này" / "chỗ này chấp nhận được".
• skill-creator — sửa chỗ sai về format (frontmatter chỉ có name + description; phần thân tự do, không phải template), thêm quy trình kiểm thử skill kiểu TDD: xem agent làm sai khi chưa có skill (đỏ) → viết skill tối thiểu (xanh) → vá lỗi ngụy biện (refactor).

Agent & subagent

• zetta và architect được dặn kiểm tra bảng skill trước hành động đầu tiên, kể cả trước khi hỏi lại.
• swarm và zetta có hướng dẫn chọn model theo vai: việc máy móc 1–2 file → model rẻ; nhiều file / mô tả bằng lời → model trung bình; thiết kế, debug khó, review cuối → model mạnh nhất. Kèm cảnh báo "số lượt ăn hơn giá token" và nhắc khai báo model tường minh.
• forager có mục Definition of Done: "xong" nghĩa là có thứ vừa chạy trong session này chứng minh, không phải code trông đúng; không verify được thì phải nói rõ phần nào.
• swarm và forager có bảng skill — trước đây code-reviewer, receiving-code-review, finishing-a-development-branch không thể tới được agent cần chúng (forager chỉ có đúng một dòng về docker-mastery).
• Thêm mục ghi lại bài học trước khi đóng feature: hive_memory_set cho kiến thức dự án, hive_agents_md cho convention, hive_context_write cho quyết định của feature.

Lỗi đã sửa

• description: | bị đọc thành "|". Frontmatter kiểu YAML block scalar (dấu | rồi nội dung xuống dòng) làm cả scripts/generate-skills.ts lẫn src/skills/file-loader.ts trả về đúng một ký tự. Skill ponytail đi kèm package viết đúng kiểu này, nên description của nó là "|" — không nêu trigger nào, agent không bao giờ chọn. Nay cả | và > được gộp thành một dòng; test phủ cả hai. Skill của người dùng viết theo kiểu này cũng hết bị.
• Hai description mở đầu bằng chủ đề thay vì trigger (ponytail, ask-questions-if-underspecified). Test mới bắt buộc mọi skill builtin có description ≥ 20 ký tự và bắt đầu bằng "Use when/before/after/during".
• Test chặn prompt trỏ tới skill không tồn tại: một prompt bảo agent hive_skill("x") với x không có sẽ tạo tool call lỗi, mà agent đọc là "không có hướng dẫn nào".

Kiểm chứng

• opencode-hive: 668 pass / 0 fail; hive-core: 150 pass / 0 fail; tsc --noEmit sạch cả hai; bun run build ok.
• Chạy thật trên OpenCode 2.1.4: nạp bản build cục bộ, gọi hive_skill("using-hive") trong một session thật và nhận đúng nội dung skill. Trước khi sửa parser, chính lần chạy này là thứ phát hiện ponytail hỏng.

Nâng cấp

npm i -g @hung319/opencode-hive@2.1.0

Không cần sửa agent_hive.json. Nếu bạn đã đặt disableSkills, các skill mới xuất hiện bình thường; thêm tên vào danh sách đó nếu muốn tắt.