ai-developer-skill-os 7.5.1 → 8.1.5

package/.agents/registry/skills-index.yml

@@ -0,0 +1,525 @@
+# registry/skills-index.yml
+# GENERATED FILE — DO NOT EDIT MANUALLY
+version: 8.1.1
+generated_at: '2026-07-23T06:25:44.553Z'
+total_skills: 30
+skills:
+  - name: qk-access-policy
+    version: 8.0.0
+    status: stable
+    description: >-
+      Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware
+      sau.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - cấu hình rbac
+      - phân quyền
+      - bảo mật api
+      - auth middleware
+    intent:
+      - access-control
+      - security-policy
+  - name: qk-agent-observability
+    version: 8.1.3
+    status: experimental
+    description: >-
+      Agent Observability layer for tracking decisions, routing metrics, and
+      failure patterns.
+    complexity: medium
+    workflow: skill-evolution
+    triggers:
+      - agent observability
+      - routing logs
+      - skill failure
+    intent:
+      - observability
+      - agent-metrics
+      - decision-trace
+  - name: qk-ai-builder
+    version: 8.0.0
+    status: stable
+    description: >-
+      Thiết kế AI logic, Prompts, RAG pipelines với bảo mật chống Injection —
+      structured output bắt buộc.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - build ai
+      - viết prompt
+      - thiết kế bot
+      - ai logic
+      - tạo skill
+    intent:
+      - ai-integration
+      - agent-behavior
+  - name: qk-api-lifecycle
+    version: 8.0.0
+    status: stable
+    description: >-
+      Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code
+      sau.
+    complexity: medium
+    workflow: feature-delivery
+    triggers:
+      - viết api
+      - tạo endpoint
+      - build api
+      - thiết kế api
+    intent:
+      - api-design
+      - backend-development
+  - name: qk-bug-resolution
+    version: 8.0.0
+    status: stable
+    description: >-
+      Sửa lỗi (bugs) bằng chu trình khép kín: Quan sát → Giả thuyết → Bằng chứng
+      → Sửa.
+    complexity: medium
+    workflow: bug-resolution
+    triggers:
+      - fix bug
+      - sửa lỗi
+      - crash
+      - error
+      - not working
+    intent:
+      - bug-fixing
+      - debugging
+      - error-resolution
+  - name: qk-context-loader
+    version: 8.0.0
+    status: stable
+    description: >-
+      Tải context và vẽ dependency graph chính xác trước khi code — ngăn
+      hallucination kiến trúc.
+    complexity: low
+    workflow: research
+    triggers:
+      - load context
+      - understand project
+      - analyze architecture
+      - vẽ dependency graph
+      - build context
+    intent:
+      - context-loading
+      - project-understanding
+      - repository-analysis
+  - name: qk-data-lifecycle
+    version: 8.0.0
+    status: stable
+    description: >-
+      Quản lý Schema, Migrations an toàn — schema freeze → backward-compat
+      migration → cleanup.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - sửa schema
+      - cập nhật database
+      - tạo migration
+      - đổi model
+    intent:
+      - schema-management
+      - database-migration
+  - name: qk-db-optimizer
+    version: 8.0.0
+    status: stable
+    description: >-
+      Tối ưu Database dựa trên bằng chứng: EXPLAIN → phân tích → index/join —
+      không đoán mò.
+    complexity: high
+    workflow: refactor
+    triggers:
+      - tối ưu query
+      - query chậm
+      - optimize db
+      - thêm index
+    intent:
+      - database-optimization
+      - performance-tuning
+  - name: qk-design-system-engineering
+    version: 8.1.0
+    status: experimental
+    description: >-
+      Governance cho Design System (Định nghĩa system rules, tokens, component
+      variants).
+    complexity: medium
+    workflow: feature-delivery
+    triggers:
+      - định nghĩa design system
+      - cấu trúc token
+      - quy chuẩn ui
+      - variants
+    intent:
+      - design-system
+      - tokens
+      - component-library
+      - accessibility
+  - name: qk-devops-platform
+    version: 8.1.1
+    status: experimental
+    description: >-
+      Platform engineering: CI/CD strategy, deployment architecture, environment
+      management, and rollback strategy.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - cấu hình ci/cd
+      - deployment strategy
+      - quản lý môi trường
+      - devops platform
+      - dockerize
+    intent:
+      - devops-strategy
+      - cicd-pipeline
+      - deployment-architecture
+      - environment-management
+  - name: qk-docs
+    version: 8.0.0
+    status: stable
+    description: >-
+      Viết và duy trì tài liệu chính xác tuyệt đối — phải match code thực tế,
+      cấm bịa đặt.
+    complexity: low
+    workflow: documentation
+    triggers:
+      - viết docs
+      - viết tài liệu
+      - document this
+      - generate docs
+      - cập nhật readme
+    intent:
+      - documentation
+      - technical-writing
+  - name: qk-engineering-standard
+    version: 8.0.0
+    status: stable
+    description: >-
+      Ép buộc SOLID, DRY, Clean Code với ngưỡng số liệu cụ thể — không có rule
+      mơ hồ.
+    complexity: medium
+    workflow: code-review
+    triggers:
+      - review code
+      - clean code
+      - check standard
+      - refactor clean
+      - kiểm tra chuẩn
+    intent:
+      - code-quality
+      - standards-enforcement
+  - name: qk-fe-api-integration
+    version: 8.0.0
+    status: stable
+    description: >-
+      Consume API Backend, quản lý State, bind vào UI — tuân thủ kiến trúc Base
+      dự án
+    complexity: medium
+    workflow: feature-delivery
+    triggers:
+      - tích hợp api
+      - gọi api
+      - fetch data
+      - consume api
+    intent:
+      - api-integration
+      - frontend-development
+  - name: qk-feature-delivery
+    version: 8.0.0
+    status: stable
+    description: >-
+      Phát triển tính năng mới end-to-end: Requirements → Context → Design →
+      Implement → Self-audit.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - add feature
+      - build new
+      - implement
+      - phát triển tính năng
+      - tạo mới
+    intent:
+      - feature-building
+      - end-to-end-development
+      - implementation
+  - name: qk-frontend-architecture
+    version: 8.1.0
+    status: experimental
+    description: >-
+      Frontend architecture decision engine (Component strategy, state
+      management, routing).
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - cấu trúc frontend
+      - thiết kế component
+      - quản lý state
+      - kiến trúc react
+    intent:
+      - frontend-architecture
+      - component-strategy
+      - state-management
+  - name: qk-help
+    version: 8.0.0
+    status: deprecated
+    description: Hiển thị danh sách skills V8 và hướng dẫn dùng lệnh ./qk-[skill-name].
+    complexity: low
+    workflow: internal
+    triggers:
+      - help
+      - có những skill nào
+      - danh sách skill
+      - làm sao để dùng
+      - qk-help
+    intent:
+      - skill-discovery
+      - command-help
+  - name: qk-orchestrator
+    version: 8.0.0
+    status: stable
+    description: >-
+      Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — kiểm
+      tra preconditions và routing table.
+    complexity: low
+    workflow: research
+    triggers:
+      - which skill
+      - what should i use
+      - route this
+      - help me choose
+      - what skill for
+      - help
+      - list skills
+      - what can you do
+    intent:
+      - task-routing
+      - skill-selection
+      - precondition-checking
+  - name: qk-product-specification
+    version: 8.1.0
+    status: experimental
+    description: >-
+      Product thinking (Idea → Requirement → Acceptance criteria → Technical
+      spec).
+    complexity: medium
+    workflow: spec-driven-development
+    triggers:
+      - viết spec
+      - phân tích yêu cầu
+      - ý tưởng sản phẩm
+      - acceptance criteria
+    intent:
+      - product-specification
+      - requirement-analysis
+      - acceptance-criteria
+      - technical-spec
+  - name: qk-production-release
+    version: 8.0.0
+    status: stable
+    description: >-
+      Chuẩn bị release production với 8-gate checklist bắt buộc — không pass
+      gate = không deploy.
+    complexity: high
+    workflow: internal
+    triggers:
+      - release production
+      - deploy production
+      - chuẩn bị release
+      - kiểm tra release
+    intent:
+      - release-management
+      - production-deployment
+  - name: qk-project-bootstrap
+    version: 8.0.0
+    status: stable
+    description: >-
+      Khởi tạo dự án mới với cấu trúc chuẩn, linters, DESIGN.md — không bao giờ
+      thiếu foundation.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - khởi tạo project
+      - tạo dự án mới
+      - bootstrap
+      - setup project
+      - init repo
+    intent:
+      - project-initialization
+      - setup
+  - name: qk-project-health
+    version: 8.0.0
+    status: stable
+    description: >-
+      Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score
+      0–100 với actionable roadmap.
+    complexity: high
+    workflow: code-review
+    triggers:
+      - audit code
+      - check health
+      - tech debt
+      - code smell
+      - kiểm toán
+    intent:
+      - project-audit
+      - codebase-health
+  - name: qk-project-memory
+    version: 8.0.0
+    status: stable
+    description: >-
+      Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh,
+      không lưu giả thuyết.
+    complexity: medium
+    workflow: documentation
+    triggers:
+      - lưu context
+      - nhớ lại
+      - project memory
+      - lưu vào bộ nhớ
+      - tìm lại fact
+    intent:
+      - context-management
+      - knowledge-retrieval
+  - name: qk-security-audit
+    version: 8.1.0
+    status: experimental
+    description: >-
+      Security audit (OWASP, dependency security, secret detection, permission
+      model).
+    complexity: high
+    workflow: security-audit
+    triggers:
+      - kiểm tra bảo mật
+      - scan lỗ hổng
+      - audit code
+      - tìm secret leak
+    intent:
+      - security-audit
+      - vulnerability-scan
+      - secret-detection
+      - permission-review
+  - name: qk-system-evolution
+    version: 8.0.0
+    status: stable
+    description: >-
+      Nâng cấp thư viện/framework an toàn với rollback plan bắt buộc —
+      incremental, không big-bang.
+    complexity: high
+    workflow: refactor
+    triggers:
+      - upgrade package
+      - nâng cấp
+      - update framework
+      - migration framework
+      - system evolution
+    intent:
+      - framework-upgrade
+      - system-maintenance
+  - name: qk-test-engineering
+    version: 8.1.0
+    status: experimental
+    description: >-
+      Testing strategy decision engine (Unit, Integration, E2E, Coverage,
+      Regression, Mock strategy).
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - chiến lược test
+      - viết test
+      - mock data
+      - test coverage
+    intent:
+      - testing-strategy
+      - unit-test
+      - integration-test
+      - e2e-test
+      - mock-strategy
+      - test-coverage
+  - name: qk-ui-audit
+    version: 8.0.0
+    status: stable
+    description: >-
+      Kiểm toán giao diện (UI) với 57-point Anti-Slop checklist — fail nếu score
+      < 90/100.
+    complexity: medium
+    workflow: code-review
+    triggers:
+      - audit ui
+      - check ui
+      - kiểm tra giao diện
+      - ui slop
+      - review ui
+    intent:
+      - ui-audit
+      - codebase-health
+  - name: qk-ui-builder
+    version: 8.0.0
+    status: stable
+    description: >-
+      Xây dựng, sửa, audit, và học UI — từ Figma/ảnh, map API, fix bug UI, đến
+      redesign cấu trúc.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - build ui
+      - làm giao diện
+      - design ui
+      - css
+      - giao diện
+    intent:
+      - ui-development
+      - frontend-design
+  - name: qk-ui-system-builder
+    version: 8.0.0
+    status: stable
+    description: >-
+      Xây dựng Design System và token library từ DESIGN.md — không tự đặt ra
+      token ngoài contract.
+    complexity: medium
+    workflow: feature-delivery
+    triggers:
+      - tạo design system
+      - build token
+      - ui system
+      - setup css
+    intent:
+      - ui-system-design
+      - frontend-development
+  - name: qk-validation-gate
+    version: 8.0.0
+    status: stable
+    description: >-
+      Cổng kiểm tra chất lượng bắt buộc với ngưỡng pass/fail cụ thể — chặn đứng
+      mọi mã nguồn lỗi.
+    complexity: low
+    workflow: code-review
+    triggers:
+      - verify
+      - kiểm tra
+      - lint
+      - test
+      - run checks
+    intent:
+      - quality-assurance
+      - verification
+      - code-review
+  - name: qk-web-quality-gate
+    version: 8.1.0
+    status: experimental
+    description: >-
+      Kiểm toán tổng thể chất lượng Web: Accessibility (A11y), SEO, Web
+      Performance, Security, UX Heuristics.
+    complexity: high
+    workflow: feature-delivery
+    triggers:
+      - kiểm tra web
+      - tối ưu web
+      - lighthouse
+      - audit ui
+      - core web vitals
+    intent:
+      - web-performance
+      - accessibility
+      - seo
+      - lighthouse
+      - ux-audit

package/.agents/reports/RELEASE-CHECKLIST.md

@@ -0,0 +1,29 @@
+# V8.1.3 Production Freeze Checklist
+
+## Skills
+[x] 30 skills validated
+[x] Missing `delegates_to` allowed for implementation skills
+
+## Graph
+[x] No orphan nodes
+[x] No cycles
+[x] Hub risk evaluated
+
+## Workflow
+[x] All skills mapped to workflows
+
+## Rules
+[x] Priority matrix exists (`priorities.yml`)
+[x] Strict constraint applied
+
+## Evaluation
+[x] 18 cases passed
+[x] Boundary Attack handled correctly
+[x] Ambiguous intent detected
+[x] Adversarial intent rejected
+
+## Registry
+[x] Generated successfully
+
+**Status:**
+APPROVED

package/.agents/reports/architecture-audit.md

@@ -0,0 +1,13 @@
+# Architecture & Workflow Audit
+
+## Workflows Found: 10
+- bug-resolution.yml
+- code-review.yml
+- documentation.yml
+- feature-delivery.yml
+- refactor.yml
+- research.yml
+- security-audit.yml
+- skill-evolution.yml
+- spec-driven-development.yml
+- _schema.yml

package/.agents/reports/graph-health.md

@@ -0,0 +1,20 @@
+# Graph Health Report
+
+## Hub Risk Analysis
+
+## Conflict Matrix
+- **qk-design-system-engineering** conflicts **qk-ui-system-builder**
+  - Reason: Semantic overlap
+  - Severity: High
+  - Resolution: Context loader intervention required
+
+- **qk-devops-platform** conflicts **qk-production-release**
+  - Reason: Semantic overlap
+  - Severity: High
+  - Resolution: Context loader intervention required
+
+- **qk-frontend-architecture** conflicts **qk-ui-builder**
+  - Reason: Semantic overlap
+  - Severity: High
+  - Resolution: Context loader intervention required
+