ai-spec-tool 0.1.3 → 0.1.4

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

@@ -0,0 +1,223 @@
+#问题询问
+
+ACTION: 
+<<输出以下内容>>
+## [1/7] 请尽可能详细描述这个专案想要实现什么
+---
+1) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [2/7] 主要用户是哪一群人?
+---
+1) ✨__ADVICE__
+2) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [3/7] 专案希望解决谁的哪些问题?
+- 可列出多条
+---
+1) ✨__ADVICE__
+2) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+ACTION: 
+<<输出以下内容>>
+## [4/7] 专案开发过程必须遵守哪些原则？
+- 可列出多条
+---
+1) 无
+2) 指定技术框架为 <请描述>
+3) 快速开发
+4) 可长期维护
+5) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [5/7] 如何验收定义这个专案算完成了？
+- 请列出1-3条关键目标
+- 驗收目標必須可驗證
+---
+1) ✨__ADVICE__
+2) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [6/7] 专案是否服务于一个未来更大的目标?
+- 可列出多条
+---
+1) ✨__ADVICE__
+2) 无
+3) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __ADVICE__ 基于[先前的对话内容,所有依赖文件](如过有),需求风险:问题是否被正确理解,技术风险:实现难度、性能、依赖不确定性,数据风险:数据来源、质量、权限,用户风险:获取、留存、使用成本,合规与安全风险:若相关,用以上几个维度去思考,结合问题给与建议答案
+ACTION: 
+<<结合输出规则,输出以下内容>>
+## [7/7] 专案未来可能的风险？
+- 可列出多条
+---
+1) ✨__ADVICE__
+2) 无
+3) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>
+ACTION: 等待用户回答
+
+#输出文件
+*仅在以上所有流程完成后才执行
+
+输出格式:Markdown
+语言:中文为主
+输出文件内容规则:
+__PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+__2__ 基于所有用户回答判断项目性质。
+若项目具有长期延续性或未来扩展方向，则输出：
+长期意义一句话：____。
+项目在强化的能力：列 1~3 条（动词 + 名词）。能力必须可在未来复用或延续。
+若项目属于短期或阶段性交付，则输出：
+阶段意义一句话：____。
+该阶段完成后沉淀的资产或能力：列 1~3 条（例如流程经验、系统能力、数据基础）。
+不得假设平台化或规模化，除非用户明确提到。
+
+__3__ 现状成本或痛点：从用户问题描述中归纳 1~3 条。
+预期收益：必须与验收目标逐条映射，并明确写出该收益解决的是哪条痛点。
+每条收益需同时标注 对应痛点 与 对应验收目标编号。
+若验收目标不可验证或过于聚合，指出其是否缺少拆分维度（功能层/行为层/价值层）。
+
+__4__ 输出 2~5 条可被验证的假设。
+假设必须分为三类中的任意组合：功能成立假设、用户行为假设、价值成立假设。
+格式为：假设：如果____，那么____。
+验证方式：对应哪条验收目标。
+所有假设必须可映射到已有验收目标。
+不得生成无法验证的抽象目标。
+
+__5__ 优先用户定义：使用主要用户定义的原话或贴近改写，不得新增人群。
+核心问题：从用户问题描述中归纳 1~3 条。
+同时指出：这些问题是否具有迫切性或高频性，依据必须来自原回答。
+若用户群过宽，说明其是否会导致策略分散。
+
+__6__ 风险清单：直接引用或归纳风险列表中的 1~5 条。
+每条风险标注为 需求、技术、数据、用户 或 合规。
+同时指出：该风险若发生，将直接影响哪条验收目标。
+不得新增风险类型或缓解方案。
+
+__8__ 不得假设存在支付、订阅、权限或渠道等机制，除非用户明确提到。
+MVP闭环一句话：用户通过____完成____从而达到____，必须可映射到验收目标。
+闭环步骤 3~7 步，使用中性动词。
+关键断点：指出哪一步失败将直接导致哪条验收目标无法达成。
+必须能力 3~6 条，每条注明对应的验收目标编号，并说明其属于 功能能力 或 系统能力。
+可延后能力：列出不会影响任何验收目标的能力。
+
+__9__ 将每条验收目标拆解为 指标 + 条件 + 判定方式。
+若多个能力集中映射到同一条验收目标，指出该验收目标是否过度聚合。
+不得新增额外商业指标。
+
+__10__ 列出 3~7 条不可违反原则，优先使用用户原话。
+将“快速开发”“长期维护”“指定技术框架”等表述转写为可执行约束句式。
+同时指出：这些原则将限制哪些技术或设计选择。
+
+__12__ 基于验收目标范围与开发原则推导边界。
+输出 3~7 条，每条格式为 不做____，因为其不会影响当前验收目标或会增加复杂度。
+若验收目标范围过大，指出其是否需要拆分阶段。
+
+__13__ 仅提取包含 必须、禁止、绝不 或 只能 等强制语气的内容。
+若无明确硬约束，输出 无。
+
+输出文件内容结构:
+<<以下为实际输出文件格式,需结合输出规则生成部分动态内容>>
+#🤔为什么做
+##这个项目存在的长期意义是什么？
+__2__
+
+##为什么现在值得做？
+__3__
+
+##关键假设是什么？
+__4__
+
+##第一优先用户是谁？
+__5__
+
+##最大战略风险是什么？
+__6__
+
+#✅要做什么
+##MVP 的最小闭环是什么？
+__8__
+
+##成功如何被量化？
+__9__
+
+##核心系统架构原则
+__10__
+
+#⛔守则
+##本阶段明确不做什么
+__12__
+
+##不可突破的硬性约束是什么？
+__13__
+
+<<以上为实际输出文件格式,需结合输出规则生成部分动态内容>>
+
+[MARK:1]
+输出规则:
+ - __PLACEHOLDER__ 为占位符,请勿输出,而是基于规则输出动态内容
+ - __输出文件内容__ 显示基于[输出文件内容规则/输出文件内容结构]总结输出文件内容
+ACTION: 
+<<结合输出规则,输出以下内容>>
+```md
+__输出文件内容__
+```
+<<输出以上内容>>
+ACTION: 
+<<输出以下内容>>
+## 是否接受将以上总结输出并保存成文件?
+---
+1) 接受
+2) 提出修改
+<<输出以上内容,不得再输出任何其他内容>>
+IF: 用户选择接受
+ACTION: 将最终确认的输出版本保存到./docs/global/vision.md
+ACTION: 
+<<输出以下内容>>
+> ✅文件已保存于./docs/global/vision.md
+<<输出以上内容>>
+ENDIF
+
+IF: 用户没有选择接受
+ACTION: 带着用户的修改提议,回到[MARK:1]重新执行
+ENDIF
+
+ACTION: 
+<<输出以下内容>>
+## 已完成Vision文件的生成,接下来...
+---
+1) 生成architecture文件
+2) 直接描述
+<<输出以上内容,不得再输出任何其他内容>>

package/package.json

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

package/assets/.agents/skills/bugfix/SKILL.md

@@ -1,48 +0,0 @@
----
-name: bugfix
-description: 用户提供报错信息或描述异常行为时使用
----
-
-# 前置依赖检查（统一规则）
-
-## 依赖清单（必须存在且非占位）
-- `docs/_shared/conventions.md`
-- `docs/_shared/glossary.md`
-- `docs/architecture/<project>/architecture.md`
-- `docs/architecture/<project>/layer_rules.yaml`
-- 相关 module spec（若存在则必须读取）
-
-## 缺失判定
-文件不存在 / 内容为空 / 首行含 `AI-SPEC-TOOL:PLACEHOLDER`
-
-## 缺失时唯一输出
-<<<
-缺少依赖[<path>]
-
-【下一步】请选择一项：
-1. 开始创建依赖
-请回复：1
->>>
-用户回复 `1` 后切换 `rules-creator` 生成缺失文件。
-
----
-
-# 1) 修复流程（简版）
-1. 复述问题与影响
-2. 定位可能模块与层级
-3. 给出修复方案并修改代码
-4. 更新相关 module spec（如需）
-
----
-
-# 2) 对话输出（必须包含下一步）
-
-<<<
-已完成问题修复：  
-`<简述>`
-
-【下一步】请选择一项：
-1. 继续修正其他问题（bugfix）
-2. 进入新的需求讨论（plan）
-请回复：1/2
->>>

package/assets/.agents/skills/plan/SKILL.md

@@ -1,56 +0,0 @@
----
-name: plan
-description: 用户明确需要新的系统/模块/功能体系或跨项目协作时，用于生成顶层 Plan（multi-project）
----
-
-# 前置依赖检查（统一规则）
-
-## 依赖清单（必须存在且非占位）
-- `docs/_shared/conventions.md`
-- `docs/_shared/glossary.md`
-- `docs/architecture/<project>/architecture.md`（计划涉及的每个 project）
-- `docs/architecture/<project>/layer_rules.yaml`（计划涉及的每个 project）
-- 前端 project 需额外存在：
-  - `docs/architecture/<project>/ui/design-tokens.md`
-  - `docs/architecture/<project>/ui/layout-and-responsive.md`
-  - `docs/architecture/<project>/ui/patterns.md`
-
-## 缺失判定（必须）
-视为缺失：文件不存在 / 内容为空 / 首行包含 `AI-SPEC-TOOL:PLACEHOLDER`
-
-## 缺失时的唯一输出
-<<<
-缺少依赖[<path>]
-
-【下一步】请选择一项：
-1. 开始创建依赖
-请回复：1
->>>
-用户回复 `1` 后，切换到 `rules-creator` 并生成对应文件。
-
----
-
-# 1) 需求澄清（必须）
-每次提问都必须标注进度，例如：`问题[1/4]`。
-只澄清“本次变更目标、成功标准、非目标、涉及哪些 project”。
-若用户未明确 project scope：先列出候选 projects，再确认 scope。
-若用户已有规格书（Interface）：必须获取其路径并在 plan 中记录。
-
----
-
-# 2) Plan 文件生成（强制，流程[2/3]）
-详细结构与字段定义见：`assets/templates/plan.md`
-生成后必须：
-- 更新 `docs/plan/index.yaml`
-- 生成 `docs/plan/<plan-id>/summary.md`
-
-## 输出路径
-`./docs/plan/<plan-id>/plan.md`
-
-`<plan-id>` 规则：
-- `<index>-<slug>`（index 3 位递增）
-- slug 为本次变更目标摘要（不含技术实现）
-
-# 3) 对话输出（唯一允许的文字输出，流程[3/3]）
-- 输出已生成文件路径
-- 提示下一步选项：讨论 / 直接执行（plan-executor）

package/assets/.agents/skills/plan/assets/templates/plan.md

@@ -1,47 +0,0 @@
-# Plan 文件模板
-
-```md
----
-plan_id: <plan-id>
-kind: <feature|update|refactor>
-version: 1
-projects: [<project>, ...]
-source_interface: docs/requirements/<spec-id>.md
----
-
-## intent
-- goal
-- non_goals
-- success_criteria
-
-## project_objectives
-### <project>
-- 本次目标
-
-## modules
-```yaml
-- project: <project>
-  name: <module>
-  layer: <layer>
-  change: <create|update|refactor>
-  purpose: ...
-  capabilities: ...
-  ownership: ...
-  dependencies:
-    must: [...]
-    forbid: [...]
-  constraints:
-    must: [...]
-    must_not: [...]
-```
-
-## flows
-- use_cases: ...
-
-## rules
-- hard: [...]
-
-## execution_steps
-1. <project>/<module>
-2. <project>/<module>
-```

package/assets/.agents/skills/plan-executor/SKILL.md

@@ -1,105 +0,0 @@
----
-name: plan-executor
-description: 当用户要执行某个 plan.md 时，生成 project-plan 与 module-plan
----
-
-# 前置依赖检查（统一规则）
-
-## 依赖清单（必须存在且非占位）
-- `docs/plan/<plan-id>/plan.md`
-- `docs/_shared/conventions.md`
-- `docs/_shared/glossary.md`
-- `docs/architecture/<project>/architecture.md`
-- `docs/architecture/<project>/layer_rules.yaml`
-- 若 module 的 layer = Component（UI）：
-  - `docs/architecture/<project>/ui/design-tokens.md`
-  - `docs/architecture/<project>/ui/layout-and-responsive.md`
-  - `docs/architecture/<project>/ui/patterns.md`
-
-## 缺失判定
-文件不存在 / 内容为空 / 首行含 `AI-SPEC-TOOL:PLACEHOLDER`
-
-## 缺失时唯一输出
-<<<
-缺少依赖[<path>]
-
-【下一步】请选择一项：
-1. 开始创建依赖
-请回复：1
->>>
-用户回复 `1` 后切换 `rules-creator` 生成缺失文件。
-
----
-
-# 1) 输入与读取（强制，流程[1/4]）
-- 优先读取 `docs/plan/index.yaml` 以定位 plan（若缺失再扫描目录）
-- 读取目标 `plan.md`
-- 若 plan 含 `source_interface`：必须读取对应规格书
-- 只读取与本次 plan 相关的 project 架构与 layer rules
-- 若 execution_steps 不覆盖全部 modules 或格式不为 `<project>/<module>`：停止并要求补齐 plan
-
----
-
-# 2) 输出生成（强制，流程[2/4]）
-详细结构与字段定义见：
-- `assets/templates/project-plan.md`
-- `assets/templates/module-plan.md`
-- `assets/templates/summary-plan.md`
-- `assets/templates/summary-project.md`
-- `assets/templates/summary-module.md`
-
-## Project-Plan
-为每个 project 生成：
-`./docs/plan/<plan-id>/projects/<project>/project-plan.md`
-
-内容要求：
-- 引用顶层 plan
-- 只描述该 project 的目标与约束
-- 列出该 project 的 in-scope modules
-- 过滤后的 execution_steps（保持顺序）
-
-## Project-Plan 摘要与确认（强制）
-- 生成完所有 `project-plan.md` 后：
-  - 输出每个 project 的「本次要做什么」一行摘要
-  - 询问用户是否要修改
-- 若用户要求修改：
-  - 只修改对应 `project-plan.md`
-  - 再次输出摘要并确认
-- 用户确认后，才可继续生成 module-plan
-- 为每个 project 生成 `summary.md`
-
-## Module-Plan
-为每个 module 生成：
-`./docs/plan/<plan-id>/projects/<project>/modules/<module>-plan.md`
-
-必须包含：
-- why / scope / changes(add|modify|remove)
-- constraints
-- acceptance_criteria
-- verification
-- spec_update_notes
-
-若 module 为 UI Component：
-- 确保 `docs/specs/<project>/components/` 目录
-- 如缺失则生成初版 `<module>-rules.md`
-
-## Module-Plan 摘要与确认（强制）
-- 生成完所有 `module-plan.md` 后：
-  - 输出每个 module 的一行摘要（本次新增/修改要点）
-  - 询问用户是否要修改
-- 若用户要求修改：
-  - 只修改对应 `module-plan.md`
-  - 再次输出摘要并确认
-- 用户确认后，才可进入 spec-executor
-- 为每个 module 生成 `<module>.summary.md`
-
-## 状态变更（流程[3/4]）
-仅在“Module-Plan 摘要已确认”后：
-- 将 `plan.md` 改名为 `plan.processing.md`
-
----
-
-# 3) 对话输出（唯一允许的文字输出，流程[4/4]）
-- 输出已生成文件路径
-- 输出摘要（project / module）并询问是否修改
-- 提示下一步选项：进入 spec-executor

package/assets/.agents/skills/plan-executor/assets/templates/module-plan.md

@@ -1,26 +0,0 @@
-# Module-Plan 模板
-
-```md
----
-module: <module>
-project: <project>
-layer: <layer>
-change: <create|update|refactor>
-source_plan: <plan-id>
-source_project_plan: <project-plan path>
-source_interface: docs/requirements/<spec-id>.md
-target_spec: docs/specs/<project>/<module>-spec.md
-target_component_rules: docs/specs/<project>/components/<module>-rules.md (UI Component only)
----
-
-## why
-## scope
-## changes
-### add
-### modify
-### remove
-## constraints
-## acceptance_criteria
-## verification
-## spec_update_notes
-```

package/assets/.agents/skills/plan-executor/assets/templates/project-plan.md

@@ -1,24 +0,0 @@
-# Project-Plan 模板
-
-```md
----
-project: <project>
-source_plan: <plan-id>
-source_interface: docs/requirements/<spec-id>.md
----
-
-## intent_in_project
-- goal
-- non_goals
-- success_criteria
-
-## in_scope_modules
-- <module> (layer: <layer>, change: <change>, plan: <module-plan path>)
-
-## constraints
-- ...
-
-## execution_steps_in_project
-1. <project>/<module>
-2. <project>/<module>
-```

package/assets/.agents/skills/plan-executor/assets/templates/summary-module.md

@@ -1,17 +0,0 @@
-# Module Summary 模板
-
-```md
-# Module Summary
-
-## Module
-- project:
-- name:
-- change:
-
-## Key Changes
-- ...
-
-## Status
-- status: in_progress|done
-- done_at:
-```

package/assets/.agents/skills/plan-executor/assets/templates/summary-plan.md

@@ -1,18 +0,0 @@
-# Plan Summary 模板
-
-```md
-# Plan Summary
-
-## Plan
-- plan_id:
-- intent:
-
-## Projects
-- <project>: <one-line objective>
-
-## Modules
-- <project>/<module>: <one-line change>
-
-## Execution
-- steps: <count>
-```

package/assets/.agents/skills/plan-executor/assets/templates/summary-project.md

@@ -1,16 +0,0 @@
-# Project Summary 模板
-
-```md
-# Project Summary
-
-## Project
-- name:
-- scope:
-
-## Modules
-- <module>: <one-line change>
-
-## Status
-- status: in_progress|done
-- done_at:
-```

package/assets/.agents/skills/rules-creator/SKILL.md

@@ -1,39 +0,0 @@
----
-name: rules-creator
-description: 当用户指定要创建某个规则文件
----
-
-- rules-creator 不做任何依赖检查，只负责生成指定文件
-
-- 通用规范文件(conventions)
-    请阅读:assets/conventions-gen.md
-
-- 术语表(glossary)
-    请阅读:assets/glossary-gen.md
-
-- 需求规格书(interface)
-    请阅读:assets/interface-gen.md
-
-- 系统架构文件(architecture)
-    请阅读:assets/architecture-gen.md
-
-- UI架构文件(ui-architecture)
-    请阅读:assets/ui-architecture-gen.md
-
-- UI范例界面(ui-template-gen)
-    请阅读:assets/ui-template-gen.md
-
----
-
-# 对话输出（唯一允许的文字输出）
-
-<<<
-OUTPUT:
-规则文件已生成完成。  
-`<文件名>`（需为可点击超链接）
-
-【下一步】请选择一项：
-1. 继续生成其他规则文件
-2. 进入计划生成（plan）
-请回复：1/2
->>>