sdd-flow-kit 1.1.0 → 1.2.1

package/src/templates/artifacts/06-agent-skill.template.md

@@ -1,73 +1,52 @@
 ---
-name: sdd-flow-kit-trigger
-description: 开发某版本需求、SDD 流程、用户回复确认点时触发。**必须**按 openspec/PRD/<runId>/NEXT.md 执行 `npx sdd-flow-kit gate|phase|propose|deliver`；命令 exit≠0 时禁止进入下一阶段或改 src/。
+name: sdd-flow-kit
+description: 用户说「开发/进行 {{DEFAULT_PRODUCT}} x.x.x 版本/需求」「ADI_2.3.2」等时触发。**禁止**未过 gate 直接改 src。必须先 invoke/run，确认点闭合后走 OpenSpec+Superpowers（gate→propose→apply→deliver）。
 ---
 
-# SDD Flow（脚本门禁版 — 不依赖自然语言跳步）
+# SDD Flow Kit（{{PROJECT_KIND}} — 脚本门禁）
 
-## 铁律
+## 触发即执行（第一步，禁止跳过）
 
-1. 每步开始前读 `openspec/PRD/<runId>/NEXT.md` 与 `.session-state.json`。
-2. **必须**在终端执行其中的 `npx sdd-flow-kit ...`；根据 **exit code** 判断是否可继续（0=通过，非0=停止）。
-3. `docModeOnly: true` 时 **禁止** 修改 `src/`、`e2e/`、`frontend/src/` 等实现路径。
-4. 只有 `gate --expect impl-allowed` 通过后才允许改业务代码。
-5. 只有 `deliver` 成功且 `phase advance --to shipped` 通过后才可宣称「开发完成」。
-
-## 准备
+用户一旦表达版本开发意图，**在本回合终端执行**（项目根 = 安装 sdd-flow-kit 的目录，如 `frontend/`）：
 
 ```bash
-npx sdd-flow-kit run --product <PRODUCT> --version <VERSION> -y
+npx sdd-flow-kit invoke "开发 {{DEFAULT_PRODUCT}} <版本号> 需求" -y --agent {{AGENT_NAME}}
 ```
 
-工作目录：`openspec/PRD/<runId>/`（已生成 `NEXT.md`）。
-
-## 标准命令序列（复制 NEXT.md，按序执行）
-
-| 阶段 | 门禁 / 推进 |
-|------|-------------|
-| PRD 已拉取 | `gate --expect prd-fetched` → `phase advance --to after-prd` |
-| 提问模式 | `gate --expect questions-open` |
-| 用户确认后（仅文档） | 更新 01/02/03/04 → `gate --expect docs-closed` → `phase advance --to docs-done` |
-| 提案 | `propose --change <name>` →（AI 生成 openspec artifacts）→ `gate --expect propose-ready` → `phase advance --to propose-done` |
-| 实现 | `phase advance --to impl --change <name>` → `gate --expect impl-allowed` → 按 tasks 改代码 |
-| 交付 | `deliver --change <name>` → `phase advance --to shipped` |
-
-统一参数（示例）：
+或：
 
 ```bash
-export PR=<项目根目录>
-export RID=<runId>
-export CH=<change-name>
-
-npx sdd-flow-kit gate --project-root "$PR" --run-id "$RID" --expect docs-closed
-npx sdd-flow-kit phase advance --project-root "$PR" --run-id "$RID" --to docs-done
+npx sdd-flow-kit run --product {{DEFAULT_PRODUCT}} --version <版本号> -y --agent {{AGENT_NAME}}
 ```
 
-## 各阶段说明（辅助，不可替代脚本）
-
-### 阶段 A
-- Step1：`01-获取需求文档指引.md` → 回填 `source/PRD.md`
-- Step2：`02-需求分析提示词.md`；未闭合时 **只** 改 `03`
-
-### 阶段 B
-- 用户确认后：生成 01/02/04，**然后必须** `gate docs-closed`（会检测 git 是否误改 src）
+然后 **只读** `openspec/PRD/<runId>/NEXT.md` 与 `.session-state.json`，按其中命令顺序执行；**exit code ≠ 0 必须停止**。
 
-### 阶段 C
-- `propose` 创建 change；AI 按 openspec-propose 写 artifacts；`gate propose-ready` 校验 apply-ready
+## 铁律（防 vibe coding）
 
-### 阶段 D
-- `phase advance --to impl` 将 `docModeOnly` 设为 false
-- 实现后 `deliver` 跑 `ensure-opsx` + `pnpm run opsx:delivery-pipeline`
+1. `docModeOnly: true` 时 **禁止** 修改 `src/`、`frontend/src/`、`e2e/`。
+2. 用户粘贴确认点、更新 03 后：先产出 01/02/04，再 **必须**：
+   ```bash
+   npx sdd-flow-kit gate --project-root <安装根> --run-id <runId> --expect docs-closed
+   npx sdd-flow-kit phase advance --project-root <安装根> --run-id <runId> --to docs-done
+   ```
+3. **仅当** `gate --expect impl-allowed` 通过后，才允许按 `openspec/changes/<change>/tasks.md` 改业务代码。
+4. 提案/实现 **必须** 读并执行：
+   - `.cursor/skills/opsx-superpowers-workflow/SKILL.md`（总编排）
+   - `openspec-propose` → `openspec-apply-change` → `pnpm run opsx:delivery-pipeline -- <change>`
+5. **禁止** 跳过 `propose` / `deliver` 或手写 tasks 全勾 `[x]` 宣称完成。
 
-## 严禁
+## 阶段摘要
 
-- 跳过 `gate` / `phase` 直接改代码或宣称完成
-- `docs-closed` 未通过时修改 `src/`
-- 手写 `tasks.md` 全勾 `[x]` 而不跑 `deliver`
-- 用自然语言代替 exit code 判断
+| 阶段 | 动作 |
+|------|------|
+| A | Step1 PRD → `gate prd-fetched` → `phase after-prd` |
+| A2 | 提问模式仅 03 → `gate questions-open` |
+| B | 用户确认后 01/02/04 → `gate docs-closed` → `phase docs-done` |
+| C | `propose` + OpenSpec artifacts → `gate propose-ready` → `phase propose-done` |
+| D | `phase impl` → `gate impl-allowed` → 改代码 → `deliver` → `phase shipped` |
 
 ## 环境
 
 - agent: {{AGENT_NAME}}
-- 安装: `npx sdd-flow-kit install -y`
-- 脚本帮助: `npx sdd-flow-kit --help`
+- 全量安装: `npx sdd-flow-kit install --project {{PROJECT_KIND}} -y`
+- 本地 OPSX: `SDD_OPSX_WORKFLOW_PACKAGE=file:../../opsx-workflow`

package/src/templates/rules/sdd-no-implement-until-apply.mdc.template

@@ -22,6 +22,13 @@ alwaysApply: true
 - **禁止** 修改 `src/`、`e2e/`、`frontend/src/` 等
 - 用户粘贴确认点后：先 `gate docs-closed`，通过后再 `phase advance --to docs-done`；**不得**同回合改 ts/vue
 
+## 自然语言触发（ADI / OMS 等）
+
+用户说「开发/进行 ADI 2.3.2 版本」「ADI_2.3.2」等时：
+
+1. **先** 在终端执行：`npx sdd-flow-kit invoke "开发 ADI 2.3.2 需求" -y`
+2. 打开 `openspec/PRD/<runId>/NEXT.md`，**禁止**直接改 `src/`
+
 ## 用户确认点（无需口令）
 
 1. 更新 `03` → 生成 `01/02/04`