codymaster 4.4.5 → 4.5.2

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 (197) 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 +5 -1
  16. package/scripts/gate-0-secrets.js +63 -0
  17. package/scripts/gate-1-syntax.js +53 -0
  18. package/scripts/gate-5-dist-verify.js +55 -0
  19. package/scripts/gate-6-smoke-test.js +30 -0
  20. package/scripts/index-codebase.sh +552 -0
  21. package/scripts/mcp-bridge.js +284 -0
  22. package/scripts/postinstall.js +301 -0
  23. package/scripts/security-fixer.js +143 -0
  24. package/scripts/security-scan.js +55 -0
  25. package/scripts/test-gemini.js +13 -0
  26. package/scripts/todo-bridge.js +112 -0
  27. package/skills/_shared/helpers.md +50 -14
  28. package/skills/cm-autopilot/SKILL.md +29 -0
  29. package/skills/cm-autopilot/scripts/autopilot.py +190 -0
  30. package/skills/cm-continuity/SKILL.md +90 -28
  31. package/skills/cm-skill-chain/SKILL.md +47 -1
  32. package/skills/cm-start/SKILL.md +11 -2
  33. package/skills/boxme-git-config/SKILL.md +0 -56
  34. package/skills/boxme-local-dev/SKILL.md +0 -66
  35. package/skills/jobs-to-be-done/SKILL.md +0 -266
  36. package/skills/jobs-to-be-done/references/case-studies.md +0 -154
  37. package/skills/jobs-to-be-done/references/competitive-strategy.md +0 -280
  38. package/skills/jobs-to-be-done/references/diagnostics.md +0 -158
  39. package/skills/jobs-to-be-done/references/innovation-process.md +0 -392
  40. package/skills/jobs-to-be-done/references/organizational-change.md +0 -328
  41. package/skills/marketplace-report-crawler/SKILL.md +0 -176
  42. package/skills/marketplace-report-crawler/config/accounts.json +0 -41
  43. package/skills/marketplace-report-crawler/config/report-types.json +0 -422
  44. package/skills/marketplace-report-crawler/config/sessions.json +0 -3
  45. package/skills/marketplace-report-crawler/scripts/ab-wrapper.sh +0 -102
  46. package/skills/marketplace-report-crawler/scripts/browser-actions/lazada/lazada-actions.js +0 -114
  47. package/skills/marketplace-report-crawler/scripts/browser-actions/shopee/shopee-actions.js +0 -94
  48. package/skills/marketplace-report-crawler/scripts/browser-actions/tiktok/tiktok-actions.js +0 -272
  49. package/skills/marketplace-report-crawler/scripts/crawl-runner.js +0 -281
  50. package/skills/marketplace-report-crawler/scripts/session-check.sh +0 -72
  51. package/skills/marketplace-report-crawler/scripts/session-manager.sh +0 -349
  52. package/skills/marketplace-report-crawler/scripts/setup-folders.sh +0 -83
  53. package/skills/medical-research/SKILL.md +0 -194
  54. package/skills/medical-research/scripts/evidence_checker.py +0 -288
  55. package/skills/mom-test/SKILL.md +0 -267
  56. package/skills/mom-test/references/avoiding-bad-data.md +0 -221
  57. package/skills/mom-test/references/case-studies.md +0 -306
  58. package/skills/mom-test/references/commitment-advancement.md +0 -219
  59. package/skills/mom-test/references/finding-conversations.md +0 -251
  60. package/skills/mom-test/references/processing-learning.md +0 -256
  61. package/skills/mom-test/references/question-patterns.md +0 -198
  62. package/skills/pandasai-analytics/SKILL.md +0 -251
  63. package/skills/release-it/SKILL.md +0 -235
  64. package/skills/release-it/references/anti-patterns.md +0 -279
  65. package/skills/release-it/references/capacity-planning.md +0 -285
  66. package/skills/release-it/references/chaos-engineering.md +0 -325
  67. package/skills/release-it/references/deployment-strategies.md +0 -331
  68. package/skills/release-it/references/observability.md +0 -301
  69. package/skills/release-it/references/stability-patterns.md +0 -355
  70. package/skills/skill-creator-ultra/.agents/workflows/skill-audit.md +0 -37
  71. package/skills/skill-creator-ultra/.agents/workflows/skill-compare.md +0 -34
  72. package/skills/skill-creator-ultra/.agents/workflows/skill-export.md +0 -51
  73. package/skills/skill-creator-ultra/.agents/workflows/skill-generate.md +0 -39
  74. package/skills/skill-creator-ultra/.agents/workflows/skill-scaffold.md +0 -52
  75. package/skills/skill-creator-ultra/.agents/workflows/skill-simulate.md +0 -25
  76. package/skills/skill-creator-ultra/.agents/workflows/skill-stats.md +0 -31
  77. package/skills/skill-creator-ultra/.agents/workflows/skill-validate.md +0 -25
  78. package/skills/skill-creator-ultra/README.md +0 -1242
  79. package/skills/skill-creator-ultra/SKILL.md +0 -388
  80. package/skills/skill-creator-ultra/agents/analyzer.md +0 -274
  81. package/skills/skill-creator-ultra/agents/comparator.md +0 -202
  82. package/skills/skill-creator-ultra/agents/grader.md +0 -223
  83. package/skills/skill-creator-ultra/assets/eval_review.html +0 -146
  84. package/skills/skill-creator-ultra/eval-viewer/generate_review.py +0 -471
  85. package/skills/skill-creator-ultra/eval-viewer/viewer.html +0 -1325
  86. package/skills/skill-creator-ultra/examples/example_anthropic_frontend.md +0 -109
  87. package/skills/skill-creator-ultra/examples/example_anthropic_pdf.md +0 -116
  88. package/skills/skill-creator-ultra/examples/example_api_docs.md +0 -189
  89. package/skills/skill-creator-ultra/examples/example_db_migration.md +0 -253
  90. package/skills/skill-creator-ultra/examples/example_git_commit.md +0 -111
  91. package/skills/skill-creator-ultra/install.ps1 +0 -289
  92. package/skills/skill-creator-ultra/install.sh +0 -313
  93. package/skills/skill-creator-ultra/phases/phase1_interview.md +0 -202
  94. package/skills/skill-creator-ultra/phases/phase2_extract.md +0 -55
  95. package/skills/skill-creator-ultra/phases/phase3_detect.md +0 -57
  96. package/skills/skill-creator-ultra/phases/phase4_generate.md +0 -543
  97. package/skills/skill-creator-ultra/phases/phase5_test.md +0 -319
  98. package/skills/skill-creator-ultra/phases/phase6_eval.md +0 -301
  99. package/skills/skill-creator-ultra/phases/phase7_iterate.md +0 -103
  100. package/skills/skill-creator-ultra/phases/phase8_optimize.md +0 -113
  101. package/skills/skill-creator-ultra/resources/advanced_patterns.md +0 -499
  102. package/skills/skill-creator-ultra/resources/anti_patterns.md +0 -376
  103. package/skills/skill-creator-ultra/resources/blueprints.md +0 -498
  104. package/skills/skill-creator-ultra/resources/checklist.md +0 -243
  105. package/skills/skill-creator-ultra/resources/composition_cookbook.md +0 -291
  106. package/skills/skill-creator-ultra/resources/description_optimization.md +0 -90
  107. package/skills/skill-creator-ultra/resources/eval_guide.md +0 -133
  108. package/skills/skill-creator-ultra/resources/industry_questions.md +0 -189
  109. package/skills/skill-creator-ultra/resources/interview_questions.md +0 -200
  110. package/skills/skill-creator-ultra/resources/pattern_detection.md +0 -200
  111. package/skills/skill-creator-ultra/resources/prompt_engineering.md +0 -531
  112. package/skills/skill-creator-ultra/resources/schemas.md +0 -430
  113. package/skills/skill-creator-ultra/resources/script_integration.md +0 -593
  114. package/skills/skill-creator-ultra/resources/scripts_guide.md +0 -339
  115. package/skills/skill-creator-ultra/resources/skill_template.md +0 -124
  116. package/skills/skill-creator-ultra/resources/skill_writing_guide.md +0 -634
  117. package/skills/skill-creator-ultra/resources/versioning_guide.md +0 -193
  118. package/skills/skill-creator-ultra/scripts/ci_eval.py +0 -200
  119. package/skills/skill-creator-ultra/scripts/package_skill.py +0 -165
  120. package/skills/skill-creator-ultra/scripts/simulate_skill.py +0 -398
  121. package/skills/skill-creator-ultra/scripts/skill_audit.py +0 -611
  122. package/skills/skill-creator-ultra/scripts/skill_compare.py +0 -265
  123. package/skills/skill-creator-ultra/scripts/skill_export.py +0 -334
  124. package/skills/skill-creator-ultra/scripts/skill_scaffold.py +0 -403
  125. package/skills/skill-creator-ultra/scripts/skill_stats.py +0 -339
  126. package/skills/skill-creator-ultra/scripts/validate_skill.py +0 -411
  127. package/skills/tailwind-mastery/SKILL.md +0 -229
  128. package/skills/vercel-react-best-practices/AGENTS.md +0 -3373
  129. package/skills/vercel-react-best-practices/README.md +0 -123
  130. package/skills/vercel-react-best-practices/SKILL.md +0 -143
  131. package/skills/vercel-react-best-practices/rules/_sections.md +0 -46
  132. package/skills/vercel-react-best-practices/rules/_template.md +0 -28
  133. package/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +0 -55
  134. package/skills/vercel-react-best-practices/rules/advanced-init-once.md +0 -42
  135. package/skills/vercel-react-best-practices/rules/advanced-use-latest.md +0 -39
  136. package/skills/vercel-react-best-practices/rules/async-api-routes.md +0 -38
  137. package/skills/vercel-react-best-practices/rules/async-defer-await.md +0 -80
  138. package/skills/vercel-react-best-practices/rules/async-dependencies.md +0 -51
  139. package/skills/vercel-react-best-practices/rules/async-parallel.md +0 -28
  140. package/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +0 -99
  141. package/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +0 -59
  142. package/skills/vercel-react-best-practices/rules/bundle-conditional.md +0 -31
  143. package/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +0 -49
  144. package/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +0 -35
  145. package/skills/vercel-react-best-practices/rules/bundle-preload.md +0 -50
  146. package/skills/vercel-react-best-practices/rules/client-event-listeners.md +0 -74
  147. package/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +0 -71
  148. package/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +0 -48
  149. package/skills/vercel-react-best-practices/rules/client-swr-dedup.md +0 -56
  150. package/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +0 -107
  151. package/skills/vercel-react-best-practices/rules/js-cache-function-results.md +0 -80
  152. package/skills/vercel-react-best-practices/rules/js-cache-property-access.md +0 -28
  153. package/skills/vercel-react-best-practices/rules/js-cache-storage.md +0 -70
  154. package/skills/vercel-react-best-practices/rules/js-combine-iterations.md +0 -32
  155. package/skills/vercel-react-best-practices/rules/js-early-exit.md +0 -50
  156. package/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +0 -60
  157. package/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +0 -45
  158. package/skills/vercel-react-best-practices/rules/js-index-maps.md +0 -37
  159. package/skills/vercel-react-best-practices/rules/js-length-check-first.md +0 -49
  160. package/skills/vercel-react-best-practices/rules/js-min-max-loop.md +0 -82
  161. package/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +0 -24
  162. package/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +0 -57
  163. package/skills/vercel-react-best-practices/rules/rendering-activity.md +0 -26
  164. package/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +0 -47
  165. package/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +0 -40
  166. package/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +0 -38
  167. package/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +0 -46
  168. package/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +0 -82
  169. package/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +0 -30
  170. package/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +0 -85
  171. package/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +0 -68
  172. package/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +0 -28
  173. package/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +0 -75
  174. package/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +0 -39
  175. package/skills/vercel-react-best-practices/rules/rerender-dependencies.md +0 -45
  176. package/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +0 -40
  177. package/skills/vercel-react-best-practices/rules/rerender-derived-state.md +0 -29
  178. package/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +0 -74
  179. package/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +0 -58
  180. package/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +0 -38
  181. package/skills/vercel-react-best-practices/rules/rerender-memo.md +0 -44
  182. package/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +0 -45
  183. package/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +0 -82
  184. package/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +0 -35
  185. package/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +0 -64
  186. package/skills/vercel-react-best-practices/rules/rerender-transitions.md +0 -40
  187. package/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +0 -59
  188. package/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +0 -73
  189. package/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +0 -73
  190. package/skills/vercel-react-best-practices/rules/server-auth-actions.md +0 -96
  191. package/skills/vercel-react-best-practices/rules/server-cache-lru.md +0 -41
  192. package/skills/vercel-react-best-practices/rules/server-cache-react.md +0 -76
  193. package/skills/vercel-react-best-practices/rules/server-dedup-props.md +0 -65
  194. package/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +0 -142
  195. package/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +0 -83
  196. package/skills/vercel-react-best-practices/rules/server-serialization.md +0 -38
  197. 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
- ---