@mison/ag-kit-cn 2.0.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 (237) hide show
  1. package/.agent/.shared/ui-ux-pro-max/data/charts.csv +26 -0
  2. package/.agent/.shared/ui-ux-pro-max/data/colors.csv +97 -0
  3. package/.agent/.shared/ui-ux-pro-max/data/icons.csv +101 -0
  4. package/.agent/.shared/ui-ux-pro-max/data/landing.csv +31 -0
  5. package/.agent/.shared/ui-ux-pro-max/data/products.csv +97 -0
  6. package/.agent/.shared/ui-ux-pro-max/data/prompts.csv +24 -0
  7. package/.agent/.shared/ui-ux-pro-max/data/react-performance.csv +45 -0
  8. package/.agent/.shared/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  9. package/.agent/.shared/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  10. package/.agent/.shared/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  11. package/.agent/.shared/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  12. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  13. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  14. package/.agent/.shared/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  15. package/.agent/.shared/ui-ux-pro-max/data/stacks/react.csv +54 -0
  16. package/.agent/.shared/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  17. package/.agent/.shared/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  18. package/.agent/.shared/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  19. package/.agent/.shared/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  20. package/.agent/.shared/ui-ux-pro-max/data/styles.csv +59 -0
  21. package/.agent/.shared/ui-ux-pro-max/data/typography.csv +58 -0
  22. package/.agent/.shared/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  23. package/.agent/.shared/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  24. package/.agent/.shared/ui-ux-pro-max/data/web-interface.csv +31 -0
  25. package/.agent/.shared/ui-ux-pro-max/scripts/core.py +258 -0
  26. package/.agent/.shared/ui-ux-pro-max/scripts/design_system.py +1067 -0
  27. package/.agent/.shared/ui-ux-pro-max/scripts/search.py +106 -0
  28. package/.agent/ARCHITECTURE.md +285 -0
  29. package/.agent/agents/backend-specialist.md +268 -0
  30. package/.agent/agents/code-archaeologist.md +106 -0
  31. package/.agent/agents/database-architect.md +225 -0
  32. package/.agent/agents/debugger.md +225 -0
  33. package/.agent/agents/devops-engineer.md +242 -0
  34. package/.agent/agents/documentation-writer.md +104 -0
  35. package/.agent/agents/explorer-agent.md +73 -0
  36. package/.agent/agents/frontend-specialist.md +618 -0
  37. package/.agent/agents/game-developer.md +162 -0
  38. package/.agent/agents/mobile-developer.md +382 -0
  39. package/.agent/agents/orchestrator.md +438 -0
  40. package/.agent/agents/penetration-tester.md +188 -0
  41. package/.agent/agents/performance-optimizer.md +187 -0
  42. package/.agent/agents/product-manager.md +112 -0
  43. package/.agent/agents/product-owner.md +95 -0
  44. package/.agent/agents/project-planner.md +405 -0
  45. package/.agent/agents/qa-automation-engineer.md +103 -0
  46. package/.agent/agents/security-auditor.md +170 -0
  47. package/.agent/agents/seo-specialist.md +111 -0
  48. package/.agent/agents/test-engineer.md +158 -0
  49. package/.agent/mcp_config.json +12 -0
  50. package/.agent/rules/GEMINI.md +273 -0
  51. package/.agent/scripts/auto_preview.py +148 -0
  52. package/.agent/scripts/checklist.py +217 -0
  53. package/.agent/scripts/session_manager.py +120 -0
  54. package/.agent/scripts/verify_all.py +327 -0
  55. package/.agent/skills/api-patterns/SKILL.md +84 -0
  56. package/.agent/skills/api-patterns/api-style.md +42 -0
  57. package/.agent/skills/api-patterns/auth.md +24 -0
  58. package/.agent/skills/api-patterns/documentation.md +26 -0
  59. package/.agent/skills/api-patterns/graphql.md +41 -0
  60. package/.agent/skills/api-patterns/rate-limiting.md +31 -0
  61. package/.agent/skills/api-patterns/response.md +37 -0
  62. package/.agent/skills/api-patterns/rest.md +40 -0
  63. package/.agent/skills/api-patterns/scripts/api_validator.py +211 -0
  64. package/.agent/skills/api-patterns/security-testing.md +122 -0
  65. package/.agent/skills/api-patterns/trpc.md +41 -0
  66. package/.agent/skills/api-patterns/versioning.md +22 -0
  67. package/.agent/skills/app-builder/SKILL.md +75 -0
  68. package/.agent/skills/app-builder/agent-coordination.md +74 -0
  69. package/.agent/skills/app-builder/feature-building.md +53 -0
  70. package/.agent/skills/app-builder/project-detection.md +34 -0
  71. package/.agent/skills/app-builder/scaffolding.md +118 -0
  72. package/.agent/skills/app-builder/tech-stack.md +40 -0
  73. package/.agent/skills/app-builder/templates/SKILL.md +39 -0
  74. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  75. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  76. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  77. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  78. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  79. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  80. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  81. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
  82. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
  83. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
  84. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
  85. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  86. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
  87. package/.agent/skills/architecture/SKILL.md +57 -0
  88. package/.agent/skills/architecture/context-discovery.md +43 -0
  89. package/.agent/skills/architecture/examples.md +94 -0
  90. package/.agent/skills/architecture/pattern-selection.md +68 -0
  91. package/.agent/skills/architecture/patterns-reference.md +50 -0
  92. package/.agent/skills/architecture/trade-off-analysis.md +77 -0
  93. package/.agent/skills/bash-linux/SKILL.md +201 -0
  94. package/.agent/skills/behavioral-modes/SKILL.md +264 -0
  95. package/.agent/skills/brainstorming/SKILL.md +164 -0
  96. package/.agent/skills/brainstorming/dynamic-questioning.md +359 -0
  97. package/.agent/skills/clean-code/SKILL.md +200 -0
  98. package/.agent/skills/code-review-checklist/SKILL.md +125 -0
  99. package/.agent/skills/database-design/SKILL.md +54 -0
  100. package/.agent/skills/database-design/database-selection.md +43 -0
  101. package/.agent/skills/database-design/indexing.md +39 -0
  102. package/.agent/skills/database-design/migrations.md +50 -0
  103. package/.agent/skills/database-design/optimization.md +36 -0
  104. package/.agent/skills/database-design/orm-selection.md +30 -0
  105. package/.agent/skills/database-design/schema-design.md +56 -0
  106. package/.agent/skills/database-design/scripts/schema_validator.py +172 -0
  107. package/.agent/skills/deployment-procedures/SKILL.md +241 -0
  108. package/.agent/skills/doc.md +177 -0
  109. package/.agent/skills/documentation-templates/SKILL.md +194 -0
  110. package/.agent/skills/frontend-design/SKILL.md +418 -0
  111. package/.agent/skills/frontend-design/animation-guide.md +331 -0
  112. package/.agent/skills/frontend-design/color-system.md +307 -0
  113. package/.agent/skills/frontend-design/decision-trees.md +418 -0
  114. package/.agent/skills/frontend-design/motion-graphics.md +306 -0
  115. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  116. package/.agent/skills/frontend-design/scripts/ux_audit.py +727 -0
  117. package/.agent/skills/frontend-design/typography-system.md +345 -0
  118. package/.agent/skills/frontend-design/ux-psychology.md +1118 -0
  119. package/.agent/skills/frontend-design/visual-effects.md +383 -0
  120. package/.agent/skills/game-development/2d-games/SKILL.md +119 -0
  121. package/.agent/skills/game-development/3d-games/SKILL.md +135 -0
  122. package/.agent/skills/game-development/SKILL.md +167 -0
  123. package/.agent/skills/game-development/game-art/SKILL.md +185 -0
  124. package/.agent/skills/game-development/game-audio/SKILL.md +190 -0
  125. package/.agent/skills/game-development/game-design/SKILL.md +129 -0
  126. package/.agent/skills/game-development/mobile-games/SKILL.md +108 -0
  127. package/.agent/skills/game-development/multiplayer/SKILL.md +132 -0
  128. package/.agent/skills/game-development/pc-games/SKILL.md +144 -0
  129. package/.agent/skills/game-development/vr-ar/SKILL.md +123 -0
  130. package/.agent/skills/game-development/web-games/SKILL.md +150 -0
  131. package/.agent/skills/geo-fundamentals/SKILL.md +155 -0
  132. package/.agent/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  133. package/.agent/skills/i18n-localization/SKILL.md +154 -0
  134. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  135. package/.agent/skills/intelligent-routing/SKILL.md +335 -0
  136. package/.agent/skills/lint-and-validate/SKILL.md +44 -0
  137. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  138. package/.agent/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  139. package/.agent/skills/mcp-builder/SKILL.md +176 -0
  140. package/.agent/skills/mobile-design/SKILL.md +394 -0
  141. package/.agent/skills/mobile-design/decision-trees.md +516 -0
  142. package/.agent/skills/mobile-design/mobile-backend.md +491 -0
  143. package/.agent/skills/mobile-design/mobile-color-system.md +420 -0
  144. package/.agent/skills/mobile-design/mobile-debugging.md +122 -0
  145. package/.agent/skills/mobile-design/mobile-design-thinking.md +355 -0
  146. package/.agent/skills/mobile-design/mobile-navigation.md +458 -0
  147. package/.agent/skills/mobile-design/mobile-performance.md +767 -0
  148. package/.agent/skills/mobile-design/mobile-testing.md +356 -0
  149. package/.agent/skills/mobile-design/mobile-typography.md +432 -0
  150. package/.agent/skills/mobile-design/platform-android.md +666 -0
  151. package/.agent/skills/mobile-design/platform-ios.md +561 -0
  152. package/.agent/skills/mobile-design/scripts/mobile_audit.py +670 -0
  153. package/.agent/skills/mobile-design/touch-psychology.md +537 -0
  154. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +311 -0
  155. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +241 -0
  156. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +489 -0
  157. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +263 -0
  158. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
  159. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +431 -0
  160. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +683 -0
  161. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +149 -0
  162. package/.agent/skills/nextjs-react-expert/SKILL.md +286 -0
  163. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  164. package/.agent/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  165. package/.agent/skills/nodejs-best-practices/SKILL.md +333 -0
  166. package/.agent/skills/parallel-agents/SKILL.md +194 -0
  167. package/.agent/skills/performance-profiling/SKILL.md +149 -0
  168. package/.agent/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  169. package/.agent/skills/plan-writing/SKILL.md +152 -0
  170. package/.agent/skills/powershell-windows/SKILL.md +166 -0
  171. package/.agent/skills/python-patterns/SKILL.md +441 -0
  172. package/.agent/skills/red-team-tactics/SKILL.md +203 -0
  173. package/.agent/skills/rust-pro/SKILL.md +190 -0
  174. package/.agent/skills/seo-fundamentals/SKILL.md +135 -0
  175. package/.agent/skills/seo-fundamentals/scripts/seo_checker.py +215 -0
  176. package/.agent/skills/server-management/SKILL.md +161 -0
  177. package/.agent/skills/systematic-debugging/SKILL.md +114 -0
  178. package/.agent/skills/tailwind-patterns/SKILL.md +269 -0
  179. package/.agent/skills/tdd-workflow/SKILL.md +149 -0
  180. package/.agent/skills/testing-patterns/SKILL.md +178 -0
  181. package/.agent/skills/testing-patterns/scripts/test_runner.py +219 -0
  182. package/.agent/skills/vulnerability-scanner/SKILL.md +276 -0
  183. package/.agent/skills/vulnerability-scanner/checklists.md +131 -0
  184. package/.agent/skills/vulnerability-scanner/scripts/security_scan.py +459 -0
  185. package/.agent/skills/web-design-guidelines/SKILL.md +57 -0
  186. package/.agent/skills/webapp-testing/SKILL.md +187 -0
  187. package/.agent/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  188. package/.agent/workflows/brainstorm.md +113 -0
  189. package/.agent/workflows/create.md +59 -0
  190. package/.agent/workflows/debug.md +103 -0
  191. package/.agent/workflows/deploy.md +176 -0
  192. package/.agent/workflows/enhance.md +63 -0
  193. package/.agent/workflows/orchestrate.md +242 -0
  194. package/.agent/workflows/plan.md +89 -0
  195. package/.agent/workflows/preview.md +80 -0
  196. package/.agent/workflows/restore-localize-compat.md +525 -0
  197. package/.agent/workflows/status.md +86 -0
  198. package/.agent/workflows/test.md +144 -0
  199. package/.agent/workflows/ui-ux-pro-max.md +295 -0
  200. package/AGENT_FLOW.md +609 -0
  201. package/CHANGELOG.md +68 -0
  202. package/LICENSE +21 -0
  203. package/README.md +260 -0
  204. package/bin/adapters/base.js +63 -0
  205. package/bin/adapters/codex.js +391 -0
  206. package/bin/adapters/gemini.js +137 -0
  207. package/bin/ag-kit.js +1336 -0
  208. package/bin/core/builder.js +80 -0
  209. package/bin/core/generator.js +59 -0
  210. package/bin/core/resource-loader.js +64 -0
  211. package/bin/core/transformer.js +208 -0
  212. package/bin/interactive.js +65 -0
  213. package/bin/utils/atomic-writer.js +97 -0
  214. package/bin/utils/git-helper.js +68 -0
  215. package/bin/utils/managed-block.js +65 -0
  216. package/bin/utils/manifest.js +241 -0
  217. package/bin/utils.js +82 -0
  218. package/docs/codex-rules-template.md +36 -0
  219. package/docs/mapping-spec.md +68 -0
  220. package/docs/multi-target-adapter.md +80 -0
  221. package/docs/official/README.md +53 -0
  222. package/docs/official/antigravity/agent-modes-settings.md +64 -0
  223. package/docs/official/antigravity/rules-workflows.md +96 -0
  224. package/docs/official/antigravity/skills.md +147 -0
  225. package/docs/official/codex/agents-md.md +119 -0
  226. package/docs/official/codex/config-advanced.md +358 -0
  227. package/docs/official/codex/config-basic.md +141 -0
  228. package/docs/official/codex/config-reference.md +223 -0
  229. package/docs/official/codex/config-sample.md +216 -0
  230. package/docs/official/codex/mcp.md +107 -0
  231. package/docs/official/codex/rules.md +79 -0
  232. package/docs/official/codex/skills.md +114 -0
  233. package/docs/official/sources-index.md +32 -0
  234. package/docs/operations.md +145 -0
  235. package/docs/terminology-style-guide.md +69 -0
  236. package/package.json +51 -0
  237. package/scripts/postinstall-check.js +112 -0
package/AGENT_FLOW.md ADDED
@@ -0,0 +1,609 @@
1
+ # 🔄 智能体流程架构
2
+
3
+ > **Antigravity Kit** - 完整的 AI 智能体工作流文档
4
+
5
+ ---
6
+
7
+ ## 📊 全流程概览图
8
+
9
+ ```
10
+ ┌─────────────────────────────────────────────────────────────────┐
11
+ │ USER REQUEST │
12
+ └────────────────────────────┬────────────────────────────────────┘
13
+
14
+
15
+ ┌─────────────────────────────────────────────────────────────────┐
16
+ │ REQUEST CLASSIFICATION │
17
+ │ • Analyze intent (build, debug, test, deploy, etc.) │
18
+ │ • Identify domain (frontend, backend, mobile, etc.) │
19
+ │ • Detect complexity (simple, medium, complex) │
20
+ └────────────────────────────┬────────────────────────────────────┘
21
+
22
+ ┌────────────┴────────────┐
23
+ │ │
24
+ ▼ ▼
25
+ ┌───────────────────┐ ┌──────────────────┐
26
+ │ WORKFLOW COMMAND │ │ DIRECT AGENT │
27
+ │ (Slash Command) │ │ ASSIGNMENT │
28
+ └─────────┬─────────┘ └────────┬─────────┘
29
+ │ │
30
+ ▼ ▼
31
+ ┌───────────────────┐ ┌──────────────────┐
32
+ │ /brainstorm │ │ Agent Selection │
33
+ │ /create │ │ Based on Domain │
34
+ │ /debug │ │ │
35
+ │ /deploy │ │ • frontend-* │
36
+ │ /enhance │ │ • backend-* │
37
+ │ /orchestrate │ │ • mobile-* │
38
+ │ /plan │ │ • database-* │
39
+ │ /preview │ │ • devops-* │
40
+ │ /status │ │ • test-* │
41
+ │ /test │ │ • security-* │
42
+ │ /ui-ux-pro-max │ │ • game-* │
43
+ └─────────┬─────────┘ └────────┬─────────┘
44
+ │ │
45
+ └────────────┬────────────┘
46
+
47
+
48
+ ┌─────────────────────────────────────┐
49
+ │ AGENT INITIALIZATION │
50
+ │ • Load agent persona/role │
51
+ │ • Load required skills │
52
+ │ • Set behavioral mode │
53
+ └──────────────┬──────────────────────┘
54
+
55
+
56
+ ┌─────────────────────────────────────┐
57
+ │ SKILL LOADING PROTOCOL │
58
+ │ │
59
+ │ 1. Read SKILL.md metadata │
60
+ │ 2. Load references/ (if needed) │
61
+ │ 3. Execute scripts/ (if needed) │
62
+ │ 4. Apply rules and patterns │
63
+ └──────────────┬──────────────────────┘
64
+
65
+
66
+ ┌─────────────────────────────────────┐
67
+ │ TASK EXECUTION │
68
+ │ │
69
+ │ • Analyze codebase │
70
+ │ • Apply best practices │
71
+ │ • Generate/modify code │
72
+ │ • Run validations │
73
+ │ • Execute tests │
74
+ └──────────────┬──────────────────────┘
75
+
76
+
77
+ ┌─────────────────────────────────────┐
78
+ │ VALIDATION LAYER │
79
+ │ │
80
+ │ Quick Check (checklist.py): │
81
+ │ • Security scan │
82
+ │ • Code quality (lint/types) │
83
+ │ • Schema validation │
84
+ │ • Test suite │
85
+ │ • UX audit │
86
+ │ • SEO check │
87
+ │ │
88
+ │ Full Check (verify_all.py): │
89
+ │ • All above + Lighthouse │
90
+ │ • E2E tests (Playwright) │
91
+ │ • Bundle analysis │
92
+ │ • Mobile audit │
93
+ │ • i18n check │
94
+ └──────────────┬──────────────────────┘
95
+
96
+
97
+ ┌─────────────────────────────────────┐
98
+ │ RESULT DELIVERY │
99
+ │ • Present changes to user │
100
+ │ • Provide explanations │
101
+ │ • Suggest next steps │
102
+ └─────────────────────────────────────┘
103
+ ```
104
+
105
+ ---
106
+
107
+ ## 🎯 智能体详细流程
108
+
109
+ ### 1️⃣ **请求入口类型**
110
+
111
+ ```
112
+ User Input Types:
113
+ ┌─────────────────────────────────────────────────────────────┐
114
+ │ A. Natural Language Request │
115
+ │ "Build a React dashboard with charts" │
116
+ │ │
117
+ │ B. Slash Command │
118
+ │ "/create feature: user authentication" │
119
+ │ │
120
+ │ C. Domain-Specific Request │
121
+ │ "Optimize database queries" → database-architect │
122
+ │ "Fix security vulnerability" → security-auditor │
123
+ │ "Deploy to AWS" → devops-engineer │
124
+ └─────────────────────────────────────────────────────────────┘
125
+ ```
126
+
127
+ #### 苏格拉底门禁协议
128
+
129
+ 在实现前先确认:
130
+
131
+ - **新功能** → 至少提出 3 个战略性问题
132
+ - **Bug 修复** → 确认理解 + 询问影响
133
+ - **模糊请求** → 询问目的、用户、范围
134
+
135
+ ### 2️⃣ **智能体选择矩阵**
136
+
137
+ #### 智能体路由检查清单(强制)
138
+
139
+ 在任何代码/设计工作之前:
140
+
141
+ | 步骤 | 检查项 | 未满足时 |
142
+ | ---- | ---------------------------- | ---------------------------------------- |
143
+ | 1 | 识别正确智能体 | → 分析请求领域 |
144
+ | 2 | 阅读智能体的 .md 文件 | → 打开 `.agent/agents/{agent}.md` |
145
+ | 3 | 宣布智能体 | → `🤖 Applying knowledge of @[agent]...` |
146
+ | 4 | 从 frontmatter 加载 skills | → 检查 `skills:` 字段 |
147
+
148
+ ```
149
+ Request Domain → Agent Mapping:
150
+
151
+ ┌──────────────────────┬─────────────────────┬──────────────────────────┐
152
+ │ Domain │ Primary Agent │ Skills Loaded │
153
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
154
+ │ UI/UX Design │ frontend-specialist │ nextjs-react-expert │
155
+ │ │ │ frontend-design │
156
+ │ │ │ tailwind-patterns │
157
+ │ │ │ web-design-guidelines │
158
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
159
+ │ API Development │ backend-specialist │ api-patterns │
160
+ │ │ │ nodejs-best-practices │
161
+ │ │ │ rust-pro │
162
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
163
+ │ Database Design │ database-architect │ database-design │
164
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
165
+ │ Mobile App │ mobile-developer │ mobile-design │
166
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
167
+ │ Game Development │ game-developer │ game-development │
168
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
169
+ │ DevOps/Deployment │ devops-engineer │ docker-expert │
170
+ │ │ │ deployment-procedures │
171
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
172
+ │ Security Audit │ security-auditor │ vulnerability-scanner │
173
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
174
+ │ Penetration Testing │ penetration-tester │ red-team-tactics │
175
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
176
+ │ Testing │ test-engineer │ testing-patterns │
177
+ │ │ │ webapp-testing │
178
+ │ │ │ tdd-workflow │
179
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
180
+ │ Debugging │ debugger │ systematic-debugging │
181
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
182
+ │ Performance │ performance- │ performance-profiling │
183
+ │ │ optimizer │ │
184
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
185
+ │ SEO │ seo-specialist │ seo-fundamentals │
186
+ │ │ │ geo-fundamentals │
187
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
188
+ │ Documentation │ documentation- │ documentation-templates │
189
+ │ │ writer │ │
190
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
191
+ │ Planning/Discovery │ project-planner │ brainstorming │
192
+ │ │ │ plan-writing │
193
+ │ │ │ architecture │
194
+ ├──────────────────────┼─────────────────────┼──────────────────────────┤
195
+ │ Multi-Agent Tasks │ orchestrator │ parallel-agents │
196
+ │ │ │ behavioral-modes │
197
+ └──────────────────────┴─────────────────────┴──────────────────────────┘
198
+ ```
199
+
200
+ ### 3️⃣ **技能加载协议**
201
+
202
+ ```
203
+ ┌─────────────────────────────────────────────────────────────┐
204
+ │ SKILL LOADING FLOW │
205
+ └─────────────────────────────────────────────────────────────┘
206
+
207
+ Step 1: Match Request to Skill
208
+ ┌──────────────────────────────────────────┐
209
+ │ User: "Build a REST API" │
210
+ │ ↓ │
211
+ │ Keyword Match: "API" → api-patterns │
212
+ └──────────────────────────────────────────┘
213
+
214
+ Step 2: Load Skill Metadata
215
+ ┌──────────────────────────────────────────┐
216
+ │ Read: .agent/skills/api-patterns/ │
217
+ │ └── SKILL.md (main instructions) │
218
+ └──────────────────────────────────────────┘
219
+
220
+ Step 3: Load References (if needed)
221
+ ┌──────────────────────────────────────────┐
222
+ │ Read: api-patterns/rest.md │
223
+ │ api-patterns/graphql.md │
224
+ │ api-patterns/auth.md │
225
+ │ api-patterns/documentation.md │
226
+ └──────────────────────────────────────────┘
227
+
228
+ Step 4: Execute Scripts (if needed)
229
+ ┌──────────────────────────────────────────┐
230
+ │ Run: scripts/api_validator.py │
231
+ │ (validates API design) │
232
+ └──────────────────────────────────────────┘
233
+
234
+ Step 5: Apply Knowledge
235
+ ┌──────────────────────────────────────────┐
236
+ │ Agent now has: │
237
+ │ • API design patterns │
238
+ │ • Authentication strategies │
239
+ │ • Documentation templates │
240
+ │ • Validation scripts │
241
+ └──────────────────────────────────────────┘
242
+ ```
243
+
244
+ ### 相关技能模式
245
+
246
+ Skills(技能)相互联动:
247
+ - `frontend-design` → `web-design-guidelines`(编码后)
248
+ - `web-design-guidelines` → `frontend-design`(编码前)
249
+
250
+ > **注意**:Scripts(脚本)不会自动执行。AI 仅提出运行建议,需用户确认。
251
+
252
+ ### 4️⃣ **工作流命令执行**
253
+
254
+ ```
255
+ Slash Command Flow:
256
+
257
+ /brainstorm
258
+
259
+ 1. Load: brainstorming skill
260
+ 2. Apply: Socratic questioning
261
+ 3. Output: Structured discovery document
262
+
263
+ /create
264
+
265
+ 1. Detect: Project type (web/mobile/api/game)
266
+ 2. Load: app-builder skill + domain-specific skills
267
+ 3. Select: Template from app-builder/templates/
268
+ 4. Scaffold: Generate project structure
269
+ 5. Validate: Run checklist.py
270
+
271
+ /debug
272
+
273
+ 1. Load: systematic-debugging skill
274
+ 2. Analyze: Error logs, stack traces
275
+ 3. Apply: Root cause analysis
276
+ 4. Suggest: Fix with code examples
277
+ 5. Test: Verify fix works
278
+
279
+ /deploy
280
+
281
+ 1. Load: deployment-procedures skill
282
+ 2. Detect: Platform (Vercel, AWS, Docker, etc.)
283
+ 3. Prepare: Build artifacts
284
+ 4. Execute: Deployment scripts
285
+ 5. Verify: Health checks
286
+ 6. Output: Deployment URL
287
+
288
+ /test
289
+
290
+ 1. Load: testing-patterns + webapp-testing skills
291
+ 2. Detect: Test framework (Jest, Vitest, Playwright)
292
+ 3. Generate: Test cases
293
+ 4. Execute: Run tests
294
+ 5. Report: Coverage + results
295
+
296
+ /orchestrate
297
+
298
+ 1. Load: parallel-agents skill
299
+ 2. Decompose: Task into subtasks
300
+ 3. Assign: Each subtask to specialist agent
301
+ 4. Coordinate: Parallel execution
302
+ 5. Merge: Combine results
303
+ 6. Validate: Run full verification
304
+
305
+ /plan
306
+
307
+ 1. Load: plan-writing + architecture skills
308
+ 2. Analyze: Requirements
309
+ 3. Break down: Tasks with estimates
310
+ 4. Output: Structured plan with milestones
311
+
312
+ /restore-localize-compat
313
+
314
+ 1. Load: i18n-localization + intelligent-routing skills
315
+ 2. Compare: current doc vs reference baseline
316
+ 3. Restore: mechanism structure first
317
+ 4. Localize: semantic Chinese translation only
318
+ 5. Verify: compatibility notes remain minimal
319
+
320
+ /ui-ux-pro-max
321
+
322
+ 1. Load: ui-ux-pro-max skill
323
+ 2. Access: 50 design styles
324
+ 3. Access: 21 color palettes
325
+ 4. Access: 50 font combinations
326
+ 5. Generate: Professional UI with selected style
327
+ ```
328
+
329
+ ### 5️⃣ **多智能体编排**
330
+
331
+ ```
332
+ Complex Task → /orchestrate → Multiple Specialist Personas
333
+
334
+ Example: "Build a full-stack e-commerce app"
335
+
336
+ ┌─────────────────────────────────────────────────────────────┐
337
+ │ ORCHESTRATOR AGENT │
338
+ │ Decomposes task into sequential workstreams │
339
+ └─────────────────────────────────────────────────────────────┘
340
+
341
+ ┌─────────────────────┼─────────────────────┐
342
+ │ │ │
343
+ ▼ ▼ ▼
344
+ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐
345
+ │ FRONTEND │ │ BACKEND │ │ DATABASE │
346
+ │ SPECIALIST │ │ SPECIALIST │ │ ARCHITECT │
347
+ │ │ │ │ │ │
348
+ │ Skills: │ │ Skills: │ │ Skills: │
349
+ │ • react-* │ │ • api-* │ │ • database-* │
350
+ │ • nextjs-* │ │ • nodejs-* │ │ • prisma-* │
351
+ │ • tailwind-* │ │ • nestjs-* │ │ │
352
+ │ │ │ │ │ │
353
+ │ Builds: │ │ Builds: │ │ Builds: │
354
+ │ • UI/UX │ │ • REST API │ │ • Schema │
355
+ │ • Components │ │ • Auth │ │ • Migrations │
356
+ │ • Pages │ │ • Business │ │ • Indexes │
357
+ └───────┬───────┘ └───────┬───────┘ └───────┬───────┘
358
+ │ │ │
359
+ └─────────────────┬─┴───────────────────┘
360
+
361
+
362
+ ┌─────────────────────────────────────┐
363
+ │ CODE COHERENCE │
364
+ │ • AI maintains consistency │
365
+ │ • Sequential context switching │
366
+ │ • Ensure API contracts match │
367
+ └──────────────┬──────────────────────┘
368
+
369
+
370
+ ┌─────────────────────────────────────┐
371
+ │ VALIDATION (All Agents) │
372
+ │ • test-engineer → Tests │
373
+ │ • security-auditor → Security │
374
+ │ • performance-optimizer → Perf │
375
+ └──────────────┬──────────────────────┘
376
+
377
+
378
+ ┌─────────────────────────────────────┐
379
+ │ DEPLOYMENT │
380
+ │ • devops-engineer → Deploy │
381
+ └─────────────────────────────────────┘
382
+ ```
383
+
384
+ ### 6️⃣ **验证与质量门禁**
385
+
386
+ ```
387
+ ┌─────────────────────────────────────────────────────────────┐
388
+ │ VALIDATION PIPELINE │
389
+ └─────────────────────────────────────────────────────────────┘
390
+
391
+ During Development (Quick Checks):
392
+ ┌──────────────────────────────────────────┐
393
+ │ python .agent/scripts/checklist.py . │
394
+ ├──────────────────────────────────────────┤
395
+ │ ✓ Security Scan (vulnerabilities) │
396
+ │ ✓ Code Quality (ESLint, TypeScript) │
397
+ │ ✓ Schema Validation (Prisma/DB) │
398
+ │ ✓ Test Suite (Unit tests) │
399
+ │ ✓ UX Audit (Accessibility) │
400
+ │ ✓ SEO Check (Meta tags, performance) │
401
+ └──────────────────────────────────────────┘
402
+ Time: ~30 seconds
403
+
404
+ Pre-Deployment (Full Verification):
405
+ ┌──────────────────────────────────────────────────────┐
406
+ │ python .agent/scripts/verify_all.py . │
407
+ │ --url http://localhost:3000 │
408
+ ├──────────────────────────────────────────────────────┤
409
+ │ ✓ All Quick Checks │
410
+ │ ✓ Lighthouse Audit (Core Web Vitals) │
411
+ │ ✓ Playwright E2E Tests │
412
+ │ ✓ Bundle Analysis (Size, tree-shaking) │
413
+ │ ✓ Mobile Audit (Responsive, touch targets) │
414
+ │ ✓ i18n Check (Translations, locale) │
415
+ └──────────────────────────────────────────────────────┘
416
+ Time: ~3-5 minutes
417
+ ```
418
+
419
+ ---
420
+
421
+ ## 🧩 技能与脚本映射
422
+
423
+ ```
424
+ Skills with Automated Scripts:
425
+
426
+ ┌─────────────────────────┬──────────────────────────────────┐
427
+ │ Skill │ Script │
428
+ ├─────────────────────────┼──────────────────────────────────┤
429
+ │ api-patterns │ scripts/api_validator.py │
430
+ │ database-design │ scripts/schema_validator.py │
431
+ │ frontend-design │ scripts/accessibility_checker.py │
432
+ │ │ scripts/ux_audit.py │
433
+ │ geo-fundamentals │ scripts/geo_checker.py │
434
+ │ i18n-localization │ scripts/i18n_checker.py │
435
+ │ lint-and-validate │ scripts/lint_runner.py │
436
+ │ │ scripts/type_coverage.py │
437
+ │ mobile-design │ scripts/mobile_audit.py │
438
+ │ nextjs-react-expert │ scripts/react_performance_checker.py │
439
+ │ performance-profiling │ scripts/lighthouse_audit.py │
440
+ │ seo-fundamentals │ scripts/seo_checker.py │
441
+ │ testing-patterns │ scripts/test_runner.py │
442
+ │ vulnerability-scanner │ scripts/security_scan.py │
443
+ │ webapp-testing │ scripts/playwright_runner.py │
444
+ └─────────────────────────┴──────────────────────────────────┘
445
+ ```
446
+
447
+ ---
448
+
449
+ ## 🔄 完整请求生命周期示例
450
+
451
+ ```
452
+ User Request: "Build a Next.js dashboard with authentication"
453
+
454
+ 1. REQUEST CLASSIFICATION
455
+ ├─ Type: Build new feature
456
+ ├─ Domain: Frontend + Backend
457
+ ├─ Complexity: Medium-High
458
+ └─ Suggested: /create or /orchestrate
459
+
460
+ 2. WORKFLOW SELECTION
461
+ └─ User chooses: /orchestrate (multi-agent approach)
462
+
463
+ 3. ORCHESTRATOR DECOMPOSITION
464
+ ├─ Frontend: Dashboard UI (React components)
465
+ ├─ Backend: Auth API (JWT, session management)
466
+ ├─ Database: User schema (Prisma)
467
+ └─ Testing: E2E auth flow
468
+
469
+ 4. AGENT ASSIGNMENT
470
+ ├─ frontend-specialist
471
+ │ └─ Skills: nextjs-react-expert, tailwind-patterns, frontend-design
472
+ ├─ backend-specialist
473
+ │ └─ Skills: api-patterns, nodejs-best-practices
474
+ ├─ database-architect
475
+ │ └─ Skills: database-design
476
+ └─ test-engineer
477
+ └─ Skills: testing-patterns, webapp-testing
478
+
479
+ 5. SEQUENTIAL MULTI-DOMAIN EXECUTION
480
+ Note: AI processes each domain sequentially, switching context between specialist "personas."
481
+ This is NOT true parallel execution but simulated multi-agent behavior.
482
+
483
+ ├─ Frontend builds:
484
+ │ ├─ app/dashboard/page.tsx (Server Component)
485
+ │ ├─ components/DashboardLayout.tsx
486
+ │ ├─ components/LoginForm.tsx
487
+ │ └─ lib/auth-client.ts
488
+ ├─ Backend builds:
489
+ │ ├─ app/api/auth/login/route.ts
490
+ │ ├─ app/api/auth/logout/route.ts
491
+ │ ├─ lib/jwt.ts
492
+ │ └─ middleware.ts
493
+ ├─ Database builds:
494
+ │ ├─ prisma/schema.prisma (User, Session models)
495
+ │ └─ prisma/migrations/
496
+ └─ Testing builds:
497
+ ├─ tests/auth.spec.ts (Playwright)
498
+ └─ tests/dashboard.spec.ts
499
+
500
+ 6. CODE INTEGRATION
501
+ Reality Note: AI writes code as a continuous stream, maintaining consistency.
502
+ There is no "merge" step - it's all generated coherently from the start.
503
+
504
+ └─ AI maintains coherence across domains
505
+ ├─ Resolves import paths
506
+ ├─ Ensures type safety
507
+ └─ Connects API routes to UI
508
+
509
+ 7. VALIDATION
510
+ ├─ checklist.py
511
+ │ ✓ Security: No leaked secrets
512
+ │ ✓ Lint: No ESLint errors
513
+ │ ✓ Types: TypeScript passes
514
+ │ ✓ Tests: Auth flow passes
515
+ └─ verify_all.py
516
+ ✓ E2E: Login → Dashboard → Logout works
517
+ ✓ Accessibility: WCAG AA compliant
518
+ ✓ Performance: Lighthouse score > 90
519
+
520
+ 8. RESULT DELIVERY
521
+ └─ User receives:
522
+ ├─ Complete codebase
523
+ ├─ Documentation (how to run)
524
+ ├─ Test reports
525
+ └─ Deployment instructions
526
+ ```
527
+
528
+ ---
529
+
530
+ ## 📈 统计与指标
531
+
532
+ ```
533
+ ┌──────────────────────────────────────────────────────────┐
534
+ │ SYSTEM CAPABILITIES │
535
+ ├──────────────────────────────────────────────────────────┤
536
+ │ Total Agents: 20 │
537
+ │ Total Skills: 36 │
538
+ │ Total Workflows: 11 │
539
+ │ Master Scripts: 2 (checklist, verify_all) │
540
+ │ Skill-Level Scripts: 18 │
541
+ │ Coverage: ~90% web/mobile development │
542
+ │ │
543
+ │ Supported Frameworks: │
544
+ │ ├─ Frontend: React, Next.js, Vue, Nuxt, Astro │
545
+ │ ├─ Backend: Node.js, NestJS, FastAPI, Express │
546
+ │ ├─ Mobile: React Native, Flutter │
547
+ │ ├─ Database: Prisma, TypeORM, Sequelize │
548
+ │ ├─ Testing: Jest, Vitest, Playwright, Cypress │
549
+ │ └─ DevOps: Docker, Vercel, AWS, GitHub Actions │
550
+ └──────────────────────────────────────────────────────────┘
551
+ ```
552
+
553
+ ---
554
+
555
+ ## 🎓 最佳实践
556
+
557
+ ### 各工作流的适用场景
558
+
559
+ ```
560
+ /brainstorm
561
+ ✓ Unclear requirements
562
+ ✓ Need to explore options
563
+ ✓ Complex problem needs breaking down
564
+
565
+ /create
566
+ ✓ New feature in existing project
567
+ ✓ Small-to-medium complexity
568
+ ✓ Single domain (frontend OR backend)
569
+
570
+ /orchestrate
571
+ ✓ Full-stack features
572
+ ✓ Complex multi-step tasks
573
+ ✓ Need multiple specialist agents
574
+
575
+ /debug
576
+ ✓ Bug reports
577
+ ✓ Unexpected behavior
578
+ ✓ Performance issues
579
+
580
+ /test
581
+ ✓ Need test coverage
582
+ ✓ Before deployment
583
+ ✓ After major changes
584
+
585
+ /deploy
586
+ ✓ Ready to ship
587
+ ✓ After all tests pass
588
+ ✓ Need production URL
589
+
590
+ /plan
591
+ ✓ Large projects
592
+ ✓ Need time estimates
593
+ ✓ Team coordination needed
594
+ ```
595
+
596
+ ---
597
+
598
+ ## 🔗 快速索引
599
+
600
+ - **架构(Architecture)**: `.agent/ARCHITECTURE.md`
601
+ - **智能体(Agents)**: `.agent/agents/`
602
+ - **技能(Skills)**: `.agent/skills/`
603
+ - **工作流(Workflows)**: `.agent/workflows/`
604
+ - **脚本(Scripts)**: `.agent/scripts/`
605
+
606
+ ---
607
+
608
+ **最后更新**:2026-01-26
609
+ **版本**:2.0.1
package/CHANGELOG.md ADDED
@@ -0,0 +1,68 @@
1
+ # 更新日志
2
+
3
+ 本文件记录 Antigravity Kit 的重要变更。
4
+
5
+ 格式基于 [Keep a Changelog](https://keepachangelog.com/en/2.0.0/),
6
+ 本项目遵循 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)。
7
+
8
+ ## [Unreleased]
9
+
10
+
11
+ ## [2.0.2] - 2026-02-04
12
+
13
+ - **新技能**:
14
+ - `rust-pro` - 掌握 Rust 1.75+
15
+ - **Agent 工作流**:
16
+ - 更新 `orchestrate.md`,修复土耳其语输出问题
17
+
18
+
19
+ ## [2.0.1] - 2026-01-26
20
+
21
+ ### 新增
22
+
23
+ - **Agent Flow 文档**: 新的完整工作流文档
24
+ - 添加 `.agent/AGENT_FLOW.md` - 完整的智能体流程架构指南
25
+ - 记录 Agent Routing Checklist(智能体路由检查清单,代码/设计前的强制步骤)
26
+ - 记录 Socratic Gate Protocol(苏格拉底门禁协议,用于需求澄清)
27
+ - 添加 Cross-Skill References(跨技能引用)模式文档
28
+ - **新技能**:
29
+ - `react-best-practices` - 整合 Next.js 与 React 专业知识
30
+ - `web-design-guidelines` - 专业 Web 设计标准与模式
31
+
32
+ ### 变更
33
+
34
+ - **技能整合**: 将 `nextjs-best-practices` 与 `react-patterns` 合并为统一的 `react-best-practices` 技能
35
+ - **架构更新**:
36
+ - 增强 `.agent/ARCHITECTURE.md` 的流程图
37
+ - 更新 `.agent/rules/GEMINI.md`,加入 Agent Routing Checklist(智能体路由检查清单)
38
+ - **Agent 更新**:
39
+ - 更新 `frontend-specialist.md`,加入新技能引用
40
+ - 更新 `qa-automation-engineer.md`,加入增强的测试工作流
41
+ - **前端设计技能**: 增强 `frontend-design/SKILL.md`,增加对 `web-design-guidelines` 的交叉引用
42
+
43
+ ### 移除
44
+
45
+ - 废弃 `nextjs-best-practices` 技能(并入 `react-best-practices`)
46
+ - 废弃 `react-patterns` 技能(并入 `react-best-practices`)
47
+
48
+ ### 修复
49
+
50
+ - **Agent Flow 准确性**: 修正 AGENT_FLOW.md 中误导性术语
51
+ - 将 "Parallel Execution" 改为 "Sequential Multi-Domain Execution"
52
+ - 将 "Integration Layer" 改为 "Code Coherence" 并补充准确说明
53
+ - 添加 AI 顺序处理与模拟多智能体行为的现实说明
54
+ - 澄清脚本需要用户批准(不会自动执行)
55
+
56
+ ## [2.0.0] - Unreleased
57
+
58
+ ### 初始发布
59
+
60
+ - Antigravity Kit 初始发布
61
+ - 20 个专业 AI 智能体
62
+ - 37 个特定领域技能
63
+ - 11 个工作流斜杠命令
64
+ - 用于便捷安装与更新的 CLI(命令行界面)工具
65
+ - 全面的文档与架构指南
66
+
67
+ [Unreleased]: https://github.com/vudovn/antigravity-kit/compare/v2.0.0...HEAD
68
+ [2.0.0]: https://github.com/vudovn/antigravity-kit/releases/tag/v2.0.0