codymaster 4.4.4 → 4.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +29 -14
  3. package/commands/demo.md +1 -1
  4. package/dist/context-bus.js +70 -0
  5. package/dist/context-db.js +265 -0
  6. package/dist/continuity.js +12 -0
  7. package/dist/file-watcher.js +79 -0
  8. package/dist/index.js +152 -1
  9. package/dist/l0-indexer.js +158 -0
  10. package/dist/mcp-context-server.js +400 -0
  11. package/dist/migrate-json-to-sqlite.js +126 -0
  12. package/dist/skill-chain.js +19 -3
  13. package/dist/token-budget.js +108 -0
  14. package/dist/uri-resolver.js +203 -0
  15. package/package.json +7 -1
  16. package/skills/_shared/helpers.md +50 -14
  17. package/skills/cm-autopilot/SKILL.md +29 -0
  18. package/skills/cm-autopilot/scripts/autopilot.py +190 -0
  19. package/skills/cm-continuity/SKILL.md +90 -28
  20. package/skills/cm-quality-gate/SKILL.md +11 -1
  21. package/skills/cm-safe-deploy/SKILL.md +38 -2
  22. package/skills/cm-security-gate/SKILL.md +158 -34
  23. package/skills/cm-skill-chain/SKILL.md +47 -1
  24. package/skills/cm-start/SKILL.md +11 -2
  25. package/skills/cm-test-gate/SKILL.md +3 -0
  26. package/skills/boxme-git-config/SKILL.md +0 -56
  27. package/skills/boxme-local-dev/SKILL.md +0 -66
  28. package/skills/jobs-to-be-done/SKILL.md +0 -266
  29. package/skills/jobs-to-be-done/references/case-studies.md +0 -154
  30. package/skills/jobs-to-be-done/references/competitive-strategy.md +0 -280
  31. package/skills/jobs-to-be-done/references/diagnostics.md +0 -158
  32. package/skills/jobs-to-be-done/references/innovation-process.md +0 -392
  33. package/skills/jobs-to-be-done/references/organizational-change.md +0 -328
  34. package/skills/marketplace-report-crawler/SKILL.md +0 -176
  35. package/skills/marketplace-report-crawler/config/accounts.json +0 -41
  36. package/skills/marketplace-report-crawler/config/report-types.json +0 -422
  37. package/skills/marketplace-report-crawler/config/sessions.json +0 -3
  38. package/skills/marketplace-report-crawler/scripts/ab-wrapper.sh +0 -102
  39. package/skills/marketplace-report-crawler/scripts/browser-actions/lazada/lazada-actions.js +0 -114
  40. package/skills/marketplace-report-crawler/scripts/browser-actions/shopee/shopee-actions.js +0 -94
  41. package/skills/marketplace-report-crawler/scripts/browser-actions/tiktok/tiktok-actions.js +0 -272
  42. package/skills/marketplace-report-crawler/scripts/crawl-runner.js +0 -281
  43. package/skills/marketplace-report-crawler/scripts/session-check.sh +0 -72
  44. package/skills/marketplace-report-crawler/scripts/session-manager.sh +0 -349
  45. package/skills/marketplace-report-crawler/scripts/setup-folders.sh +0 -83
  46. package/skills/medical-research/SKILL.md +0 -194
  47. package/skills/medical-research/scripts/evidence_checker.py +0 -288
  48. package/skills/mom-test/SKILL.md +0 -267
  49. package/skills/mom-test/references/avoiding-bad-data.md +0 -221
  50. package/skills/mom-test/references/case-studies.md +0 -306
  51. package/skills/mom-test/references/commitment-advancement.md +0 -219
  52. package/skills/mom-test/references/finding-conversations.md +0 -251
  53. package/skills/mom-test/references/processing-learning.md +0 -256
  54. package/skills/mom-test/references/question-patterns.md +0 -198
  55. package/skills/pandasai-analytics/SKILL.md +0 -251
  56. package/skills/release-it/SKILL.md +0 -235
  57. package/skills/release-it/references/anti-patterns.md +0 -279
  58. package/skills/release-it/references/capacity-planning.md +0 -285
  59. package/skills/release-it/references/chaos-engineering.md +0 -325
  60. package/skills/release-it/references/deployment-strategies.md +0 -331
  61. package/skills/release-it/references/observability.md +0 -301
  62. package/skills/release-it/references/stability-patterns.md +0 -355
  63. package/skills/skill-creator-ultra/.agents/workflows/skill-audit.md +0 -37
  64. package/skills/skill-creator-ultra/.agents/workflows/skill-compare.md +0 -34
  65. package/skills/skill-creator-ultra/.agents/workflows/skill-export.md +0 -51
  66. package/skills/skill-creator-ultra/.agents/workflows/skill-generate.md +0 -39
  67. package/skills/skill-creator-ultra/.agents/workflows/skill-scaffold.md +0 -52
  68. package/skills/skill-creator-ultra/.agents/workflows/skill-simulate.md +0 -25
  69. package/skills/skill-creator-ultra/.agents/workflows/skill-stats.md +0 -31
  70. package/skills/skill-creator-ultra/.agents/workflows/skill-validate.md +0 -25
  71. package/skills/skill-creator-ultra/README.md +0 -1242
  72. package/skills/skill-creator-ultra/SKILL.md +0 -388
  73. package/skills/skill-creator-ultra/agents/analyzer.md +0 -274
  74. package/skills/skill-creator-ultra/agents/comparator.md +0 -202
  75. package/skills/skill-creator-ultra/agents/grader.md +0 -223
  76. package/skills/skill-creator-ultra/assets/eval_review.html +0 -146
  77. package/skills/skill-creator-ultra/eval-viewer/generate_review.py +0 -471
  78. package/skills/skill-creator-ultra/eval-viewer/viewer.html +0 -1325
  79. package/skills/skill-creator-ultra/examples/example_anthropic_frontend.md +0 -109
  80. package/skills/skill-creator-ultra/examples/example_anthropic_pdf.md +0 -116
  81. package/skills/skill-creator-ultra/examples/example_api_docs.md +0 -189
  82. package/skills/skill-creator-ultra/examples/example_db_migration.md +0 -253
  83. package/skills/skill-creator-ultra/examples/example_git_commit.md +0 -111
  84. package/skills/skill-creator-ultra/install.ps1 +0 -289
  85. package/skills/skill-creator-ultra/install.sh +0 -313
  86. package/skills/skill-creator-ultra/phases/phase1_interview.md +0 -202
  87. package/skills/skill-creator-ultra/phases/phase2_extract.md +0 -55
  88. package/skills/skill-creator-ultra/phases/phase3_detect.md +0 -57
  89. package/skills/skill-creator-ultra/phases/phase4_generate.md +0 -543
  90. package/skills/skill-creator-ultra/phases/phase5_test.md +0 -319
  91. package/skills/skill-creator-ultra/phases/phase6_eval.md +0 -301
  92. package/skills/skill-creator-ultra/phases/phase7_iterate.md +0 -103
  93. package/skills/skill-creator-ultra/phases/phase8_optimize.md +0 -113
  94. package/skills/skill-creator-ultra/resources/advanced_patterns.md +0 -499
  95. package/skills/skill-creator-ultra/resources/anti_patterns.md +0 -376
  96. package/skills/skill-creator-ultra/resources/blueprints.md +0 -498
  97. package/skills/skill-creator-ultra/resources/checklist.md +0 -243
  98. package/skills/skill-creator-ultra/resources/composition_cookbook.md +0 -291
  99. package/skills/skill-creator-ultra/resources/description_optimization.md +0 -90
  100. package/skills/skill-creator-ultra/resources/eval_guide.md +0 -133
  101. package/skills/skill-creator-ultra/resources/industry_questions.md +0 -189
  102. package/skills/skill-creator-ultra/resources/interview_questions.md +0 -200
  103. package/skills/skill-creator-ultra/resources/pattern_detection.md +0 -200
  104. package/skills/skill-creator-ultra/resources/prompt_engineering.md +0 -531
  105. package/skills/skill-creator-ultra/resources/schemas.md +0 -430
  106. package/skills/skill-creator-ultra/resources/script_integration.md +0 -593
  107. package/skills/skill-creator-ultra/resources/scripts_guide.md +0 -339
  108. package/skills/skill-creator-ultra/resources/skill_template.md +0 -124
  109. package/skills/skill-creator-ultra/resources/skill_writing_guide.md +0 -634
  110. package/skills/skill-creator-ultra/resources/versioning_guide.md +0 -193
  111. package/skills/skill-creator-ultra/scripts/ci_eval.py +0 -200
  112. package/skills/skill-creator-ultra/scripts/package_skill.py +0 -165
  113. package/skills/skill-creator-ultra/scripts/simulate_skill.py +0 -398
  114. package/skills/skill-creator-ultra/scripts/skill_audit.py +0 -611
  115. package/skills/skill-creator-ultra/scripts/skill_compare.py +0 -265
  116. package/skills/skill-creator-ultra/scripts/skill_export.py +0 -334
  117. package/skills/skill-creator-ultra/scripts/skill_scaffold.py +0 -403
  118. package/skills/skill-creator-ultra/scripts/skill_stats.py +0 -339
  119. package/skills/skill-creator-ultra/scripts/validate_skill.py +0 -411
  120. package/skills/tailwind-mastery/SKILL.md +0 -229
  121. package/skills/vercel-react-best-practices/AGENTS.md +0 -3373
  122. package/skills/vercel-react-best-practices/README.md +0 -123
  123. package/skills/vercel-react-best-practices/SKILL.md +0 -143
  124. package/skills/vercel-react-best-practices/rules/_sections.md +0 -46
  125. package/skills/vercel-react-best-practices/rules/_template.md +0 -28
  126. package/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +0 -55
  127. package/skills/vercel-react-best-practices/rules/advanced-init-once.md +0 -42
  128. package/skills/vercel-react-best-practices/rules/advanced-use-latest.md +0 -39
  129. package/skills/vercel-react-best-practices/rules/async-api-routes.md +0 -38
  130. package/skills/vercel-react-best-practices/rules/async-defer-await.md +0 -80
  131. package/skills/vercel-react-best-practices/rules/async-dependencies.md +0 -51
  132. package/skills/vercel-react-best-practices/rules/async-parallel.md +0 -28
  133. package/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +0 -99
  134. package/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +0 -59
  135. package/skills/vercel-react-best-practices/rules/bundle-conditional.md +0 -31
  136. package/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +0 -49
  137. package/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +0 -35
  138. package/skills/vercel-react-best-practices/rules/bundle-preload.md +0 -50
  139. package/skills/vercel-react-best-practices/rules/client-event-listeners.md +0 -74
  140. package/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +0 -71
  141. package/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +0 -48
  142. package/skills/vercel-react-best-practices/rules/client-swr-dedup.md +0 -56
  143. package/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +0 -107
  144. package/skills/vercel-react-best-practices/rules/js-cache-function-results.md +0 -80
  145. package/skills/vercel-react-best-practices/rules/js-cache-property-access.md +0 -28
  146. package/skills/vercel-react-best-practices/rules/js-cache-storage.md +0 -70
  147. package/skills/vercel-react-best-practices/rules/js-combine-iterations.md +0 -32
  148. package/skills/vercel-react-best-practices/rules/js-early-exit.md +0 -50
  149. package/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +0 -60
  150. package/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +0 -45
  151. package/skills/vercel-react-best-practices/rules/js-index-maps.md +0 -37
  152. package/skills/vercel-react-best-practices/rules/js-length-check-first.md +0 -49
  153. package/skills/vercel-react-best-practices/rules/js-min-max-loop.md +0 -82
  154. package/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +0 -24
  155. package/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +0 -57
  156. package/skills/vercel-react-best-practices/rules/rendering-activity.md +0 -26
  157. package/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +0 -47
  158. package/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +0 -40
  159. package/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +0 -38
  160. package/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +0 -46
  161. package/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +0 -82
  162. package/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +0 -30
  163. package/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +0 -85
  164. package/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +0 -68
  165. package/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +0 -28
  166. package/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +0 -75
  167. package/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +0 -39
  168. package/skills/vercel-react-best-practices/rules/rerender-dependencies.md +0 -45
  169. package/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +0 -40
  170. package/skills/vercel-react-best-practices/rules/rerender-derived-state.md +0 -29
  171. package/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +0 -74
  172. package/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +0 -58
  173. package/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +0 -38
  174. package/skills/vercel-react-best-practices/rules/rerender-memo.md +0 -44
  175. package/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +0 -45
  176. package/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +0 -82
  177. package/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +0 -35
  178. package/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +0 -64
  179. package/skills/vercel-react-best-practices/rules/rerender-transitions.md +0 -40
  180. package/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +0 -59
  181. package/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +0 -73
  182. package/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +0 -73
  183. package/skills/vercel-react-best-practices/rules/server-auth-actions.md +0 -96
  184. package/skills/vercel-react-best-practices/rules/server-cache-lru.md +0 -41
  185. package/skills/vercel-react-best-practices/rules/server-cache-react.md +0 -76
  186. package/skills/vercel-react-best-practices/rules/server-dedup-props.md +0 -65
  187. package/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +0 -142
  188. package/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +0 -83
  189. package/skills/vercel-react-best-practices/rules/server-serialization.md +0 -38
  190. package/skills/web-design-guidelines/SKILL.md +0 -39
@@ -1,202 +0,0 @@
1
- ## Phase 1: 🎤 Deep Interview — Phỏng vấn thông minh
2
-
3
- Mục tiêu: Hiểu được công việc + quy trình + quy tắc từ góc nhìn người dùng.
4
- Thời lượng: 5-10 câu hỏi tùy độ phức tạp.
5
-
6
- > **Lưu ý quan trọng:** Tham khảo `resources/interview_questions.md` để chọn câu hỏi
7
- > phù hợp, và `resources/industry_questions.md` cho câu hỏi chuyên ngành.
8
- > Xem `resources/anti_patterns.md` để tránh lỗi phổ biến.
9
-
10
- ### 1.0Q. ⚡ Quick Mode — Tạo skill trong 1 lượt (No-Code Style)
11
-
12
- > Lấy cảm hứng từ OpenAI GPTs Builder — user mô tả, AI sinh xong.
13
- > Dùng khi user ĐÃ BIẾT RÕ cần gì, không cần interview dài.
14
-
15
- **TRƯỚC KHI phỏng vấn**, phân tích câu đầu tiên của user:
16
-
17
- **Nếu câu mô tả ĐÃ ĐỦ 3/4 yếu tố** (trigger + steps + rules + output format):
18
-
19
- > "Em thấy anh/chị đã mô tả khá rõ. Em sẽ dùng **Quick Mode** — sinh
20
- > skill ngay trong 1 lượt. Nếu cần chỉnh sửa, mình iterate sau nhé."
21
-
22
- **Quick Mode Flow:**
23
- 1. Extract trigger words → `description`
24
- 2. Extract steps → `# Instructions`
25
- 3. Extract rules → `# Constraints`
26
- 4. Generate 1 example from context → `# Examples`
27
- 5. Sinh SKILL.md → show cho user review → sửa nếu cần
28
- 6. Skip thẳng Phase 4 (generate) → Phase 5 (test)
29
-
30
- **Ví dụ Quick Mode trigger:**
31
-
32
- | User nói | Quick Mode? | Lý do |
33
- |---|---|---|
34
- | "Tạo skill viết commit message theo conventional commits, input là git diff, output là commit message có type/scope/body" | ✅ Đủ 4/4 | Có trigger + steps + format + scope rõ |
35
- | "Tạo skill review code" | ❌ 1/4 | Chưa rõ steps, rules, output format |
36
- | "Em muốn AI tự viết báo cáo tuần từ Jira, format markdown, gửi Slack mỗi thứ 6" | ✅ Đủ 3/4 | Có trigger + output + schedule, thiếu details nhỏ |
37
-
38
- **Nếu câu mô tả CHƯA ĐỦ** → chuyển sang phỏng vấn bình thường (1.0 → 1.8).
39
-
40
- ---
41
-
42
- ### 1.0. Auto-Detect Mode — Scan codebase đề xuất skill (v4.0)
43
-
44
- **TRƯỚC KHI phỏng vấn**, hỏi user:
45
-
46
- > "Anh/chị có muốn em **scan project hiện tại** để đề xuất skill cần tạo không?
47
- >
48
- > - A) Có — scan project rồi đề xuất
49
- > - B) Không — em có ý tưởng sẵn rồi"
50
-
51
- **Nếu chọn A (Auto-Detect):**
52
-
53
- 1. Scan cấu trúc project:
54
- - Đọc `package.json` / `requirements.txt` / `Makefile` → xác định tech stack
55
- - Đọc `.github/workflows/` → xác định CI/CD flow
56
- - Đọc `scripts/` → xác định automation hiện có
57
- - Đọc `README.md` → hiểu mục đích project
58
-
59
- 2. Phân tích và đề xuất (tối đa 5 skill):
60
-
61
- > "📊 Em đã scan project, đây là các skill tiềm năng:
62
- >
63
- > | # | Skill đề xuất | Lý do | Độ phức tạp |
64
- > | --- | --- | --- | --- |
65
- > | 1 | `[tên-skill-1]` | [Phát hiện pattern X trong code] | 🟢 Đơn giản |
66
- > | 2 | `[tên-skill-2]` | [Thấy script Y chưa có quy trình chuẩn] | 🟡 Trung bình |
67
- > | 3 | `[tên-skill-3]` | [CI/CD cần tự động hóa bước Z] | 🟠 Phức tạp |
68
- >
69
- > Anh/chị muốn tạo skill nào? (chọn số hoặc mô tả ý tưởng khác)"
70
-
71
- 1. User chọn → chuyển sang phỏng vấn tiêu chuẩn (1.1+)
72
-
73
- **Nếu chọn B → skip, bắt đầu phỏng vấn bình thường.**
74
-
75
- ### 1.1. Mở đầu (Ice-breaker)
76
-
77
- Bắt đầu bằng câu hỏi mở, thân thiện:
78
-
79
- > "Anh/chị mô tả cho em nghe công việc mà anh/chị muốn AI tự động hóa đi.
80
- > Nói tự nhiên thôi, như đang hướng dẫn một đồng nghiệp mới vậy."
81
-
82
- ### 1.2. Câu hỏi trích xuất TRIGGER (Khi nào bắt đầu?)
83
-
84
- > "Thường thì khi nào anh/chị cần làm việc này? Có tín hiệu hay sự kiện
85
- > nào kích hoạt không?"
86
-
87
- **Mục đích:** Xác định `description` (trigger words) cho skill.
88
-
89
- **Ví dụ trả lời → Mapping:**
90
-
91
- | User nói | AI hiểu |
92
- |---|---|
93
- | "Mỗi khi code xong" | Trigger: sau khi commit/push |
94
- | "Khi khách gửi email hỏi giá" | Trigger: nhận email yêu cầu báo giá |
95
- | "Mỗi thứ Hai đầu tuần" | Trigger: tác vụ định kỳ weekly |
96
- | "Khi bắt đầu dự án mới" | Trigger: khởi tạo project |
97
-
98
- ### 1.3. Câu hỏi trích xuất STEPS (Làm gì & theo thứ tự nào?)
99
-
100
- > "Bước đầu tiên anh/chị thường làm gì? Rồi sau đó?"
101
- > "Có bước nào phụ thuộc vào kết quả bước trước không?"
102
-
103
- **Kỹ thuật phỏng vấn:**
104
-
105
- - Hỏi theo **trình tự thời gian**: "Đầu tiên? → Tiếp theo? → Sau đó?"
106
- - Nếu user nhảy bước: "Khoan, giữa bước A và bước C, có bước nào ở giữa không?"
107
- - Nếu user mô tả mơ hồ: "Cụ thể hơn được không? VD bước này cần nhập gì, xuất ra gì?"
108
-
109
- **Mục đích:** Xác định `# Instructions` — chuỗi bước logic.
110
-
111
- ### 1.4. Câu hỏi trích xuất INPUT/OUTPUT (Đầu vào/Đầu ra)
112
-
113
- > "Khi bắt đầu, anh/chị cần có những thông tin gì sẵn?"
114
- > "Kết quả cuối cùng trông như thế nào? Có mẫu nào không?"
115
-
116
- **Đào sâu:**
117
-
118
- - "Thông tin đó lấy từ đâu?" (file? database? user nhập? API?)
119
- - "Kết quả giao cho ai? Ở dạng gì?" (file? email? console? dashboard?)
120
-
121
- **Mục đích:** Xác định `# Examples` — input/output mẫu.
122
-
123
- ### 1.5. Câu hỏi trích xuất RULES (Quy tắc & Hạn chế)
124
-
125
- > "Có quy tắc nào BẮT BUỘC phải tuân thủ không?"
126
- > "Có điều gì TUYỆT ĐỐI KHÔNG ĐƯỢC làm không?"
127
- > "Đã bao giờ có ai làm sai bước nào chưa? Sai như thế nào?"
128
-
129
- **Đào sâu:**
130
-
131
- - "Nếu gặp trường hợp bất thường thì xử lý sao?"
132
- - "Có ngoại lệ nào cho quy tắc đó không?"
133
-
134
- **Mục đích:** Xác định `# Constraints` — danh sách KHÔNG ĐƯỢC / LUÔN LUÔN.
135
-
136
- ### 1.6. Câu hỏi trích xuất EDGE CASES (Trường hợp đặc biệt)
137
-
138
- > "Có khi nào quy trình này bị 'tắc' giữa chừng không? Lý do?"
139
- > "Trường hợp xấu nhất có thể xảy ra là gì?"
140
- > "Có khách hàng/tình huống nào xử lý khác bình thường không?"
141
-
142
- **Mục đích:** Bổ sung logic xử lý ngoại lệ vào Instructions.
143
-
144
- ### 1.7. Câu hỏi trích xuất TOOLS (Công cụ sử dụng)
145
-
146
- > "Anh/chị dùng phần mềm/tool gì để làm việc này?"
147
- > "Có cần chạy lệnh hay thao tác trên hệ thống nào không?"
148
-
149
- **Mục đích:** Xác định cần `scripts/` hay không, và loại pattern phù hợp.
150
-
151
- ### 1.X. Kỹ thuật xử lý user trả lời MƠ HỒ
152
-
153
- Người dùng thường trả lời không rõ ràng. Dùng các kỹ thuật sau:
154
-
155
- **Kỹ thuật 1: Paraphrasing (Diễn đạt lại)**
156
- > User: "Em kiểm tra mấy cái rồi gửi đi."
157
- > AI: "Vậy ý anh là: Bước 1 kiểm tra [cái gì cụ thể?], Bước 2 gửi [cho ai? qua kênh nào?] — đúng không?"
158
-
159
- **Kỹ thuật 2: Concrete Example (Xin ví dụ cụ thể)**
160
- > User: "Em xử lý dữ liệu."
161
- > AI: "Cho em 1 ví dụ cụ thể đi anh — lần gần nhất anh xử lý là dữ liệu gì, từ đâu, và kết quả trả ra thế nào?"
162
-
163
- **Kỹ thuật 3: Yes/No Narrowing (Thu hẹp bằng câu hỏi đóng)**
164
- > User: "Nhiều bước lắm."
165
- > AI: "OK, để em hỏi từng cái nhé:
166
- >
167
- > - Có cần đọc file/dữ liệu đầu vào không? [CÓ/KHÔNG]
168
- > - Có cần tính toán gì không? [CÓ/KHÔNG]
169
- > - Kết quả cuối cùng là file hay hiển thị trên màn hình? [FILE/MÀN HÌNH]"
170
-
171
- **Kỹ thuật 4: Show & Tell (Cho user xem mẫu)**
172
- > User: "Em không biết mô tả sao."
173
- > AI: "Không sao. Để em cho anh xem 1 ví dụ skill tương tự nhé:
174
- > [Hiển thị ví dụ từ `examples/`]
175
- > Công việc của anh giống vậy không? Khác chỗ nào?"
176
-
177
- **Kỹ thuật 5: Timeline Walk (Đi theo dòng thời gian)**
178
- > User: "Phức tạp lắm, không biết bắt đầu từ đâu."
179
- > AI: "Không sao, mình đi theo thời gian nhé. Sáng nay anh mở máy tính lên,
180
- > bắt đầu làm công việc này — anh mở phần mềm nào trước tiên?"
181
-
182
- ### 1.8. Tổng kết phỏng vấn
183
-
184
- Sau khi đủ thông tin, TÓM TẮT lại cho user xác nhận:
185
-
186
- > "OK, để em tóm tắt lại nhé:
187
- >
188
- > 📌 **Công việc:** [Mô tả 1 câu]
189
- > 🎯 **Mục tiêu:** [Kết quả mong muốn]
190
- > 📝 **Quy trình:** [X bước]
191
- >
192
- > 1. [Bước 1]
193
- > 2. [Bước 2]
194
- > ...
195
- > ⚠️ **Quy tắc:** [Y quy tắc quan trọng]
196
- > 🔧 **Công cụ:** [Danh sách tool/phần mềm]
197
- >
198
- > Em hiểu đúng chưa? Có gì cần bổ sung không?"
199
-
200
- **BẮT BUỘC** phải được user confirm trước khi chuyển sang Phase 2.
201
-
202
- ---
@@ -1,55 +0,0 @@
1
- ## Phase 2: 🔬 Knowledge Extraction — Trích xuất & Cấu trúc hóa
2
-
3
- Mục tiêu: Chuyển đổi thông tin thô từ phỏng vấn → cấu trúc skill chuẩn.
4
-
5
- ### 2.1. Mapping Table (Bảng ánh xạ)
6
-
7
- Dùng bảng sau để chuyển đổi:
8
-
9
- | Thông tin từ phỏng vấn | Thành phần Skill |
10
- |---|---|
11
- | Mô tả công việc tổng quan | `description` trong YAML frontmatter |
12
- | Tín hiệu kích hoạt | Trigger words trong `description` |
13
- | Mục tiêu cuối cùng | `# Goal` |
14
- | Các bước tuần tự | `# Instructions` |
15
- | Dữ liệu đầu vào/đầu ra | `# Examples` (Input/Output) |
16
- | Quy tắc bắt buộc | `# Constraints` (LUÔN LUÔN) |
17
- | Điều cấm | `# Constraints` (KHÔNG ĐƯỢC) |
18
- | Trường hợp đặc biệt | Logic rẽ nhánh trong Instructions |
19
- | Công cụ/phần mềm | `scripts/` hoặc lệnh trong Instructions |
20
- | File mẫu/template | `resources/` |
21
- | Ví dụ thực tế | `examples/` |
22
-
23
- ### 2.2. Đặt tên Skill
24
-
25
- Quy tắc đặt tên tự động:
26
-
27
- 1. Lấy **hành động chính** + **đối tượng chính** từ mô tả
28
- 2. Chuyển thành `kebab-case`
29
- 3. Tối đa 30 ký tự
30
-
31
- **Công thức:** `[hành-động]-[đối-tượng]` hoặc `[đối-tượng]-[hành-động]er`
32
-
33
- | Mô tả | Tên skill |
34
- |---|---|
35
- | "Viết báo cáo tuần" | `weekly-report-writer` |
36
- | "Kiểm tra code trước khi merge" | `pre-merge-reviewer` |
37
- | "Tạo invoice cho khách" | `invoice-generator` |
38
- | "Deploy ứng dụng lên server" | `app-deployer` |
39
-
40
- ### 2.3. Viết Description "sát thương cao"
41
-
42
- Description phải đạt 3 tiêu chí:
43
-
44
- 1. **Chính xác** — Mô tả đúng skill làm gì
45
- 2. **Có trigger words** — Chứa từ khóa để AI nhận diện
46
- 3. **Có context** — Nói rõ khi nào/dùng cho ai
47
-
48
- **Template description:**
49
-
50
- ```
51
- [Hành động chính] [đối tượng] [theo chuẩn/phương pháp gì].
52
- [Bổ sung chi tiết]. Kích hoạt khi user [liệt kê trigger phrases].
53
- ```
54
-
55
- ---
@@ -1,57 +0,0 @@
1
- ## Phase 3: 🔎 Pattern Detection — Tự nhận diện kiến trúc
2
-
3
- Mục tiêu: Dựa vào thông tin đã trích xuất, tự động chọn kiến trúc phù hợp.
4
-
5
- ### 3.1. Decision Tree (Cây quyết định)
6
-
7
- Chạy qua checklist sau để xác định pattern:
8
-
9
- ```
10
- Q1: Skill có cần chạy lệnh terminal/script không?
11
- ├── CÓ → Thêm Pattern 1 (Script Skills) → Tạo scripts/
12
- └── KHÔNG → Tiếp Q2
13
-
14
- Q2: Skill có cần nhiều template/file mẫu không?
15
- ├── CÓ → Thêm Pattern 2 (Multi-Resource) → Tạo resources/
16
- └── KHÔNG → Tiếp Q3
17
-
18
- Q3: Skill có hành xử khác nhau tùy ngữ cảnh không?
19
- ├── CÓ → Thêm Pattern 3 (Context-Aware) → Tạo resources/strategies/
20
- └── KHÔNG → Tiếp Q4
21
-
22
- Q4: Skill có thao tác nhạy cảm (xóa data, deploy, production) không?
23
- ├── CÓ → Thêm Pattern 4 (Safety-First) → Thêm Bước 0: Safety Check
24
- └── KHÔNG → Tiếp Q5
25
-
26
- Q5: Skill có nhiều bước tuần tự, mỗi bước phụ thuộc bước trước?
27
- ├── CÓ (≥5 bước liên hoàn) → Thêm Pattern 5 (Pipeline) → Thêm progress tracking
28
- └── KHÔNG → Basic Skill
29
-
30
- Q6: Skill có thể tận dụng skill nào đã có không?
31
- ├── CÓ → Thêm Pattern 6 (Composable) → Tham chiếu skill có sẵn
32
- └── KHÔNG → Giữ nguyên
33
- ```
34
-
35
- ### 3.2. Complexity Score (Điểm phức tạp)
36
-
37
- Tính điểm để quyết định quy mô skill:
38
-
39
- | Yếu tố | Điểm |
40
- |---|---|
41
- | Mỗi bước trong quy trình | +1 |
42
- | Mỗi quy tắc/constraint | +1 |
43
- | Cần chạy script/lệnh | +3 |
44
- | Có logic rẽ nhánh (if/else) | +2 mỗi nhánh |
45
- | Thao tác production/nhạy cảm | +5 |
46
- | Cần nhiều template | +2 |
47
-
48
- **Kết quả:**
49
-
50
- | Tổng điểm | Mức độ | Quy mô |
51
- |---|---|---|
52
- | 1-5 | 🟢 Đơn giản | Chỉ cần SKILL.md |
53
- | 6-12 | 🟡 Trung bình | SKILL.md + examples/ |
54
- | 13-20 | 🟠 Phức tạp | SKILL.md + resources/ + examples/ |
55
- | 21+ | 🔴 Rất phức tạp | Full structure + scripts/ |
56
-
57
- ---