ai-spec-tool 0.1.8 → 0.1.11

package/assets/skills/plan/SKILL.md

@@ -7,8 +7,16 @@ description: 当用户想要执行一个plan
 依赖文件清单:
  - ./docs/global/vision.md
  - ./docs/global/architecture.md
- - ./docs/projects/*/architecture.md
 
+ACTION: 检视./docs/global/architecture.md里#子专案目录,记住[__专案目录__,__专案名称(##标题就是专案名称)__,是否為前端專案]
+
+[MARK:PROJECT_LOOP]
+<<以下操作一个子专案都执行一次>>
+ACTION: 檢查./docs/projects/__专案名称__/architecture.md是否存在
+
+ACTION: 檢查./docs/projects/__专案名称__/design_tokens.md 如果此專案不屬於前端专案可跳過檢查是否存在
+
+<<以上操作一个子专案都执行一次,若还有子专案没执行,回到[MARK:PROJECT_LOOP]重新执行>>
 ACTION: 请先检查专案环境下是否存在依赖清单内的所有文档
 IF: 存在缺失文件
 输出规则:

package/assets/skills/spec-creator/SKILL.md

@@ -7,6 +7,7 @@ description: 当用户想要生成某个spec.md
  - 若用户选择vision: 执行 assets/vision_gen.md 内容
  - 若用户选择architecture: 执行 assets/architecture_gen.md 内容
  - 若用户选择project_architecture: 执行 assets/project_architecture_gen.md 内容
+ - 若用户选择project_design_tokens: 执行 assets/design_tokens_gen.md 内容
 IF: 你可以通过上下文确定用户想要生成什么文件
 ACTION: 直接执行对应的 xxx_gen.md 内容
 ENDIF
@@ -19,4 +20,5 @@ ACTION:
 1) vision
 2) architecture
 3) project_architecture
+4) project_design_tokens
 <<输出以上内容,不得再输出任何其他内容>>

package/assets/skills/spec-creator/assets/architecture_gen.md

@@ -135,16 +135,18 @@ ACTION: 等待用户回答
 语言:中文为主
 输出文件内容规则:
 __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
-__2__ 必须列出子专案的[目录,技术栈,功能性名称]
+__2__ 必须列出子专案的[目录,技术栈,功能性名称,是否為前端專案]
 <<以下为举例>>
 ## axg-web
 - 目录: /projects/axg-web
 - 技术栈: Next.js
 - 描述: 网页前端
+- 前端專案: 是
 ## axg-server
 - 目录: /projects/axg-server
 - 技术栈: NestJS
 - 描述: 后端
+- 前端專案: 否
 <<以上为举例>>
 __3__ 关键的端到端链路有哪些?
  - 可列出多条

package/assets/skills/spec-creator/assets/design_tokens_default.md

@@ -0,0 +1,104 @@
+# Design Tokens Defaults
+
+## 基础 Tokens
+
+### 颜色（Base Colors）
+- color.base.green.50 = #e6fff3
+- color.base.green.100 = #c9ffe3
+- color.base.green.200 = #9fffd1
+- color.base.green.300 = #63f9b6
+- color.base.green.400 = #2ceea1
+- color.base.green.500 = #00df81
+- color.base.green.600 = #00c873
+- color.base.green.700 = #00a35f
+- color.base.green.800 = #007a47
+- color.base.green.900 = #04513a
+- color.base.slate.50 = #e7f1f1
+- color.base.slate.100 = #c9dcdc
+- color.base.slate.200 = #a7bebe
+- color.base.slate.300 = #7a9393
+- color.base.slate.400 = #4f6a6a
+- color.base.slate.500 = #2e4a4a
+- color.base.slate.600 = #1f3a3a
+- color.base.slate.700 = #0f2c2c
+- color.base.slate.800 = #052322
+- color.base.slate.900 = #011a1b
+
+### 字体（Typography）
+- font.family.primary = "Bebas Neue"
+- font.family.alt = "Noto Sans", "Noto Sans TC", "Noto Sans SC", sans-serif
+- font.size.1 = 12px
+- font.size.2 = 14px
+- font.size.3 = 16px
+- font.size.4 = 20px
+- font.size.5 = 28px
+- font.size.6 = 40px
+- font.weight.1 = 300
+- font.weight.2 = 400
+- font.weight.3 = 600
+- font.weight.4 = 700
+- line.height.1 = 1.1
+- line.height.2 = 1.3
+- line.height.3 = 1.5
+- line.height.4 = 1.7
+
+### 间距（Spacing）
+- space.1 = 4px
+- space.2 = 8px
+- space.3 = 12px
+- space.4 = 16px
+- space.5 = 24px
+- space.6 = 32px
+- space.7 = 48px
+- space.8 = 64px
+
+### 圆角（Radius）
+- radius.1 = 2px
+- radius.2 = 4px
+- radius.3 = 8px
+- radius.4 = 12px
+
+### 阴影（Shadow）
+- shadow.1 = 0 0 6px rgba(0, 223, 129, 0.25)
+- shadow.2 = 0 0 12px rgba(0, 223, 129, 0.35)
+- shadow.3 = 0 0 20px rgba(0, 223, 129, 0.45)
+- shadow.4 = 0 0 32px rgba(0, 223, 129, 0.6)
+
+### 动效（Motion）
+- motion.duration.1 = 120ms
+- motion.duration.2 = 200ms
+- motion.duration.3 = 320ms
+- motion.duration.4 = 480ms
+- motion.easing.standard = cubic-bezier(0.2, 0.0, 0.0, 1.0)
+- motion.easing.emphasized = cubic-bezier(0.2, 0.0, 0.0, 1.2)
+
+## 语义 Tokens
+
+### 文字
+- color.text.primary = color.base.slate.50
+- color.text.secondary = color.base.slate.100
+- color.text.muted = color.base.slate.300
+- color.text.disabled = color.base.slate.500
+
+### 背景
+- color.bg.canvas = color.base.slate.900
+- color.bg.surface = color.base.slate.800
+- color.bg.elevated = color.base.slate.700
+- color.bg.accent = color.base.green.500
+
+### 边框
+- color.border.default = color.base.slate.600
+- color.border.subtle = color.base.slate.700
+- color.border.focus = color.base.green.500
+
+### 交互
+- color.interactive.default = color.base.green.500
+- color.interactive.hover = color.base.green.400
+- color.interactive.active = color.base.green.600
+- color.interactive.disabled = color.base.slate.600
+
+### 反馈
+- color.feedback.success = color.base.green.500
+- color.feedback.warning = #ffb020
+- color.feedback.error = #ff4d4f
+- color.feedback.info = #3aa6ff

package/assets/skills/spec-creator/assets/design_tokens_gen.md

@@ -0,0 +1,163 @@
+#依赖检查
+
+依赖文件清单:
+ - ./docs/global/vision.md
+ - ./docs/global/architecture.md
+
+ACTION: 请先检查专案环境下是否存在依赖清单内的所有文档
+IF: 存在缺失文件
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __MISSING_FILE_NAME__ 缺失的文件名
+ - 若有多个缺失文件就多行显示
+ - 若用户选择 开始创建文档: 执行 skill: spec-creator
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## 您需要先创建文档:
+ - __MISSING_FILE_NAME__
+---
+1) 开始创建文档
+<<输出以上内容,不得再输出任何其他内容>>
+ENDIF
+
+ACTION: 阅读所有依赖文件内容来了解专案,并在遵守文件内定义的规范约束下执行后续步骤
+ACTION: 检视./docs/global/architecture.md里#子专案目录,记住[__专案目录__,__专案名称(##标题就是专案名称)__,是否為前端專案]
+
+[MARK:PROJECT_LOOP]
+<<以下操作一个子专案都执行一次>>
+IF: __专案目录__不是前端,並不需要視覺化
+跳過這個子專案,如果有下一個子專案,檢查下一個ENDIF
+
+ACTION: 
+<<输出以下内容>>
+## 现在开始建立 __专案名称__ 的design_tokens文档
+<<输出以上内容>>
+#问题询问
+
+ACTION: 
+<<输出以下内容>>
+## [1/4] 请提供风格参考，并尽量结构化填写：
+- 参考链接/图片
+- 关键词（3-5 个）
+- 最想要的 1 个特性（例如可读性/层级清晰/社区感/极简）
+---
+1) 提供参考
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+ACTION: 
+<<输出以下内容>>
+## [2/4] 提供配色参考（可与风格参考相同）
+- 参考链接/图片
+- 关键词（3-5 个）
+- 主要颜色倾向（例如冷色/暖色/中性/单色）
+---
+1) 沿用上一题的风格参考
+2) 提供参考
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [3/4] 是否需要多主题?
+ - 例如 light / dark / brand
+---
+1) ✨__ADVICE__
+2) 无
+3) 需要
+4) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [4/4] 需要支持哪些端？
+ - 可多选
+---
+1) ✨__ADVICE__
+2) 网页端
+3) 移动端
+4) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+#输出文件
+*仅在以上所有流程完成后才执行
+
+输出格式:Markdown
+语言:中文为主
+输出文件内容规则:
+__PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+__1__ 输出需以默认值模板为基准，但必须体现风格参考：
+1) 以 `./skills/spec-creator/assets/design_tokens_default.md` 的结构与顺序为主模板，不得改变标题层级与分类顺序。
+2) 输出前先给出“风格摘要”（3-6 条），必须覆盖：色彩倾向、对比度倾向、字体氛围、层级密度、情绪关键词。
+3) 若用户提供网页链接或图片，必须先浏览网页/查看图片并提取可见风格信息，再进行 tokens 调整。
+4) 必须逐条响应用户回答：风格参考/多主题/平台/修改请求需体现在文档或 token 值中。
+5) 若提供了风格参考，必须至少调整 3 项关键 token 类别：
+   - 颜色主色族（color.base.*）
+   - 中性色倾向（color.base.slate.*）
+   - 字体（font.family.*）
+6) 多主题格式：新增 `## Themes`，每个主题用 `### <主题名>`，仅列语义 Tokens 覆盖值，未列出者继承基础 Tokens。
+7) 值的来源：用户明确提供则调整；否则使用 `./skills/spec-creator/assets/design_tokens_default.md` 的默认值，不留空。
+8) 每条 token 行必须带用途注释：token.key = value  # 用途说明（简短明确）。
+9) 风格参考需在文档顶部追加“风格参考”描述，不影响 tokens 列表。
+10) 完成后自检：是否体现风格参考？是否调整≥3个关键 token 类别？若否，必须重写。
+
+输出文件内容结构:
+<<以下为实际输出文件格式,需结合输出规则生成部分动态内容>>
+#Design Tokens
+__1__
+
+<<以上为实际输出文件格式,需结合输出规则生成部分动态内容>>
+
+[MARK:1]
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __输出文件内容__ 显示基于[输出文件内容规则/输出文件内容结构]总结输出文件内容
+ACTION: 
+<<结合输出规则,输出以下内容>>
+```md
+__输出文件内容__
+```
+<<输出以上内容>>
+ACTION: 
+<<输出以下内容>>
+## 是否接受将以上总结输出并保存成文件?
+---
+1) 接受
+2) 提出修改
+<<输出以上内容,不得再输出任何其他内容>>
+IF: 用户选择接受
+ACTION: 将最终确认的输出版本保存到./docs/projects/{_project_name}/design_tokens.md
+ACTION: 
+<<输出以下内容>>
+> ✅文件已保存于./docs/projects/{_project_name}/design_tokens.md
+<<输出以上内容>>
+ENDIF
+
+IF: 用户没有选择接受
+ACTION: 带着用户的修改提议,回到[MARK:1]重新执行
+ENDIF
+
+ACTION: 
+<<输出以下内容>>
+## 是否基於剛剛設計的 ./docs/projects/{_project_name}/design_tokens.md
+依照子專案 __专案名称__ 的技術棧
+生成關鍵風格代碼文件？
+---
+1) 是
+<<输出以上内容,不得再输出任何其他内容>>
+<<以上操作一个子专案都执行一次,若还有子专案没执行,回到[MARK:PROJECT_LOOP]重新执行>>
+ACTION: 
+<<输出以下内容>>
+## 接下来...
+---
+1) 完成并保存设计 Token
+2) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>

package/assets/skills/spec-creator/assets/project_architecture_gen.md

@@ -22,11 +22,13 @@ ENDIF
 
 ACTION: 阅读所有依赖文件内容来了解专案,并在遵守文件内定义的规范约束下执行后续步骤
 ACTION: 基于[所有依赖文件,与用户的对话记录]整理出用户想要实现的功能会改动是什么
-ACTION: 检视./docs/global/architecture.md里#子专案目录,记住[__专案目录__,__专案名称(##标题就是专案名称)__]
-[MARK:2]
-<<以下操作一个子专案都执行一次>>ACTION: 
+ACTION: 检视./docs/global/architecture.md里#子专案目录,记住[__专案目录__,__专案名称(##标题就是专案名称)__,是否為前端專案]
+
+[MARK:PROJECT_LOOP]
+<<以下操作一个子专案都执行一次>>
+ACTION: 
 <<输出以下内容>>
-## 现在开始建立 __专案名称__ 的architecture文档
+## 现在开始建立 {_project_name} 的architecture文档
 <<输出以上内容>>
 #问题询问
 
@@ -59,7 +61,7 @@ ACTION: 等待用户回答
 
 输出规则:
  - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
- - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案,层级名称请用英文命名,[回答格式范例](Adapter: `__专案目录__/src/adapters/`; Service: `__专案目录__/src/services/`;Component: `__专案目录__/src/components/`)
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案,层级名称请用英文命名,[回答格式范例](Adapter: `{_project_dir}/src/adapters/`; Service: `{_project_dir}/src/services/`;Component: `{_project_dir}/src/components/`)
 ACTION: 
 <<结合输出规则,输出以下内容>>
 ## [3/3] 请定义每一层的文件落点?
@@ -125,4 +127,4 @@ IF: 用户没有选择接受
 ACTION: 带着用户的修改提议,回到[MARK:1]重新执行
 ENDIF
 
-<<以上操作一个子专案都执行一次,若还有子专案没执行,回到[MARK:2]重新执行>>
+<<以上操作一个子专案都执行一次,若还有子专案没执行,回到[MARK:PROJECT_LOOP]重新执行>>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-spec-tool",
-  "version": "0.1.8",
+  "version": "0.1.11",
   "description": "Installable agents + rules for AI spec workflows",
   "bin": {
     "ai-spec-tool": "bin/ai-spec-tool.js"