update first - 84

2026-06-30 02:21:39 +09:00
commit 07ac1bdcdd
561 changed files with 88164 additions and 0 deletions
@@ -0,0 +1,31 @@
+# Danh mục và Giao thức Quản lý Công cụ (Tool Registry Policy)
+
+Giao thức này quy định danh sách trắng các công cụ và câu lệnh hệ thống (Tools & CLI Commands) được phép thực thi tương ứng với từng loại Agent để đảm bảo nguyên tắc đặc quyền tối thiểu (Least Privilege).
+
+## 1. Danh sách trắng công cụ (Tool Whitelist per Agent)
+
+### A. Boss Orchestrator (okr.bossbuiltin)
+Được phép điều phối và chạy toàn bộ các chuỗi công cụ chuẩn bị và kiểm thử:
+- `Read`, `Write`, `Edit`, `Glob`, `Grep` (IDE Tools)
+- Các script hỗ trợ: `.specify/scripts/bash/casan-harness.sh`, `security-check.sh`, `governance-check.sh`, `agent-metrics.sh`
+- CLI Commands: `npm install`, `npm run build`, `npm run start:dev`, `docker compose`
+
+### B. Special Design/Specification Agents (srs, bd, specify, plan, dd, tasks)
+Chỉ được phép làm việc trên các tệp tin tài liệu (Read-only on source code, Write-only on specification files):
+- `Read` (toàn bộ workspace)
+- `Write`, `Edit` (chỉ trên thư mục `docs/` và `specs/`)
+- **CẤM HOÀN TOÀN:** Sử dụng công cụ `Bash` để thực thi shell command tùy ý.
+
+### C. Implementation Agent (speckit.implement)
+Được quyền viết code và tự động xác minh lỗi:
+- `Read`, `Write`, `Edit` (trên toàn bộ workspace bao gồm `backend/`, `frontend/`)
+- `Bash` (chỉ giới hạn cho các lệnh: `npm install`, `npm run build`, `npm test`, `npx prisma`, `git diff`)
+
+### D. Testing & Quality Agent (okr.testkit, okr.reviewcode)
+Được quyền chạy kiểm thử và review:
+- `Read` (toàn bộ workspace)
+- `Bash` (chỉ chạy lệnh kiểm thử: `npm test`, `npm run test:cov`, `jest`, `mocha`)
+
+## 2. Quy tắc kiểm tra (Tool Access Guard)
+- Trước khi thực thi bất kỳ lệnh hệ thống nào thông qua `Bash` tool, script kiểm duyệt `governance-check.sh` sẽ phân tích cú pháp câu lệnh (Command Line Parsing).
+- Nếu lệnh chứa các từ khóa cấm hoặc hành vi gọi ứng dụng không nằm trong whitelist của Agent đang gọi, hành động sẽ bị **Block** và ghi nhận sự kiện vi phạm an toàn tool.