Provenance – Chuỗi bằng chứng thực thi (Thái Sử Các)
Skill thu thập toàn bộ sự kiện vận hành của hệ đa tác tử và sinh chuỗi bằng chứng theo trace_id kèm chỉ mục vector để kiểm toán, phát lại.
Tự động hóaNâng cao★ 6,083⑂ 585Điểm AI 5/10Cập nhật lần cuối: 2 thg 9, 2026
Làm được gì
- Ghi nhận mọi hành động của các tác tử: phân phối, quét, phân tích, sinh thẻ.
- Chuẩn hoá theo schema
actor / action / target / timestamp / trace_idđể tạo evidence_chain truy vết được. - Lưu song song Qdrant (chỉ mục vector qua MCP) và SQLite (dự phòng cục bộ) để vừa tìm kiếm ngữ nghĩa vừa chịu lỗi.
- Cung cấp API tra cứu theo
trace_id, khoảng thời gian hoặc theo từng tác tử, phục vụ bảng kiểm toán và xác định điểm rollback. - Có quy tắc xử lý lỗi rõ ràng: ghi vector thất bại → cache SQLite rồi bù sau; sự kiện sai schema → loại bỏ riêng lẻ; truy vấn timeout → trả snapshot gần nhất và gắn cờ
stale.
Phù hợp với ai
- Người thiết kế log vận hành và audit trail cho pipeline nhiều tác tử.
- Nhóm cần phát lại (replay) quá trình ra quyết định của agent để gỡ lỗi.
- Kỹ sư hạ tầng đã hoặc đang cân nhắc stack quan sát dựa trên Qdrant/SQLite.
- Lưu ý: skill giả định kiến trúc riêng của repo (
core.runtime.AgentSession,memory.taishige) nên cần chính codebase đó để chạy nguyên bản.
Ví dụ sử dụng
- Chạy
python skills/provenance/scripts/run_provenance.py→ sinhtrace.jsonlvàtrace_summary.jsontrongexamples/snse_survey/provenance/. - Truy vấn theo một
trace_idđể tìm bước nào làm sai kết quả và chọn điểm rollback. - Mô phỏng Qdrant gặp sự cố để kiểm tra sự kiện có được cache vào SQLite và bù ghi khi phục hồi.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/anbeime/skill/HEAD/antinet-agentteams/skills/provenance/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục antinet-agentteams/skills/provenance từ repo GitHub anbeime/skill vào ~/.claude/skills/provenance/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/anbeime/skill.git && mkdir -p ~/.claude/skills && cp -r skill/antinet-agentteams/skills/provenance ~/.claude/skills/provenance⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và chuyển vào thư mục làm việc bạn muốn.
- Clone repo:
git clone https://github.com/anbeime/skill.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r skill/antinet-agentteams/skills/provenance ~/.claude/skills/provenance - Muốn chạy script thật, vào gốc repo (
skill/antinet-agentteams) và chạypython skills/provenance/scripts/run_provenance.pyđể kiểm tra sản phẩm đầu ra. - Nếu dùng tìm kiếm vector, cài sẵn Qdrant (kết nối qua MCP), Python 3 và SQLite.
- Khởi động lại Claude Code rồi yêu cầu: "dùng skill provenance để ghi lại chuỗi sự kiện thực thi".