ai-developer-skill-os 7.0.2 → 7.5.0

package/patch.py

@@ -0,0 +1,89 @@
+import sys
+with open('bin/install.js', 'r', encoding='utf-8') as f:
+    content = f.read()
+
+# Fix kiloConfig bug
+content = content.replace(
+    "if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {",
+    "if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || Array.isArray(kiloConfig.skills) || !kiloConfig.skills.paths) {"
+)
+
+# Replace the interactive part with CLI parsing
+start_marker = "rl.question(questionIde, (ideChoice) => {"
+end_marker = "    } catch (error) {\n      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);\n    } finally {\n      rl.close();\n    }\n  });\n});"
+
+start_idx = content.find(start_marker)
+end_idx = content.find(end_marker) + len(end_marker)
+
+if start_idx != -1 and end_idx != -1:
+    replacement = """// Parse command line arguments for CI/CD automation
+const args = process.argv.slice(2);
+let autoIde = null;
+let autoScope = null;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith('--ide=')) {
+    autoIde = args[i].split('=')[1];
+  }
+  if (args[i].startsWith('--scope=')) {
+    autoScope = args[i].split('=')[1];
+  }
+}
+
+function runInstallation(ideChoice, scopeChoice) {
+    const isGlobal = scopeChoice === '1';
+"""
+
+    old_body = content[start_idx:end_idx]
+    
+    # Extract the body inside rl.question(questionScope...)
+    scope_start = "const isGlobal = scopeChoice === '1';"
+    scope_start_idx = old_body.find(scope_start)
+    scope_end = "    } catch (error) {"
+    scope_end_idx = old_body.find(scope_end)
+    
+    inner_body = old_body[scope_start_idx + len(scope_start):scope_end_idx]
+    
+    replacement += inner_body
+    replacement += """
+    } catch (error) {
+      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);
+    } finally {
+      rl.close();
+    }
+}
+
+if (autoIde && autoScope) {
+  console.log('\\n?? Running in non-interactive mode with IDE=' + autoIde + ', Scope=' + autoScope);
+  runInstallation(autoIde, autoScope);
+} else {
+  rl.question(questionIde, (ideChoice) => {
+    if (ideChoice === '0') {
+      console.log('? �� b? qua c?u h�nh t? d?ng. Skill OS v?n du?c t?i v?, b?n c� th? t? c?u h�nh file c?a IDE theo thu m?c hi?n t?i.');
+      rl.close();
+      return;
+    }
+
+    if (!['1', '2', '3', '4', '5', '6', '7'].includes(ideChoice)) {
+      console.log('? L?a ch?n kh�ng h?p l?. Vui l�ng ch?y l?i script.');
+      rl.close();
+      return;
+    }
+
+    rl.question(questionScope, (scopeChoice) => {
+      if (!['1', '2'].includes(scopeChoice)) {
+        console.log('? L?a ch?n kh�ng h?p l?. M?c d?nh s? c�i Global.');
+        scopeChoice = '1';
+      }
+      runInstallation(ideChoice, scopeChoice);
+    });
+  });
+}
+"""
+    content = content[:start_idx] + replacement + content[end_idx:]
+    
+    with open('bin/install.js', 'w', encoding='utf-8') as f:
+        f.write(content)
+    print("Python patch applied.")
+else:
+    print("Could not find markers.")

package/patch2.py

@@ -0,0 +1,83 @@
+import sys
+with open('bin/install.js', 'r', encoding='utf-8') as f:
+    content = f.read()
+
+# Fix kiloConfig bug
+content = content.replace(
+    "if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {",
+    "if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || Array.isArray(kiloConfig.skills) || !kiloConfig.skills.paths) {"
+)
+
+# Replace the interactive part with CLI parsing
+start_marker = "rl.question(questionIde, (answerIde) => {"
+end_marker = "    } catch (error) {\n      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);\n    } finally {\n      rl.close();\n    }\n  });\n});"
+
+start_idx = content.find(start_marker)
+end_idx = content.find(end_marker) + len(end_marker)
+
+if start_idx != -1 and end_idx != -1:
+    replacement = """// Parse command line arguments for CI/CD automation
+const args = process.argv.slice(2);
+let autoIde = null;
+let autoScope = null;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i].startsWith('--ide=')) {
+    autoIde = args[i].split('=')[1];
+  }
+  if (args[i].startsWith('--scope=')) {
+    autoScope = args[i].split('=')[1];
+  }
+}
+
+function runInstallation(answerIde, answerScope) {
+"""
+
+    old_body = content[start_idx:end_idx]
+    
+    # Extract the body inside rl.question(questionScope...)
+    scope_start = "rl.question(questionScope, (answerScope) => {"
+    scope_start_idx = old_body.find(scope_start) + len(scope_start)
+    scope_end = "    } catch (error) {"
+    scope_end_idx = old_body.find(scope_end)
+    
+    # Extract the ide logic before scope question
+    ide_logic_start_idx = old_body.find("  let isGemini = false;")
+    ide_logic_end_idx = old_body.find(scope_start)
+    ide_logic = old_body[ide_logic_start_idx:ide_logic_end_idx]
+    
+    inner_body = old_body[scope_start_idx:scope_end_idx]
+    
+    replacement += ide_logic
+    replacement += inner_body
+    replacement += """
+    } catch (error) {
+      console.error('? Error during installation:', error.message);
+    } finally {
+      if (rl) rl.close();
+    }
+}
+
+if (autoIde && autoScope) {
+  console.log('\\n?? Running in non-interactive mode with IDE=' + autoIde + ', Scope=' + autoScope);
+  runInstallation(autoIde, autoScope);
+} else {
+  rl.question(questionIde, (answerIde) => {
+    if (answerIde.trim() === '0') {
+      console.log('? B? qua c�i d?t t? d?ng.');
+      rl.close();
+      return;
+    }
+    rl.question(questionScope, (answerScope) => {
+      runInstallation(answerIde, answerScope);
+    });
+  });
+}
+"""
+    content = content[:start_idx] + replacement + content[end_idx:]
+    
+    with open('bin/install.js', 'w', encoding='utf-8') as f:
+        f.write(content)
+    print("Python patch applied.")
+else:
+    print("Could not find markers.")

package/skills/_archive_old_skills/qk-accessibility-audit/SKILL.md

@@ -118,3 +118,4 @@ Issues Found & Fixed:
 - [ ] Focus is visible on all interactive elements
 - [ ] Forms have proper labels
 - [ ] Icon-only buttons have accessible names
+

package/skills/_archive_old_skills/qk-agent-orchestrator/SKILL.md

@@ -176,3 +176,4 @@ Before finishing orchestration:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-api-integration/SKILL.md

@@ -386,3 +386,4 @@ Hook path:      [src/hooks/]
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-auth-security/SKILL.md

@@ -93,3 +93,4 @@ Security measures enforced:
 🔗 Next Steps:
   Remember to add `JWT_SECRET` to your production environment variables.
 ```
+

package/skills/_archive_old_skills/qk-backend-architecture/SKILL.md

@@ -122,3 +122,4 @@ Layer Mapping:
 🔗 Next Steps:
   Proceeding to implement the layers.
 ```
+

package/skills/_archive_old_skills/qk-bug-fix/SKILL.md

@@ -210,3 +210,4 @@ Similar areas to check: [file or pattern to review]
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-component-generator/SKILL.md

@@ -133,3 +133,4 @@ Features:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-context-manager/SKILL.md

@@ -172,3 +172,4 @@ Architecture summary:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-database-engineer/SKILL.md

@@ -101,3 +101,4 @@ Changes:
 🔗 Next Steps:
   Run `npx prisma migrate dev` to apply these changes locally.
 ```
+

package/skills/_archive_old_skills/qk-deployment/SKILL.md

@@ -93,3 +93,4 @@ Files Created/Modified:
 🔗 Next Steps:
   Commit these files and push to `main` to trigger the pipeline.
 ```
+

package/skills/_archive_old_skills/qk-design-system/SKILL.md

@@ -134,3 +134,4 @@ Styling Rules Enforced:
 - [ ] Mappings created for all necessary UI elements
 - [ ] Design tokens (spacing/colors) prioritized over hardcoded values
 - [ ] Strict enforcement rules passed to next skill
+

package/skills/_archive_old_skills/qk-form-builder/SKILL.md

@@ -137,3 +137,4 @@ Integration:
 - [ ] Error messages are displayed properly
 - [ ] Loading state disables the submit button
 - [ ] Accessibility: Inputs have associated labels and error ARIA attributes
+

package/skills/_archive_old_skills/qk-frontend-architecture/SKILL.md

@@ -152,3 +152,4 @@ File Placement:
 - [ ] Naming matches project standards
 - [ ] Separation of concerns maintained
 - [ ] Plan ready to be executed by generation skills
+

package/skills/_archive_old_skills/qk-frontend-debug/SKILL.md

@@ -130,3 +130,4 @@ Root Cause: [Explanation of why it failed, e.g., Stale Closure in useEffect]
 - [ ] No Hydration warnings remain
 - [ ] Component doesn't infinitely loop
 - [ ] No regression on related UI
+

package/skills/_archive_old_skills/qk-frontend-performance/SKILL.md

@@ -126,3 +126,4 @@ Bottleneck:  [Brief description, e.g., "Expensive list rendering on every keystr
 - [ ] No premature memoization applied blindly
 - [ ] Layout shift (CLS) prevented (if changing images/layout)
 - [ ] Application behavior remains completely unchanged
+

package/skills/_archive_old_skills/qk-frontend-testing/SKILL.md

@@ -143,3 +143,4 @@ Mocking Used:
 - [ ] Events simulated with `userEvent` (if applicable)
 - [ ] External dependencies/APIs are properly mocked
 - [ ] Tests verify observable behavior, not internal state
+

package/skills/_archive_old_skills/qk-git-engineer/SKILL.md

@@ -301,3 +301,4 @@ feat(scope): short imperative description
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-help/SKILL.md

@@ -65,3 +65,4 @@ Bạn có thể ép AI dùng công nghệ bạn muốn bằng cách thêm \`--th
 ### Mẹo 4: Nhờ "Kiến trúc sư" phân việc 🧠
 Nếu bạn có một tính năng quá lớn (ví dụ: Làm tính năng Giỏ Hàng), đừng tự chia việc, hãy gọi:
 > *"./qk-agent-orchestrator Tôi muốn làm tính năng Giỏ hàng. Hãy phân tích và lên kế hoạch gọi các skill \`qk-\` nào cho phù hợp."*
+

package/skills/_archive_old_skills/qk-migration/SKILL.md

@@ -281,3 +281,4 @@ TanStack Query 4 → 5: New API (no more isLoading/isError split), object syntax
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-project-audit/SKILL.md

@@ -277,3 +277,4 @@ P3 — Technical debt backlog:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-refactor/SKILL.md

@@ -219,3 +219,4 @@ Changes applied:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-state-management/SKILL.md

@@ -137,3 +137,4 @@ Implementation:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_archive_old_skills/qk-table-crud-generator/SKILL.md

@@ -124,3 +124,4 @@ Integration:
 - [ ] Pagination/sorting state is managed properly
 - [ ] CRUD actions trigger the correct mutations or navigations
 - [ ] Delete actions have a confirmation step
+

package/skills/_archive_old_skills/qk-ui-builder/SKILL.md

@@ -149,3 +149,4 @@ Component Hierarchy:
 ## Examples
 
 See `examples/` folder.
+

package/skills/_template/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: qk-[skill-name]
+category: [core|frontend|backend|fullstack|security|qa|maintenance|devops|utilities]
+version: 7.5.0
+description: "[One sentence — what it does]"
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+execution_mode: deterministic
+
+# Orchestrator routing metadata
+cost: [low|medium|high]
+latency: [fast|medium|slow]
+risk: [low|medium|high]
+side_effects: [edit_files|run_commands|read_only|none]
+produces: [report|code|schema|plan|tokens]
+consumes: [context-graph|design-md|stack-trace|json-payload|none]
+
+token_budget:
+  max_files_read: 3
+  max_lines_per_read: 150
+  max_shell_commands: 2
+  stop_early: true
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-[skill-name]
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese (match user language).
+
+---
+
+## Preconditions
+Before executing, verify ALL exist. STOP with `BLOCKED` if any is missing.
+
+- [ ] [Precondition 1 — e.g., "Repository is accessible"]
+- [ ] [Precondition 2 — e.g., "DESIGN.md exists in project root"]
+
+```
+On missing precondition:
+  EXIT: BLOCKED
+  Message: "[Precondition X] not found. Please provide: [what]"
+```
+
+---
+
+## Scope
+- ✅ [What this skill explicitly DOES]
+- ✅ [What this skill explicitly DOES]
+
+## Non-Goals
+- ❌ [Anti-pattern 1] — because [why]
+- ❌ [Anti-pattern 2]
+- ❌ Never create helper scripts (Node.js/Python/shell) to apply patches — edit files directly
+- ❌ Never read entire files > 150 lines — use targeted reads (StartLine:EndLine)
+
+---
+
+## Priority Order
+When token budget is insufficient, execute checks in this order:
+
+| Priority | Check | Skip Threshold |
+|----------|-------|----------------|
+| P1 | [Most critical — never skip] | Never |
+| P2 | [High priority] | Budget < 30% |
+| P3 | [Medium priority] | Budget < 50% |
+| P4 | [Low priority — always optional] | Budget < 70% |
+
+---
+
+## Workflow
+
+### Phase 1 — [Name: e.g., Triage]
+
+**Steps:**
+1. [Concrete step — specify tool: `grep_search` / `view_file[L1:L50]` / `run_command`]
+2. [Next step]
+
+**Exit When (stop this phase, move to next):**
+- [Condition A — e.g., "Root cause identified"]
+- [Condition B — e.g., "`max_files_read` reached"]
+
+**On Blocked:**
+```
+EXIT: BLOCKED
+Missing: [what specific info is needed]
+Questions:
+  1. [Specific question to user]
+```
+
+---
+
+### Phase 2 — [Name: e.g., Analyze]
+
+**Steps:**
+1. [Step]
+
+**Decision:**
+```
+IF [condition met]
+  → proceed to Phase 3
+ELSE IF [edge case]
+  → EXIT: PARTIAL — note: [what was missed]
+ELSE
+  → ESCALATE
+```
+
+---
+
+### Phase 3 — [Name: e.g., Execute]
+
+**Steps:**
+1. Apply fix using `replace_file_content` or `multi_replace_file_content` — NEVER via scripts
+2. [Verification step]
+
+**Exit When:**
+- Fix applied and verified → EXIT: SUCCESS
+- Fix applied but unverifiable → EXIT: PARTIAL
+
+---
+
+## Confidence Model
+
+| Level | Condition | Action |
+|-------|-----------|--------|
+| HIGH | Direct evidence (file:line, stack trace, exact match) | Proceed |
+| MEDIUM | Inferred from patterns or similar code | Note assumption, proceed carefully |
+| LOW | Assumption without evidence | STOP — ask user before proceeding |
+
+---
+
+## Severity
+
+| Level | Definition | Example |
+|-------|-----------|---------|
+| CRITICAL | Data loss / security breach / app down | Hardcoded secret, SQL injection |
+| HIGH | Core feature broken, blocking users | Null crash, broken API |
+| MEDIUM | Degraded UX, workaround exists | Cyclomatic > 10, missing loading state |
+| LOW | Style/cosmetic, non-blocking | Missing comment, minor inconsistency |
+
+---
+
+## Evidence Format
+
+Every finding MUST use this format:
+```
+[SEVERITY] path/to/file.ts:LINE
+Reason:     [why this is a violation or finding]
+Confidence: [HIGH|MEDIUM|LOW]
+Fix:        [one-line suggestion]
+```
+
+**Example:**
+```
+[HIGH] src/auth.service.ts:132
+Reason:     Function length 64 lines exceeds threshold of 30
+Confidence: HIGH
+Fix:        Extract token validation to `validateToken()`
+```
+
+---
+
+## Retry Policy
+
+```
+Action fails
+  └─ Attempt auto-fix (if fix is deterministic)
+       └─ Re-run verification
+            ├─ PASS → EXIT: SUCCESS
+            └─ FAIL (2nd time) → EXIT: PARTIAL + report
+                 └─ Do NOT retry more than 2 times
+                      └─ 3rd failure → ESCALATE to user
+```
+
+---
+
+## Escalation Rules
+
+When blocked, **never just "STOP"** — return structured response:
+
+```
+BLOCKED: [Reason — specific, not vague]
+Missing:
+  - [Specific artifact or information needed]
+Questions:
+  1. [Specific question]
+  2. [Specific question]
+Recommended Assumptions (if you want me to proceed anyway):
+  - [Safe assumption 1]
+  - [Safe assumption 2]
+```
+
+---
+
+## Handoff Contract
+
+### Consumes (Input from upstream)
+```json
+{
+  "from": "[skill-name or 'user']",
+  "required_fields": ["field1", "field2"],
+  "optional_fields": ["field3"]
+}
+```
+
+### Produces (Output for downstream)
+```json
+{
+  "to": "[skill-name or 'user']",
+  "output_fields": ["changed_files", "summary", "confidence", "exit_code"]
+}
+```
+
+---
+
+## Output Format
+
+```
+[SKILL_NAME] Result
+─────────────────────────────────────────────────
+Status:      [SUCCESS | PARTIAL | BLOCKED | FAILED]
+Confidence:  [HIGH | MEDIUM | LOW]
+
+[Section specific to this skill]
+
+Exit Code:   [SUCCESS | PARTIAL | BLOCKED | FAILED]
+```
+
+---
+
+## Exit Codes
+
+| Code | Meaning | Orchestrator Action |
+|------|---------|---------------------|
+| SUCCESS | All checks passed, task complete | Continue pipeline |
+| PARTIAL | Task done with degraded quality or skipped P3/P4 checks | Notify user, continue |
+| BLOCKED | Missing precondition or ambiguous requirement | STOP, ask user |
+| FAILED | Task failed after 2 retry attempts | STOP, report error |
+