ai-developer-skill-os 7.5.1 → 8.1.4

package/skills/qk-help/SKILL.md

@@ -1,194 +0,0 @@
----
-name: qk-help
-category: utilities
-version: 7.5.1
-description: "Hiển thị danh sách skills V7.5 và hướng dẫn dùng lệnh ./qk-[skill-name]."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
-
-cost: low
-latency: fast
-risk: low
-side_effects: none
-produces: [report]
-consumes: [none]
-
-token_budget:
-  max_files_read: 0
-  max_lines_per_read: 0
-  max_shell_commands: 0
-  stop_early: true
-
-exit_codes: [SUCCESS]
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-# qk-help — Skill Directory V7.5
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-When triggered, display this reference and exit with SUCCESS.
-
----
-
-## Scope
-- ✅ Display available skills and their purposes
-- ✅ Show common pipelines and best practices
-- ✅ Provide quick reference for skill commands
-
-## Non-Goals
-- ❌ Execute any skill — only display information
-- ❌ Modify project files or configuration
-- ❌ Answer questions outside the skill system
-
----
-
-## Preconditions
-- [ ] User requests help or list of skills
-
-```
-On missing precondition:
-  EXIT: BLOCKED
-  Message: "Vui lòng hỏi trợ giúp hoặc liệt kê skills."
-```
-
----
-
-## Scope
-- ✅ Display available skills and their purposes
-- ✅ Show common pipelines and best practices
-- ✅ Provide quick reference for skill commands
-
-## Non-Goals
-- ❌ Execute any skill — only display information
-- ❌ Modify project files or configuration
-- ❌ Answer questions outside the skill system
-
----
-
-## Priority Order
-
-| Priority | Task | Skip Threshold |
-|----------|------|----------------|
-| P1 | List all available skills | Never |
-| P2 | Show common pipelines | Never |
-| P3 | Provide usage examples | Never |
-
----
-
-## Workflow
-
-### Phase 1 — Display Skills
-
-**Steps:**
-1. Read `skills.json` to get active skill list
-2. Format as table: Command | Purpose | Cost
-3. Display common pipelines
-
-**Exit When:**
-- Help displayed → EXIT: SUCCESS
-
----
-
-## Confidence Model
-
-| Level | Condition | Action |
-|-------|-----------|--------|
-| HIGH | skills.json readable | Display directly |
-| MEDIUM | skills.json partially readable | Display what's available |
-| LOW | Cannot access skills.json | EXIT: BLOCKED |
-
----
-
-## Severity
-
-| Level | Definition | Example |
-|-------|-----------|---------|
-| CRITICAL | N/A — this skill is read-only | — |
-| HIGH | N/A — this skill is read-only | — |
-| MEDIUM | N/A — this skill is read-only | — |
-| LOW | N/A — this skill is read-only | — |
-
----
-
-## Evidence Format
-
-```
-[INFO] qk-help
-Message: [help content displayed]
-Confidence: HIGH
-```
-
----
-
-## Retry Policy
-
-```
-Display fails
-  └─ Check if skills.json is accessible
-       ├─ Accessible → retry display
-       └─ Not accessible → EXIT: BLOCKED
-```
-
----
-
-## Escalation Rules
-
-```
-BLOCKED: Cannot access skills.json
-Missing:
-  - skills.json file
-Questions:
-  1. Bạn cần hỗ trợ gì? (liệt kê skills / hướng dẫn dùng)
-```
-
----
-
-## Handoff Contract
-
-### Consumes
-```json
-{
-  "from": "user",
-  "required_fields": ["help_request"],
-  "optional_fields": ["specific_skill"]
-}
-```
-
-### Produces
-```json
-{
-  "to": "user",
-  "output_fields": ["skill_list", "pipelines", "usage_examples"],
-  "exit_code": "SUCCESS"
-}
-```
-
----
-
-## Output Format
-
-```
-📚 Help — Available Skills
-─────────────────────────────────────────────────
-[table of skills]
-
-Common Pipelines:
-[common workflows]
-
-Exit Code: SUCCESS
-```
-
----
-
-## Exit Codes
-
-| Code | Meaning | When |
-|------|---------|------|
-| SUCCESS | Help displayed successfully | Normal completion |
-| BLOCKED | Cannot access skills.json | Setup required |
-
----
-

package/skills/qk-orchestrator/SKILL.md

@@ -1,279 +0,0 @@
----
-name: qk-orchestrator
-category: core
-version: 7.5.1
-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."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
-
-cost: low
-latency: fast
-risk: low
-side_effects: none
-produces: [plan]
-consumes: [user-request]
-
-token_budget:
-  max_files_read: 1
-  max_lines_per_read: 50
-  max_shell_commands: 0
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-# qk-orchestrator — Request Routing
-
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Preconditions
-- [ ] User request is provided (any language)
-
-```
-On missing precondition:
-  EXIT: BLOCKED
-  Message: "Vui lòng mô tả yêu cầu của bạn."
-```
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Scope
-- ✅ Analyze user intent and route to the correct skill
-- ✅ Verify preconditions of target skill BEFORE delegating
-- ✅ Enforce sequential pipeline when skills depend on each other
-
-## Non-Goals
-- ❌ Write code directly — delegate to specialist skills
-- ❌ Hallucinate non-existent skills
-- ❌ Allow UI work without `DESIGN.md` verified
-- ❌ Allow logic work without context graph from `qk-context-loader`
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Priority Order
-
-| Priority | Check | Skip Threshold |
-|----------|-------|----------------|
-| P1 | Match intent to routing table | Never |
-| P2 | Verify target skill preconditions | Never |
-| P3 | Check pipeline dependencies (e.g., context-loader first) | Never for logic tasks |
-| P4 | Estimate cost/latency for user info | Budget < 70% |
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Workflow
-
-### Phase 1 — Intent Classification
-
-**Steps:**
-1. Parse user request → extract intent keywords
-2. Match against routing table (see `references/routing-table.md`)
-3. Resolve to primary skill + pipeline order
-
-**Decision:**
-```
-IF single clear match found
-  → Confidence: HIGH → go to Phase 2
-
-ELSE IF 2–3 possible matches
-  → Pick highest-priority match
-  → Confidence: MEDIUM → go to Phase 2, note ambiguity
-
-ELSE IF no match
-  → EXIT: BLOCKED — ask clarifying question
-```
-
-**Exit When:**
-- Skill identified → go to Phase 2
-- No matching skill → EXIT: BLOCKED
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-### Phase 2 — Precondition Check
-
-**Steps:**
-1. Read target skill's `Preconditions` section
-2. Verify each precondition against current context
-
-**Decision:**
-```
-IF all preconditions met
-  → go to Phase 3
-
-ELSE IF missing precondition is resolvable
-  → Resolve it first (e.g., run qk-context-loader, find DESIGN.md)
-  → Then go to Phase 3
-
-ELSE
-  → EXIT: BLOCKED
-```
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-### Phase 3 — Pipeline Enforcement
-
-**Steps:**
-1. Check if target skill `consumes` output from another skill
-2. If yes → ensure that upstream skill has run first
-3. Delegate to target skill with full context
-
-**Pipeline Rules:**
-```
-UI tasks:
-  [DESIGN.md check] → [qk-ui-audit (optional)] → [qk-ui-builder | qk-feature-delivery]
-
-Logic tasks:
-  [qk-context-loader] → [qk-feature-delivery | qk-bug-resolution | qk-api-lifecycle]
-
-Data tasks:
-  [qk-context-loader] → [qk-data-lifecycle | qk-db-optimizer]
-
-Release tasks:
-  [qk-validation-gate] → [qk-production-release]
-```
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Routing Table (Quick Reference)
-Full table: see `references/routing-table.md`
-
-| Intent Keywords | Primary Skill | Pipeline |
-|----------------|---------------|----------|
-| bug, lỗi, error, broken, crash, fix, sửa | `qk-bug-resolution` | direct |
-| tính năng, feature, thêm, mới, add, implement | `qk-feature-delivery` | context-loader first |
-| UI, giao diện, design, component, layout, màn hình | `qk-ui-builder` | DESIGN.md check |
-| slow, query, index, N+1, performance DB | `qk-db-optimizer` | context-loader first |
-| deploy, release, production, CI/CD, build | `qk-production-release` | validation-gate first |
-| schema, migration, database, table, model | `qk-data-lifecycle` | context-loader first |
-| refactor, clean, SOLID, DRY, code quality | `qk-engineering-standard` | direct |
-| test, lint, validate, check quality | `qk-validation-gate` | direct |
-| upgrade, update thư viện, migrate library | `qk-system-evolution` | direct |
-| docs, documentation, README, comment | `qk-docs` | direct |
-| API, endpoint, route, contract | `qk-api-lifecycle` | context-loader first |
-| access, role, permission, RBAC, auth | `qk-access-policy` | direct |
-| AI, prompt, RAG, LLM, embedding | `qk-ai-builder` | direct |
-| design system, token, CSS variable | `qk-ui-system-builder` | DESIGN.md check |
-| project audit, health, tech debt | `qk-project-health` | direct |
-| new project, bootstrap, init | `qk-project-bootstrap` | direct |
-| memory, context, recall, lưu | `qk-project-memory` | direct |
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Confidence Model
-
-| Level | Condition | Action |
-|-------|-----------|--------|
-| HIGH | Single clear keyword match | Route directly |
-| MEDIUM | Multiple possible skills | Route to most likely, note ambiguity |
-| LOW | Request is too vague | Ask clarifying question |
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Escalation Rules
-
-```
-BLOCKED: Cannot determine correct skill
-Missing:
-  - More specific description of the task
-Questions:
-  1. Bạn muốn làm gì? (fix bug / thêm tính năng / tối ưu / deploy)
-  2. File hoặc module nào bị ảnh hưởng?
-Recommended Assumptions: none — routing requires clear intent
-```
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Handoff Contract
-
-### Consumes
-```json
-{
-  "from": "user",
-  "required_fields": ["request_text"],
-  "optional_fields": ["affected_file", "context"]
-}
-```
-
-### Produces
-```json
-{
-  "to": "[target-skill]",
-  "output_fields": ["routed_skill", "pipeline_order", "preconditions_verified", "exit_code"]
-}
-```
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Output Format
-
-```
-🧭 Orchestrator Routing
-─────────────────────────────────────────────────
-Intent:      [Classified intent]
-Skill:       [qk-skill-name]
-Pipeline:    [skill-a → skill-b → skill-c]
-Confidence:  [HIGH | MEDIUM | LOW]
-
-Preconditions:
-  ✅ [Condition met]
-  ✅ [Condition met]
-
-Exit Code:   SUCCESS
-```
-
-skill_version: 7.5.1
-runtime_version: 1
-schema_version: 2
----
-
-## Exit Codes
-
-| Code | Meaning | When |
-|------|---------|------|
-| SUCCESS | Skill routed, preconditions verified, delegation in progress | Normal flow |
-| PARTIAL | Routed with MEDIUM confidence — ambiguity noted | Multi-match situation |
-| BLOCKED | Cannot classify intent or precondition missing | Vague request or missing DESIGN.md |
-| FAILED | No skill matches and cannot escalate | Unknown domain request |
-
----
-
-
-

package/skills/qk-orchestrator/references/routing-table.md

@@ -1,78 +0,0 @@
-# Routing Table — qk-orchestrator V7.5
-
-> Full intent → skill mapping. Updated whenever a new skill is added.
-
----
-
-## Primary Routes
-
-| Intent Keywords (Vietnamese + English) | Primary Skill | Pipeline Required |
-|----------------------------------------|---------------|-------------------|
-| bug, lỗi, error, broken, crash, fix, sửa, không hoạt động | `qk-bug-resolution` | direct |
-| tính năng, feature, thêm, mới, add, implement, xây dựng | `qk-feature-delivery` | `qk-context-loader` first |
-| UI, giao diện, design, component, layout, màn hình, hiển thị | `qk-ui-builder` | DESIGN.md check |
-| slow, chậm, query, index, N+1, performance DB, tối ưu DB | `qk-db-optimizer` | `qk-context-loader` first |
-| deploy, release, production, CI/CD, build, xuất bản | `qk-production-release` | `qk-validation-gate` first |
-| schema, migration, database, table, model, ORM | `qk-data-lifecycle` | `qk-context-loader` first |
-| refactor, clean, SOLID, DRY, code quality, tái cấu trúc | `qk-engineering-standard` | direct |
-| test, lint, validate, check quality, kiểm tra | `qk-validation-gate` | direct |
-| upgrade, update thư viện, migrate library, nâng version | `qk-system-evolution` | direct |
-| docs, documentation, README, comment, tài liệu | `qk-docs` | direct |
-| API, endpoint, route, contract, swagger | `qk-api-lifecycle` | `qk-context-loader` first |
-| access, role, permission, RBAC, phân quyền | `qk-access-policy` | direct |
-| AI, prompt, RAG, LLM, embedding, pipeline AI | `qk-ai-builder` | direct |
-| design system, token, CSS variable, design tokens | `qk-ui-system-builder` | DESIGN.md check |
-| project audit, health, tech debt, kiểm toán dự án | `qk-project-health` | direct |
-| new project, bootstrap, init, khởi tạo dự án | `qk-project-bootstrap` | direct |
-| memory, context, recall, lưu ngữ cảnh | `qk-project-memory` | direct |
-| security, policy, authorization, bảo mật | `qk-policy-engine` | → redirect to `qk-access-policy` |
-| help, danh sách, list skills, hướng dẫn | `qk-help` | direct |
-| consume API, tích hợp API backend, gọi API từ FE | `qk-fe-api-integration` | `qk-context-loader` first |
-| UI audit, kiểm tra giao diện, anti-slop check | `qk-ui-audit` | DESIGN.md check |
-
----
-
-## Pipeline Templates
-
-### UI Pipeline
-```
-1. Check DESIGN.md exists (qk-project-bootstrap if missing)
-2. [Optional] qk-ui-audit — audit existing UI
-3. qk-ui-builder OR qk-feature-delivery (UI part)
-4. qk-validation-gate — lint + type check
-```
-
-### Logic/Feature Pipeline
-```
-1. qk-context-loader — build dependency graph
-2. qk-feature-delivery — implement
-3. qk-validation-gate — test + lint
-4. [Optional] qk-production-release
-```
-
-### Database Pipeline
-```
-1. qk-context-loader — map schema dependencies
-2. qk-data-lifecycle (schema) OR qk-db-optimizer (performance)
-3. qk-validation-gate — run migration tests
-```
-
-### Release Pipeline
-```
-1. qk-validation-gate — full test suite
-2. qk-production-release — build + security gate
-```
-
----
-
-## Ambiguity Resolution
-
-When 2+ skills match:
-
-| Situation | Resolution |
-|-----------|------------|
-| "fix" + UI component | `qk-bug-resolution` (fix takes priority over design) |
-| "refactor" + API | `qk-engineering-standard` if code quality focus, `qk-api-lifecycle` if contract change |
-| "add feature" + DB | Route `qk-feature-delivery` with `qk-data-lifecycle` in pipeline |
-| "optimize" without context | Ask: "DB performance or code quality?" |
-