scene-capability-engine 3.0.1 → 3.0.2

package/docs/zh/quick-start.md

@@ -1,6 +1,6 @@
 # 快速入门指南
 
-> 5 分钟上手 kse - 从安装到第一个 AI 辅助功能实现
+> 5 分钟上手 sce - 从安装到第一个 AI 辅助功能实现
 
 ---
 
@@ -14,7 +14,7 @@
 ## 你将学到什么
 
 完成本指南后，你将能够：
-- ✅ 安装 kse 并设置你的第一个项目
+- ✅ 安装 sce 并设置你的第一个项目
 - ✅ 创建完整的 Spec（需求 → 设计 → 任务）
 - ✅ 为你的 AI 工具导出上下文
 - ✅ 使用 AI 基于 Spec 实现功能
@@ -44,12 +44,12 @@ npm --version   # 应显示 8.0.0 或更高
 
 ---
 
-## 步骤 1：安装 kse（30 秒）
+## 步骤 1：安装 sce（30 秒）
 
-使用 npm 全局安装 kse：
+使用 npm 全局安装 sce：
 
 ```bash
-npm install -g kiro-spec-engine
+npm install -g scene-capability-engine
 ```
 
 **预期输出：**
@@ -59,7 +59,7 @@ added 50 packages in 5s
 
 **验证安装：**
 ```bash
-kse --version
+sce --version
 ```
 
 **预期输出：**
@@ -68,13 +68,13 @@ kse --version
 ```
 
 **故障排除：**
-- **"kse: command not found"** → 重启终端或检查 PATH
-- **macOS/Linux 权限错误** → 使用 `sudo npm install -g kiro-spec-engine`
+- **"sce: command not found"** → 重启终端或检查 PATH
+- **macOS/Linux 权限错误** → 使用 `sudo npm install -g scene-capability-engine`
 - **Windows 权限错误** → 以管理员身份运行终端
 
 ---
 
-## 步骤 2：在项目中采用 kse（1 分钟）
+## 步骤 2：在项目中采用 sce（1 分钟）
 
 进入你的项目目录（或创建新项目）：
 
@@ -85,12 +85,12 @@ cd your-project
 # 或创建新项目
 mkdir my-awesome-app
 cd my-awesome-app
-git init  # kse 最适合与 git 项目配合使用
+git init  # sce 最适合与 git 项目配合使用
 ```
 
-**采用 kse：**
+**采用 sce：**
 ```bash
-kse adopt
+sce adopt
 ```
 
 **预期输出：**
@@ -103,10 +103,10 @@ kse adopt
 ✓ 生成 ENVIRONMENT.md
 ✓ 生成 CURRENT_CONTEXT.md
 
-✅ 项目成功采用 kse！
+✅ 项目成功采用 sce！
 
 下一步：
-  1. 创建你的第一个 Spec：kse spec bootstrap --name 01-00-my-feature --non-interactive
+  1. 创建你的第一个 Spec：sce spec bootstrap --name 01-00-my-feature --non-interactive
   2. 阅读指南：.kiro/README.md
 ```
 
@@ -119,12 +119,12 @@ your-project/
 │   │   ├── CORE_PRINCIPLES.md
 │   │   ├── ENVIRONMENT.md
 │   │   └── CURRENT_CONTEXT.md
-│   └── README.md           # Kiro 系统文档
+│   └── README.md           # SCE 系统文档
 ```
 
 **验证：**
 ```bash
-kse status
+sce status
 ```
 
 **预期输出：**
@@ -141,7 +141,7 @@ Status: Ready
 让我们为用户登录功能生成一个 Spec 初稿：
 
 ```bash
-kse spec bootstrap --name 01-00-user-login --non-interactive
+sce spec bootstrap --name 01-00-user-login --non-interactive
 ```
 
 **预期输出：**
@@ -160,7 +160,7 @@ kse spec bootstrap --name 01-00-user-login --non-interactive
 多 Spec 场景下可直接使用：
 
 ```bash
-kse spec bootstrap --specs "01-00-user-login,01-01-user-session" --max-parallel 3
+sce spec bootstrap --specs "01-00-user-login,01-01-user-session" --max-parallel 3
 ```
 
 上述命令会默认切换到 orchestrate 模式并并行推进。
@@ -170,13 +170,13 @@ kse spec bootstrap --specs "01-00-user-login,01-01-user-session" --max-parallel
 先生成输入样例：
 
 ```bash
-kse value metrics sample --out ./kpi-input.json --period 2026-W10 --json
+sce value metrics sample --out ./kpi-input.json --period 2026-W10 --json
 ```
 
 再执行：
 
 ```bash
-kse value metrics snapshot --input ./kpi-input.json --json
+sce value metrics snapshot --input ./kpi-input.json --json
 ```
 
 如果你想手工编辑输入，也可以创建 `kpi-input.json`：
@@ -525,12 +525,12 @@ graph TD
 （可选）先执行标准化流程和闸口检查：
 
 ```bash
-kse spec pipeline run --spec 01-00-user-login
-kse spec gate run --spec 01-00-user-login --json
+sce spec pipeline run --spec 01-00-user-login
+sce spec gate run --spec 01-00-user-login --json
 ```
 
 ```bash
-kse context export 01-00-user-login
+sce context export 01-00-user-login
 ```
 
 **预期输出：**
@@ -585,7 +585,7 @@ kse context export 01-00-user-login
 
 1. **生成任务特定提示：**
    ```bash
-   kse prompt generate 01-00-user-login 1.1
+   sce prompt generate 01-00-user-login 1.1
    ```
 
 2. **打开 Cursor Composer**（Cmd+K 或 Ctrl+K）
@@ -601,11 +601,11 @@ kse context export 01-00-user-login
 
 1. **简单地告诉 AI：**
    ```
-   使用 kse 检查 01-00-user-login 的 spec 并实现任务 1.1
+   使用 sce 检查 01-00-user-login 的 spec 并实现任务 1.1
    ```
 
 2. **AI 将：**
-   - 自动运行 `kse context export 01-00-user-login`
+   - 自动运行 `sce context export 01-00-user-login`
    - 读取导出的上下文
    - 实现任务
    - 更新任务状态
@@ -642,7 +642,7 @@ kse context export 01-00-user-login
 
 **检查你的进度：**
 ```bash
-kse status
+sce status
 ```
 
 **预期输出：**
@@ -676,7 +676,7 @@ Spec: 01-00-user-login
 
 - **[集成模式](../integration-modes.md)** - 原生、手动和 Watch 模式
 - **[Spec 工作流](../spec-workflow.md)** - 深入了解 Spec 创建
-- **[命令参考](../command-reference.md)** - 所有 kse 命令
+- **[命令参考](../command-reference.md)** - 所有 sce 命令
 
 ### 查看真实示例
 
@@ -688,7 +688,7 @@ Spec: 01-00-user-login
 
 ## 故障排除
 
-### 问题："kse: command not found"
+### 问题："sce: command not found"
 
 **解决方案：**
 1. 重启终端
@@ -705,7 +705,7 @@ Spec: 01-00-user-login
 
 **解决方案：** 生成任务特定提示：
 ```bash
-kse prompt generate 01-00-user-login 1.1
+sce prompt generate 01-00-user-login 1.1
 ```
 
 这会为该任务创建一个更小、更集中的上下文。
@@ -718,7 +718,7 @@ kse prompt generate 01-00-user-login 1.1
 3. 在提示中明确说明："严格遵循设计文档"
 4. 包含 steering 规则：
    ```bash
-   kse context export 01-00-user-login --steering
+   sce context export 01-00-user-login --steering
    ```
 
 ### 问题：找不到我的 Spec 文件
@@ -740,13 +740,13 @@ ls .kiro/specs/
 ## 总结
 
 你已学会如何：
-- ✅ 安装和设置 kse
+- ✅ 安装和设置 sce
 - ✅ 创建包含需求、设计和任务的结构化 Spec
 - ✅ 为 AI 工具导出上下文
 - ✅ 使用 AI 基于 Spec 实现功能
 - ✅ 跟踪实现进度
 
-**kse 工作流：**
+**sce 工作流：**
 ```
 bootstrap Spec → pipeline/gate → 导出上下文 → AI 实现 → 更新任务 → 重复
 ```
@@ -754,7 +754,7 @@ bootstrap Spec → pipeline/gate → 导出上下文 → AI 实现 → 更新任
 **准备好构建你的下一个功能了吗？** 🚀
 
 ```bash
-kse spec bootstrap --name 02-00-your-next-feature --non-interactive
+sce spec bootstrap --name 02-00-your-next-feature --non-interactive
 ```
 
 ---

package/docs/zh/release-checklist.md

@@ -20,8 +20,8 @@ npm run test:skip-audit
 npm test -- tests/unit/commands/value-metrics.test.js
 
 # CLI 冒烟
-node bin/kiro-spec-engine.js --help
-node bin/kiro-spec-engine.js value metrics --help
+node bin/scene-capability-engine.js --help
+node bin/scene-capability-engine.js value metrics --help
 ```
 
 ---
@@ -29,8 +29,8 @@ node bin/kiro-spec-engine.js value metrics --help
 ## 2. Value 可观测冒烟流程
 
 ```bash
-kse value metrics sample --out ./kpi-input.json --json
-kse value metrics snapshot --input ./kpi-input.json --json
+sce value metrics sample --out ./kpi-input.json --json
+sce value metrics snapshot --input ./kpi-input.json --json
 ```
 
 预期：
@@ -70,7 +70,7 @@ npm pack --dry-run
 rg -n "yourusername|support@example.com" README.md README.zh.md docs docs/zh -S
 
 # canonical 仓库链接扫描（应返回空）
-rg -n "github.com/kiro-spec-engine/kse" README.md README.zh.md docs START_HERE.txt INSTALL_OFFLINE.txt -S -g "!docs/release-checklist.md" -g "!docs/zh/release-checklist.md"
+rg -n "github.com/scene-capability-engine/sce" README.md README.zh.md docs START_HERE.txt INSTALL_OFFLINE.txt -S -g "!docs/release-checklist.md" -g "!docs/zh/release-checklist.md"
 ```
 
 ---
@@ -116,6 +116,6 @@ git log --oneline -n 15
   - `KSE_RELEASE_DRIFT_HARD_GATE_BLOCK_STREAK_MIN`：hard-gate preflight 连续 blocked 告警阈值（最近窗口，默认 `2`）
   - `KSE_RELEASE_DRIFT_PREFLIGHT_UNAVAILABLE_STREAK_MIN`：release preflight 连续 unavailable 告警阈值（最近窗口，默认 `2`）
 - 可选本地预演 release gate 历史索引产物：
-  - `kse auto handoff gate-index --dir .kiro/reports/release-evidence --out .kiro/reports/release-evidence/release-gate-history.json --json`
+  - `sce auto handoff gate-index --dir .kiro/reports/release-evidence --out .kiro/reports/release-evidence/release-gate-history.json --json`
 
 然后再执行你的正式发布流程（打 tag、push、npm publish、GitHub Release）。

package/docs/zh/releases/v1.46.2-validation.md

@@ -34,7 +34,7 @@ npm pack --dry-run
 
 结果：
 
-- Tarball：`kiro-spec-engine-1.46.2.tgz`
+- Tarball：`scene-capability-engine-1.46.2.tgz`
 - 包大小：约 889.8 kB
 - 文件数：317
 - 清单中未发现 Python 字节码临时产物（如 `__pycache__`、`*.pyc`）。

package/docs/zh/releases/v1.46.2.md

@@ -5,11 +5,11 @@
 ## 本版亮点
 
 - 新增 KPI 可观测命令，用于量化交付结果：
-  - `kse value metrics snapshot`
-  - `kse value metrics baseline`
-  - `kse value metrics trend`
+  - `sce value metrics snapshot`
+  - `sce value metrics baseline`
+  - `sce value metrics trend`
 - 新增首次使用脚手架命令：
-  - `kse value metrics sample`
+  - `sce value metrics sample`
 - 提升操作体验：
   - 失败提示新增“下一步命令”指引，降低上手阻力。
 - 强化产品优势表达：
@@ -21,7 +21,7 @@
 
 ## 为什么这个版本重要
 
-这个版本把 kse 从“流程工具”进一步升级为“可量化交付系统”：
+这个版本把 sce 从“流程工具”进一步升级为“可量化交付系统”：
 
 - 可按周生成机器可读 KPI 证据；
 - 可比较 baseline 与 trend 做风险判断；
@@ -30,10 +30,10 @@
 ## 3 分钟快速验证
 
 ```bash
-kse adopt
-kse spec bootstrap --name 01-00-demo-feature --non-interactive
-kse value metrics sample --out ./kpi-input.json --json
-kse value metrics snapshot --input ./kpi-input.json --json
+sce adopt
+sce spec bootstrap --name 01-00-demo-feature --non-interactive
+sce value metrics sample --out ./kpi-input.json --json
+sce value metrics snapshot --input ./kpi-input.json --json
 ```
 
 ## 升级说明

package/docs/zh/spec-numbering-guide.md

@@ -4,7 +4,7 @@
 
 ## 概述
 
-Kiro Spec Engine 使用两部分编号系统：`{主序号}-{从序号}-{描述}`
+Scene Capability Engine 使用两部分编号系统：`{主序号}-{从序号}-{描述}`
 
 - **主序号**：代表功能领域或主题（01, 02, 03, ...）
 - **从序号**：代表该领域内的迭代或子功能（00, 01, 02, ...）
@@ -169,7 +169,7 @@ Kiro Spec Engine 使用两部分编号系统：`{主序号}-{从序号}-{描述}
 
 ## 实际案例
 
-### 案例 1：工具/库项目（kiro-spec-engine）
+### 案例 1：工具/库项目（scene-capability-engine）
 
 **项目类型**：具有独立功能的 CLI 工具
 
@@ -314,17 +314,17 @@ Kiro Spec Engine 使用两部分编号系统：`{主序号}-{从序号}-{描述}
 
 ## 工具支持
 
-Kiro Spec Engine 提供命令帮助编号：
+Scene Capability Engine 提供命令帮助编号：
 
 ```bash
 # 列出所有 Spec 及其编号
-kse status
+sce status
 
 # 按主序号分组查看 Spec
-kse workflows
+sce workflows
 
 # 获取下一个可用编号建议
-kse workflows --suggest-next
+sce workflows --suggest-next
 ```
 
 ## 总结

package/docs/zh/tools/claude-guide.md

@@ -1,6 +1,6 @@
-# 在 Claude Code 中使用 kse
+# 在 Claude Code 中使用 sce
 
-> 将 kse 与 Claude Code 集成进行 AI 辅助开发的完整指南
+> 将 sce 与 Claude Code 集成进行 AI 辅助开发的完整指南
 
 ---
 
@@ -16,9 +16,9 @@
 
 **Claude Code** 是 Anthropic 的 AI 编码助手，通过对话界面提供代码生成、解释和调试。
 
-**kse 与 Claude 的集成**使用**手动导出**模式，你导出 Spec 上下文并将其粘贴到 Claude 对话中。
+**sce 与 Claude 的集成**使用**手动导出**模式，你导出 Spec 上下文并将其粘贴到 Claude 对话中。
 
-### 为什么在 Claude 中使用 kse？
+### 为什么在 Claude 中使用 sce？
 
 - ✅ **长上下文窗口** - Claude 可以处理大型 Spec
 - ✅ **深度理解** - Claude 擅长理解复杂需求
@@ -32,8 +32,8 @@
 **模式：** 手动导出
 
 **工作原理：**
-1. 你在 kse 中创建 Spec（需求、设计、任务）
-2. 你使用 `kse context export` 导出上下文
+1. 你在 sce 中创建 Spec（需求、设计、任务）
+2. 你使用 `sce context export` 导出上下文
 3. 你将上下文复制并粘贴到 Claude 对话中
 4. Claude 基于你的 Spec 生成代码
 5. 你将代码复制到项目中
@@ -46,8 +46,8 @@
 ### 前置条件
 
 - **Claude 账户**（[注册](https://claude.ai/)）
-- 已全局安装 **kse**（`npm install -g kiro-spec-engine`）
-- 项目已被 kse **采用**（`kse adopt`）
+- 已全局安装 **sce**（`npm install -g scene-capability-engine`）
+- 项目已被 sce **采用**（`sce adopt`）
 
 ### 无需特殊设置
 
@@ -65,7 +65,7 @@ Claude 通过 Web 界面工作，无需特殊配置。只需导出上下文并
 
 1. **导出 Spec 上下文：**
    ```bash
-   kse context export 01-00-user-login
+   sce context export 01-00-user-login
    ```
 
 2. **复制上下文到剪贴板：**
@@ -109,7 +109,7 @@ Claude 通过 Web 界面工作，无需特殊配置。只需导出上下文并
 
 1. **生成任务特定提示：**
    ```bash
-   kse prompt generate 01-00-user-login 1.1
+   sce prompt generate 01-00-user-login 1.1
    ```
 
 2. **复制生成的提示**
@@ -129,12 +129,12 @@ Claude 通过 Web 界面工作，无需特殊配置。只需导出上下文并
 
 ```bash
 # 1. 创建 Spec
-kse spec bootstrap --name 01-00-user-login --non-interactive
+sce spec bootstrap --name 01-00-user-login --non-interactive
 
 # 2. 编写 requirements.md、design.md、tasks.md
 
 # 3. 导出并复制上下文
-kse context export 01-00-user-login
+sce context export 01-00-user-login
 cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
 
 # 4. 在 Claude 中：
@@ -272,7 +272,7 @@ Claude 擅长解释。询问：
 **解决方案：**
 1. 使用任务特定提示：
    ```bash
-   kse prompt generate 01-00-user-login 1.1
+   sce prompt generate 01-00-user-login 1.1
    ```
 2. 或手动提供较小的上下文：
    - 仅粘贴相关的设计部分
@@ -329,7 +329,7 @@ Claude 擅长解释。询问：
 
 ## 相关文档
 
-- 📖 [快速入门指南](../quick-start.md) - 开始使用 kse
+- 📖 [快速入门指南](../quick-start.md) - 开始使用 sce
 - 🔌 [集成模式](../integration-modes.md) - 理解手动导出模式
 - 📋 [Spec 工作流](../spec-workflow.md) - 创建有效的 Spec
 - 🔧 [故障排除](../troubleshooting.md) - 常见问题

package/docs/zh/tools/cursor-guide.md

@@ -1,6 +1,6 @@
-# 在 Cursor 中使用 kse
+# 在 Cursor 中使用 sce
 
-> 将 kse 与 Cursor IDE 集成进行 AI 辅助开发的完整指南
+> 将 sce 与 Cursor IDE 集成进行 AI 辅助开发的完整指南
 
 ---
 
@@ -16,9 +16,9 @@
 
 **Cursor** 是一个基于 VS Code 构建的 AI 驱动 IDE，通过 Composer 模式提供智能代码补全、基于聊天的编码和 AI 结对编程。
 
-**kse 与 Cursor 的集成**使用**手动导出**模式，你导出 Spec 上下文并将其提供给 Cursor 的 AI 功能（Chat、Composer 或内联建议）。
+**sce 与 Cursor 的集成**使用**手动导出**模式，你导出 Spec 上下文并将其提供给 Cursor 的 AI 功能（Chat、Composer 或内联建议）。
 
-### 为什么在 Cursor 中使用 kse？
+### 为什么在 Cursor 中使用 sce？
 
 - ✅ **结构化上下文** - Cursor 理解你的需求和设计
 - ✅ **更好的代码生成** - AI 遵循你的架构决策
@@ -32,8 +32,8 @@
 **模式：** 手动导出
 
 **工作原理：**
-1. 你在 kse 中创建 Spec（需求、设计、任务）
-2. 你使用 `kse context export` 导出上下文
+1. 你在 sce 中创建 Spec（需求、设计、任务）
+2. 你使用 `sce context export` 导出上下文
 3. 你将上下文提供给 Cursor（Chat、Composer 或 .cursorrules）
 4. Cursor 基于你的 Spec 生成代码
 5. 你在 tasks.md 中更新任务状态
@@ -45,17 +45,17 @@
 ### 前置条件
 
 - 已安装 **Cursor IDE**（[下载](https://cursor.sh/)）
-- 已全局安装 **kse**（`npm install -g kiro-spec-engine`）
-- 项目已被 kse **采用**（`kse adopt`）
+- 已全局安装 **sce**（`npm install -g scene-capability-engine`）
+- 项目已被 sce **采用**（`sce adopt`）
 
-### 步骤 1：为 kse 配置 Cursor
+### 步骤 1：为 sce 配置 Cursor
 
 在项目根目录创建 `.cursorrules` 文件：
 
 ```markdown
 # 项目规则
 
-此项目使用 kse (Kiro Spec Engine) 进行规范驱动开发。
+此项目使用 sce (Scene Capability Engine) 进行规范驱动开发。
 
 ## Spec 位置
 所有 Spec 都在 `.kiro/specs/` 目录中。
@@ -93,7 +93,7 @@
 
 1. **导出 Spec 上下文：**
    ```bash
-   kse context export 01-00-user-login
+   sce context export 01-00-user-login
    ```
 
 2. **打开 Composer：**
@@ -133,7 +133,7 @@
 
 1. **生成任务特定提示：**
    ```bash
-   kse prompt generate 01-00-user-login 1.1
+   sce prompt generate 01-00-user-login 1.1
    ```
 
 2. **打开 Chat：**
@@ -173,12 +173,12 @@
 
 ```bash
 # 1. 创建 Spec
-kse spec bootstrap --name 01-00-user-login --non-interactive
+sce spec bootstrap --name 01-00-user-login --non-interactive
 
 # 2. 编写 requirements.md、design.md、tasks.md
 
 # 3. 导出上下文
-kse context export 01-00-user-login
+sce context export 01-00-user-login
 
 # 4. 在 Cursor Composer 中（Cmd+K）：
 "请实现 .kiro/specs/01-00-user-login/ 中的任务 1.1"
@@ -197,13 +197,13 @@ kse context export 01-00-user-login
 
 ### 1. 使用 .cursorrules
 
-始终在项目根目录创建 `.cursorrules` 文件，告诉 Cursor 关于你的 kse Spec。
+始终在项目根目录创建 `.cursorrules` 文件，告诉 Cursor 关于你的 sce Spec。
 
 ### 2. 任务特定提示
 
 对于大型 Spec，使用任务特定提示：
 ```bash
-kse prompt generate 01-00-user-login 1.1
+sce prompt generate 01-00-user-login 1.1
 ```
 
 这会创建一个更小、更集中的上下文。
@@ -247,7 +247,7 @@ kse prompt generate 01-00-user-login 1.1
 **解决方案：**
 使用任务特定提示：
 ```bash
-kse prompt generate 01-00-user-login 1.1
+sce prompt generate 01-00-user-login 1.1
 ```
 
 ### 问题：Cursor 看不到我的 Spec 文件
@@ -261,7 +261,7 @@ kse prompt generate 01-00-user-login 1.1
 
 ## 相关文档
 
-- 📖 [快速入门指南](../quick-start.md) - 开始使用 kse
+- 📖 [快速入门指南](../quick-start.md) - 开始使用 sce
 - 🔌 [集成模式](../integration-modes.md) - 理解手动导出模式
 - 📋 [Spec 工作流](../spec-workflow.md) - 创建有效的 Spec
 - 🔧 [故障排除](../troubleshooting.md) - 常见问题