Agent Skill Collections

Kho này là bộ sưu tập Agent Skill dành cho CodeX trong phạm vi repository hiện tại. Mục tiêu của repo là gom các skill quản trị, coding workflow, vận hành, phát hành, UI, và tài liệu hóa theo một cấu trúc gọn để CodeX có thể nạp đúng ngữ cảnh khi cần, thay vì nhồi toàn bộ quy tắc vào từng phiên làm việc.

Cấu trúc lưu skill cho CodeX

Theo cơ chế quét của Codex, skill cấp repository nên được đặt tại:

• .agents/skills

Khi chạy Codex trong repo, hệ thống sẽ quét thư mục .agents/skills từ thư mục làm việc hiện tại đi ngược lên tới root của repository. Điều này giúp:

• skill của repo đi cùng codebase
• các module dùng chung trong repo có thể dùng lại cùng một bộ skill
• giảm việc phải cài tay từng skill ở phạm vi user hoặc máy

Ngoài repository scope, Codex còn có thể đọc skill từ các scope khác:

• USER: skill cá nhân của người dùng
• ADMIN: skill cài ở mức máy / môi trường dùng chung
• SYSTEM: skill mặc định đi kèm Codex

Repo này hiện tập trung vào repository-scoped skills cho CodeX.

Bộ skill hiện có

Các skill hiện đang được lưu tại .agents/skills:

1. ai-driven-logging-strategy Chẩn đoán lỗi runtime bằng log có cấu trúc, trích xuất log lỗi theo phạm vi nhỏ để tránh tràn context.
2. checklist-driven-workflow Dùng Checklist.md để giữ trạng thái công việc, điều hướng task, và chặn đóng task khi quality gate chưa đạt.
3. config-env-manager Tách bạch secrets và config, quản lý .env, config JSON, và tương thích PyInstaller.
4. data-persistence-governance Quản trị schema, migration, entity registry, và tính tương thích dữ liệu.
5. dependency-bootstrap-workflow Chuẩn hóa Python environment, requirements.txt, venv, và run.bat.
6. module-dependency-map Kiểm soát phụ thuộc module, đánh giá impact, phát hiện vòng lặp phụ thuộc, và giữ dependency-rules.
7. project-evolution-ledger Ghi lại tiến độ và giá trị thay đổi cho stakeholder bằng tiếng Việt.
8. project-strategic Hub chiến lược: vision, mode, module schema, stack, và các luật điều phối cấp cao.
9. release-pipeline-governance Quản trị tăng version, build .exe, đóng gói installer, và publish release qua LAN.
10. telegram-markdown-v2 Chuẩn hóa nội dung gửi Telegram Bot API theo MarkdownV2.
11. testing-and-quality-governance Bắt buộc quality gate cho logic lõi, test regression, lint/typing/test orchestration.
12. ui-style-harvest Quét và chuẩn hóa style hiện có của dự án thành ui/ui-registry.json.
13. ui-style-apply Áp dụng ui/ui-registry.json vào code UI mới/chỉnh sửa và kiểm tra lệch chuẩn tự động.
14. revit2022-enterprise-refactor-strategic Biến thể chiến lược chuyên cho refactor dự án Revit API 2022 quy mô lớn, khóa ràng buộc nền tảng, chia pha refactor, và bắt buộc mốc xác minh thủ công.
15. revit2022-wpf-dependency-map Biến thể dependency map chuyên cho Revit API 2022 với WPF MVVM, giữ boundary Revit/UI/Data-Sync, chặn edge nguy hiểm, và chuẩn hóa policies/dependency-rules.md.
16. revit2022-manual-build-gate Biến thể quality gate thủ công cho Revit API 2022, chuẩn hóa handoff build/test, checkpoint quan sát, trạng thái xác minh, và giới hạn output cần gửi lại cho AI Agent.
17. revit2022-diagnostics-and-handoff Biến thể diagnostics chuyên cho Revit API 2022, audit module debug hiện có, phân loại mức trưởng thành bắt lỗi, và hướng dẫn nâng cấp thành boundary bắt lỗi an toàn theo checkpoint.
18. revit2022-refactor-checklist-workflow Biến thể checklist workflow cho chiến dịch refactor Revit API 2022 kéo dài nhiều phiên, giữ Task ID theo layer Revit, thêm trạng thái chờ xác minh thủ công, và quản lý archive cho checklist lớn.
19. revit2022-solution-discovery Biến thể discovery an toàn cho Revit API 2022, đọc theo governance order, tránh quét mù toàn bộ solution, và tạo minimal solution map trước khi chuyển sang lập kế hoạch hay refactor.
20. revit2022-refactor-planner Biến thể planner cho Revit API 2022, chuyển discovery note thành kế hoạch refactor incremental, có đánh giá rủi ro, kiểm tra compliance, và checkpoint xác minh thủ công trước khi viết code.
21. revit2022-static-analysis-and-metrics Biến thể static analysis cho Revit API 2022, đo baseline metrics và phát hiện code smell chỉ trong phạm vi plan đã duyệt, từ đó quyết định có nên sang test design hay quay lại chỉnh planner.
22. revit2022-characterization-test-design Biến thể thiết kế characterization cho Revit API 2022, hỗ trợ cả test thực thi và behavior-lock spec để khóa hành vi cũ trước khi refactor mà không giả vờ pass khi thiếu bằng chứng chạy thật.
23. revit2022-safe-edit-governor Biến thể execution gate cho Revit API 2022, chỉ cho phép sửa một step mỗi lần gọi, kiểm tra lại behavior lock ngay sau edit, và chặn tiếp tục nếu vi phạm boundary hoặc chưa có bằng chứng xác minh phù hợp.
24. revit2022-data-sync-governance Biến thể chuyên cho DATA-SYNC trong Revit API 2022, buộc AI Agent tự khám phá luồng sync từ code trước, khóa rủi ro source-of-truth/thread/conflict, và chỉ hỏi lại người dùng các policy không thể suy ra chắc chắn.
25. revit2022-architecture-ledger Biến thể ADR-lite cho Revit API 2022, ghi lại các quyết định kiến trúc dài hạn, Approved Deviation, và các rule bền vững để những phiên sau không phải tranh luận lại từ đầu hoặc làm phình Project-Strategic.md.
26. revit2022-pack-router Meta-skill điều phối đầu phiên cho pack Revit 2022, dùng để chọn đúng gate đầu tiên, giải quyết overlap trigger giữa các skill, và giữ route ở mức tối thiểu thay vì nạp cả pack cùng lúc.

Cách CodeX dùng bộ skill này

CodeX không cần nạp toàn bộ nội dung của tất cả skill trong mỗi phiên. Luồng sử dụng đúng là:

1. Đọc metadata (name, description) để xác định skill nào phù hợp.
2. Chỉ khi skill được kích hoạt, mới đọc SKILL.md của skill đó.
3. Chỉ khi cần thêm chi tiết, mới dùng tiếp scripts/, assets/, hoặc references/.

Thiết kế này giúp:

• tiết kiệm token
• giảm tràn ngữ cảnh
• tập trung nhiều hơn vào code thật
• chỉ gọi đúng workflow khi task thật sự cần

Quy ước hiện tại

• Skill cho CodeX của repo nằm trong .agents/skills
• Mỗi skill có SKILL.md là lõi bắt buộc
• Có thể kèm:
  • agents/openai.yaml
  • scripts/
  • assets/
  • references/

Chỗ chờ mở rộng

Phần này sẽ được bổ sung sau:

• Biến thể tương ứng của các skill hiện có dành cho ClaudeCode

Hiện tại repo này mới tập trung vào bộ skill dành cho CodeX.