scene-capability-engine 3.0.1 → 3.0.2

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 (170) hide show
  1. package/CHANGELOG.md +233 -233
  2. package/LICENSE +2 -2
  3. package/README.md +8 -11
  4. package/README.zh.md +7 -10
  5. package/bin/kse.js +1 -1
  6. package/bin/sce.js +1 -1
  7. package/bin/sco.js +1 -1
  8. package/docs/331-poc-adaptation-roadmap.md +25 -25
  9. package/docs/331-poc-dual-track-integration-guide.md +26 -26
  10. package/docs/331-poc-weekly-delivery-checklist.md +8 -8
  11. package/docs/OFFLINE_INSTALL.md +10 -10
  12. package/docs/README.md +24 -24
  13. package/docs/adopt-migration-guide.md +51 -51
  14. package/docs/adoption-guide.md +56 -56
  15. package/docs/agent-hooks-analysis.md +52 -52
  16. package/docs/architecture.md +6 -6
  17. package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
  18. package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
  19. package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
  20. package/docs/autonomous-control-guide.md +89 -89
  21. package/docs/command-reference.md +11 -11
  22. package/docs/community.md +4 -4
  23. package/docs/cross-tool-guide.md +47 -47
  24. package/docs/developer-guide.md +5 -5
  25. package/docs/document-governance.md +91 -91
  26. package/docs/environment-management-guide.md +53 -53
  27. package/docs/examples/add-export-command/design.md +2 -2
  28. package/docs/examples/add-export-command/requirements.md +5 -5
  29. package/docs/examples/add-export-command/tasks.md +2 -2
  30. package/docs/faq.md +69 -69
  31. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
  32. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
  33. package/docs/integration-modes.md +60 -60
  34. package/docs/integration-philosophy.md +48 -48
  35. package/docs/knowledge-management-guide.md +21 -21
  36. package/docs/manual-workflows-guide.md +20 -20
  37. package/docs/moqui-capability-matrix.md +22 -22
  38. package/docs/moqui-template-core-library-playbook.md +20 -20
  39. package/docs/multi-agent-coordination-guide.md +19 -19
  40. package/docs/multi-repo-management-guide.md +93 -93
  41. package/docs/quick-start-with-ai-tools.md +36 -36
  42. package/docs/quick-start.md +16 -16
  43. package/docs/release-checklist.md +7 -7
  44. package/docs/releases/v1.46.2-validation.md +1 -1
  45. package/docs/releases/v1.46.2.md +10 -10
  46. package/docs/scene-runtime-guide.md +42 -42
  47. package/docs/spec-collaboration-guide.md +43 -43
  48. package/docs/spec-locking-guide.md +26 -26
  49. package/docs/spec-numbering-guide.md +6 -6
  50. package/docs/spec-workflow.md +25 -25
  51. package/docs/steering-strategy-guide.md +36 -36
  52. package/docs/team-collaboration-guide.md +23 -23
  53. package/docs/testing-strategy.md +2 -2
  54. package/docs/tools/claude-guide.md +26 -26
  55. package/docs/tools/cursor-guide.md +31 -31
  56. package/docs/tools/generic-guide.md +22 -22
  57. package/docs/tools/kiro-guide.md +43 -43
  58. package/docs/tools/vscode-guide.md +18 -18
  59. package/docs/tools/windsurf-guide.md +50 -50
  60. package/docs/troubleshooting.md +116 -116
  61. package/docs/upgrade-guide.md +49 -49
  62. package/docs/value-observability-guide.md +6 -6
  63. package/docs/zh/README.md +22 -22
  64. package/docs/zh/quick-start.md +34 -34
  65. package/docs/zh/release-checklist.md +6 -6
  66. package/docs/zh/releases/v1.46.2-validation.md +1 -1
  67. package/docs/zh/releases/v1.46.2.md +9 -9
  68. package/docs/zh/spec-numbering-guide.md +6 -6
  69. package/docs/zh/tools/claude-guide.md +14 -14
  70. package/docs/zh/tools/cursor-guide.md +18 -18
  71. package/docs/zh/tools/generic-guide.md +40 -40
  72. package/docs/zh/tools/kiro-guide.md +50 -50
  73. package/docs/zh/tools/vscode-guide.md +20 -20
  74. package/docs/zh/tools/windsurf-guide.md +49 -49
  75. package/docs/zh/value-observability-guide.md +6 -6
  76. package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
  77. package/lib/adoption/adoption-logger.js +1 -1
  78. package/lib/adoption/adoption-strategy.js +3 -3
  79. package/lib/adoption/detection-engine.js +1 -1
  80. package/lib/adoption/error-formatter.js +17 -17
  81. package/lib/adoption/progress-reporter.js +2 -2
  82. package/lib/adoption/smart-orchestrator.js +2 -2
  83. package/lib/adoption/strategy-selector.js +2 -2
  84. package/lib/adoption/summary-generator.js +3 -3
  85. package/lib/auto/autonomous-engine.js +2 -2
  86. package/lib/auto/close-loop-runner.js +9 -9
  87. package/lib/backup/backup-system.js +2 -2
  88. package/lib/collab/collab-manager.js +2 -2
  89. package/lib/commands/adopt.js +16 -16
  90. package/lib/commands/auto.js +93 -93
  91. package/lib/commands/collab.js +8 -8
  92. package/lib/commands/docs.js +26 -26
  93. package/lib/commands/doctor.js +2 -2
  94. package/lib/commands/env.js +14 -14
  95. package/lib/commands/knowledge.js +13 -13
  96. package/lib/commands/lock.js +6 -6
  97. package/lib/commands/ops.js +19 -19
  98. package/lib/commands/orchestrate.js +5 -5
  99. package/lib/commands/prompt.js +3 -3
  100. package/lib/commands/rollback.js +4 -4
  101. package/lib/commands/scene.js +29 -29
  102. package/lib/commands/spec-bootstrap.js +1 -1
  103. package/lib/commands/spec-gate.js +1 -1
  104. package/lib/commands/spec-pipeline.js +1 -1
  105. package/lib/commands/task.js +1 -1
  106. package/lib/commands/templates.js +27 -27
  107. package/lib/commands/upgrade.js +8 -8
  108. package/lib/commands/value.js +4 -4
  109. package/lib/commands/watch.js +9 -9
  110. package/lib/commands/workflows.js +5 -5
  111. package/lib/commands/workspace-multi.js +17 -17
  112. package/lib/commands/workspace.js +5 -5
  113. package/lib/context/context-exporter.js +1 -1
  114. package/lib/context/prompt-generator.js +1 -1
  115. package/lib/data/moqui-capability-lexicon.json +1 -1
  116. package/lib/environment/environment-manager.js +1 -1
  117. package/lib/gitignore/gitignore-detector.js +4 -4
  118. package/lib/gitignore/gitignore-integration.js +2 -2
  119. package/lib/gitignore/gitignore-transformer.js +3 -3
  120. package/lib/gitignore/layered-rules-template.js +2 -2
  121. package/lib/governance/diagnostic-engine.js +4 -4
  122. package/lib/governance/doc-reference-checker.js +1 -1
  123. package/lib/governance/hooks-manager.js +5 -5
  124. package/lib/governance/reporter.js +1 -1
  125. package/lib/knowledge/knowledge-manager.js +6 -6
  126. package/lib/orchestrator/agent-spawner.js +1 -1
  127. package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
  128. package/lib/repo/config-manager.js +2 -2
  129. package/lib/repo/handlers/init-handler.js +3 -3
  130. package/lib/scene-runtime/audit-emitter.js +2 -2
  131. package/lib/scene-runtime/binding-plugin-loader.js +1 -1
  132. package/lib/scene-runtime/moqui-adapter.js +2 -2
  133. package/lib/scene-runtime/moqui-extractor.js +3 -3
  134. package/lib/scene-runtime/scene-loader.js +3 -3
  135. package/lib/scene-runtime/scene-template-linter.js +1 -1
  136. package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
  137. package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
  138. package/lib/spec/multi-spec-orchestrate.js +1 -1
  139. package/lib/spec-gate/rules/default-rules.js +1 -1
  140. package/lib/steering/adoption-config.js +1 -1
  141. package/lib/steering/compliance-auto-fixer.js +1 -1
  142. package/lib/steering/compliance-cache.js +3 -3
  143. package/lib/steering/compliance-error-reporter.js +1 -1
  144. package/lib/steering/index.js +1 -1
  145. package/lib/steering/steering-manager.js +7 -7
  146. package/lib/task/task-claimer.js +2 -1
  147. package/lib/templates/metadata-collector.js +6 -6
  148. package/lib/templates/template-creator.js +2 -2
  149. package/lib/templates/template-exporter.js +12 -12
  150. package/lib/upgrade/migration-engine.js +4 -4
  151. package/lib/utils/tool-detector.js +25 -25
  152. package/lib/utils/validation.js +3 -3
  153. package/lib/version/version-checker.js +13 -13
  154. package/lib/version/version-manager.js +7 -7
  155. package/lib/watch/presets.js +4 -4
  156. package/lib/workspace/multi/path-utils.js +1 -1
  157. package/lib/workspace/multi/workspace-context-resolver.js +9 -9
  158. package/lib/workspace/multi/workspace-registry.js +2 -2
  159. package/lib/workspace/multi/workspace-state-manager.js +1 -1
  160. package/lib/workspace/multi/workspace.js +1 -1
  161. package/lib/workspace/workspace-sync.js +1 -1
  162. package/locales/en.json +1 -1
  163. package/locales/zh.json +1 -1
  164. package/package.json +3 -5
  165. package/template/.kiro/README.md +40 -40
  166. package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
  167. package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
  168. package/template/.kiro/steering/ENVIRONMENT.md +2 -2
  169. package/template/README.md +3 -3
  170. /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
@@ -1,6 +1,6 @@
1
- # 在任何 AI 工具中使用 kse
1
+ # 在任何 AI 工具中使用 sce
2
2
 
3
- > 将 kse 与任何 AI 编码助手集成的通用指南
3
+ > 将 sce 与任何 AI 编码助手集成的通用指南
4
4
 
5
5
  ---
6
6
 
@@ -14,9 +14,9 @@
14
14
 
15
15
  ## 概述
16
16
 
17
- **kse 适用于任何 AI 编码工具。** 本指南展示了如何将 kse 与任何 AI 助手集成,无论是 IDE、聊天机器人还是命令行工具。
17
+ **sce 适用于任何 AI 编码工具。** 本指南展示了如何将 sce 与任何 AI 助手集成,无论是 IDE、聊天机器人还是命令行工具。
18
18
 
19
- ### 为什么在任何 AI 工具中使用 kse
19
+ ### 为什么在任何 AI 工具中使用 sce
20
20
 
21
21
  - ✅ **工具无关** - 适用于任何 AI 助手
22
22
  - ✅ **灵活集成** - 选择最适合你的模式
@@ -27,35 +27,35 @@
27
27
 
28
28
  ## 三种集成模式
29
29
 
30
- kse 支持三种集成模式。选择最适合你的 AI 工具的一种:
30
+ sce 支持三种集成模式。选择最适合你的 AI 工具的一种:
31
31
 
32
32
  ### 模式 1:原生集成
33
33
 
34
34
  **最佳用于:** 可以执行 shell 命令的 AI 工具
35
35
 
36
- **工具示例:** Windsurf、Cline、Kiro、Aider
36
+ **工具示例:** Windsurf、Cline、SCE、Aider
37
37
 
38
38
  **工作原理:**
39
- 1. AI 工具直接运行 kse 命令
39
+ 1. AI 工具直接运行 sce 命令
40
40
  2. AI 读取导出的上下文
41
41
  3. AI 生成代码
42
42
  4. AI 可以更新任务状态
43
43
 
44
44
  **设置:**
45
45
  ```bash
46
- # 确保 kse 已安装并在 PATH 中
47
- kse --version
46
+ # 确保 sce 已安装并在 PATH 中
47
+ sce --version
48
48
 
49
49
  # 采用项目
50
- kse adopt
50
+ sce adopt
51
51
 
52
52
  # 创建 Spec
53
- kse spec bootstrap --name 01-00-my-feature --non-interactive
53
+ sce spec bootstrap --name 01-00-my-feature --non-interactive
54
54
  ```
55
55
 
56
56
  **使用:**
57
57
  ```
58
- 告诉 AI:"使用 kse 检查 01-00-my-feature 的 spec 并实现任务 1.1"
58
+ 告诉 AI:"使用 sce 检查 01-00-my-feature 的 spec 并实现任务 1.1"
59
59
  ```
60
60
 
61
61
  ### 模式 2:手动导出
@@ -65,27 +65,27 @@ kse spec bootstrap --name 01-00-my-feature --non-interactive
65
65
  **工具示例:** Claude、ChatGPT、Cursor、Copilot
66
66
 
67
67
  **工作原理:**
68
- 1. 你使用 kse 导出上下文
68
+ 1. 你使用 sce 导出上下文
69
69
  2. 你将上下文复制到 AI 工具
70
70
  3. AI 生成代码
71
71
  4. 你手动更新任务状态
72
72
 
73
73
  **设置:**
74
74
  ```bash
75
- # 安装 kse
76
- npm install -g kiro-spec-engine
75
+ # 安装 sce
76
+ npm install -g scene-capability-engine
77
77
 
78
78
  # 采用项目
79
- kse adopt
79
+ sce adopt
80
80
 
81
81
  # 创建 Spec
82
- kse spec bootstrap --name 01-00-my-feature --non-interactive
82
+ sce spec bootstrap --name 01-00-my-feature --non-interactive
83
83
  ```
84
84
 
85
85
  **使用:**
86
86
  ```bash
87
87
  # 导出上下文
88
- kse context export 01-00-my-feature
88
+ sce context export 01-00-my-feature
89
89
 
90
90
  # 复制到剪贴板
91
91
  cat .kiro/specs/01-00-my-feature/context-export.md | pbcopy
@@ -107,11 +107,11 @@ cat .kiro/specs/01-00-my-feature/context-export.md | pbcopy
107
107
  **设置:**
108
108
  ```bash
109
109
  # 启动 Watch 模式
110
- kse watch start
110
+ sce watch start
111
111
 
112
112
  # 配置自动导出
113
- kse watch add --pattern ".kiro/specs/*/requirements.md" --action "kse context export {spec}"
114
- kse watch add --pattern ".kiro/specs/*/design.md" --action "kse context export {spec}"
113
+ sce watch add --pattern ".kiro/specs/*/requirements.md" --action "sce context export {spec}"
114
+ sce watch add --pattern ".kiro/specs/*/design.md" --action "sce context export {spec}"
115
115
  ```
116
116
 
117
117
  **使用:**
@@ -128,7 +128,7 @@ kse watch add --pattern ".kiro/specs/*/design.md" --action "kse context export {
128
128
  ### 步骤 1:创建 Spec
129
129
 
130
130
  ```bash
131
- kse spec bootstrap --name 01-00-my-feature --non-interactive
131
+ sce spec bootstrap --name 01-00-my-feature --non-interactive
132
132
  ```
133
133
 
134
134
  ### 步骤 2:编写 Spec
@@ -142,18 +142,18 @@ kse spec bootstrap --name 01-00-my-feature --non-interactive
142
142
 
143
143
  **选项 A:原生模式**
144
144
  ```
145
- 告诉 AI:"使用 kse 检查 spec 并实现任务 1.1"
145
+ 告诉 AI:"使用 sce 检查 spec 并实现任务 1.1"
146
146
  ```
147
147
 
148
148
  **选项 B:手动导出**
149
149
  ```bash
150
- kse context export 01-00-my-feature
150
+ sce context export 01-00-my-feature
151
151
  # 将 context-export.md 复制到 AI 工具
152
152
  ```
153
153
 
154
154
  **选项 C:任务特定提示**
155
155
  ```bash
156
- kse prompt generate 01-00-my-feature 1.1
156
+ sce prompt generate 01-00-my-feature 1.1
157
157
  # 将生成的提示复制到 AI 工具
158
158
  ```
159
159
 
@@ -253,7 +253,7 @@ AI 工具需要清晰的指令:
253
253
 
254
254
  对于大型 Spec,使用任务特定提示:
255
255
  ```bash
256
- kse prompt generate 01-00-my-feature 1.1
256
+ sce prompt generate 01-00-my-feature 1.1
257
257
  ```
258
258
 
259
259
  这会创建一个更小、更集中的上下文。
@@ -292,11 +292,11 @@ kse prompt generate 01-00-my-feature 1.1
292
292
 
293
293
  ```bash
294
294
  # 1. 创建并编写 Spec
295
- kse spec bootstrap --name 01-00-user-login --non-interactive
295
+ sce spec bootstrap --name 01-00-user-login --non-interactive
296
296
  # 编辑 requirements.md、design.md、tasks.md
297
297
 
298
298
  # 2. 导出上下文
299
- kse context export 01-00-user-login
299
+ sce context export 01-00-user-login
300
300
 
301
301
  # 3. 复制到剪贴板
302
302
  cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
@@ -315,10 +315,10 @@ cat .kiro/specs/01-00-user-login/context-export.md | pbcopy
315
315
 
316
316
  ```bash
317
317
  # 1. 创建并编写 Spec
318
- kse spec bootstrap --name 01-00-user-login --non-interactive
318
+ sce spec bootstrap --name 01-00-user-login --non-interactive
319
319
 
320
320
  # 2. 生成任务特定提示
321
- kse prompt generate 01-00-user-login 1.1
321
+ sce prompt generate 01-00-user-login 1.1
322
322
 
323
323
  # 3. 在 Cursor Composer 中(Cmd+K):
324
324
  # - 粘贴生成的提示
@@ -334,13 +334,13 @@ kse prompt generate 01-00-user-login 1.1
334
334
 
335
335
  ```bash
336
336
  # 1. 创建并编写 Spec
337
- kse spec bootstrap --name 01-00-user-login --non-interactive
337
+ sce spec bootstrap --name 01-00-user-login --non-interactive
338
338
 
339
339
  # 2. 在 Windsurf 中告诉 AI:
340
- "使用 kse 检查 01-00-user-login 的 spec 并实现任务 1.1"
340
+ "使用 sce 检查 01-00-user-login 的 spec 并实现任务 1.1"
341
341
 
342
342
  # 3. Windsurf 自动:
343
- # - 运行 kse context export
343
+ # - 运行 sce context export
344
344
  # - 读取 Spec
345
345
  # - 生成代码
346
346
  # - 更新 tasks.md
@@ -352,7 +352,7 @@ kse spec bootstrap --name 01-00-user-login --non-interactive
352
352
 
353
353
  ```bash
354
354
  # 1. 创建并编写 Spec
355
- kse spec bootstrap --name 01-00-user-login --non-interactive
355
+ sce spec bootstrap --name 01-00-user-login --non-interactive
356
356
 
357
357
  # 2. 创建实现文件
358
358
  # src/auth/AuthController.js
@@ -388,7 +388,7 @@ kse spec bootstrap --name 01-00-user-login --non-interactive
388
388
  **解决方案:**
389
389
  1. 使用任务特定提示:
390
390
  ```bash
391
- kse prompt generate 01-00-my-feature 1.1
391
+ sce prompt generate 01-00-my-feature 1.1
392
392
  ```
393
393
  2. 将大型 Spec 分解为更小的 Spec
394
394
  3. 仅包含相关部分
@@ -429,10 +429,10 @@ SPEC=$1
429
429
  TASK=$2
430
430
 
431
431
  # 导出上下文
432
- kse context export $SPEC
432
+ sce context export $SPEC
433
433
 
434
434
  # 生成提示
435
- kse prompt generate $SPEC $TASK
435
+ sce prompt generate $SPEC $TASK
436
436
 
437
437
  # 复制到剪贴板
438
438
  cat .kiro/specs/$SPEC/context-export.md | pbcopy
@@ -449,7 +449,7 @@ echo "现在粘贴到你的 AI 工具并请求实现"
449
449
  # 添加你的编码标准、约定等
450
450
 
451
451
  # 使用 steering 导出
452
- kse context export 01-00-my-feature --steering
452
+ sce context export 01-00-my-feature --steering
453
453
  ```
454
454
 
455
455
  ### 4. 模板化你的 Spec
@@ -470,7 +470,7 @@ cp -r .kiro/templates/api-feature-template .kiro/specs/02-00-new-feature
470
470
 
471
471
  ## 相关文档
472
472
 
473
- - 📖 [快速入门指南](../quick-start.md) - 开始使用 kse
473
+ - 📖 [快速入门指南](../quick-start.md) - 开始使用 sce
474
474
  - 🔌 [集成模式](../integration-modes.md) - 深入了解三种模式
475
475
  - 📋 [Spec 工作流](../spec-workflow.md) - 创建有效的 Spec
476
476
  - 🔧 [故障排除](../troubleshooting.md) - 常见问题
@@ -480,7 +480,7 @@ cp -r .kiro/templates/api-feature-template .kiro/specs/02-00-new-feature
480
480
  - [Cursor 指南](cursor-guide.md) - Cursor IDE 集成
481
481
  - [Claude 指南](claude-guide.md) - Claude Code 集成
482
482
  - [Windsurf 指南](windsurf-guide.md) - Windsurf IDE 集成
483
- - [Kiro 指南](kiro-guide.md) - Kiro IDE 原生集成
483
+ - [SCE 指南](SCE-guide.md) - AI IDE 原生集成
484
484
  - [VS Code 指南](vscode-guide.md) - VS Code + Copilot 集成
485
485
 
486
486
  ---
@@ -1,12 +1,12 @@
1
- # 在 Kiro 中使用 kse
1
+ # 在 SCE 中使用 sce
2
2
 
3
- > kseKiro IDE 的原生集成 - 最无缝的体验
3
+ > sceAI IDE 的原生集成 - 最无缝的体验
4
4
 
5
5
  ---
6
6
 
7
7
  **版本**: 1.42.0
8
8
  **最后更新**: 2026-02-11
9
- **工具**: Kiro IDE
9
+ **工具**: AI IDE
10
10
  **集成模式**: 原生集成
11
11
  **预计设置时间**: 0 分钟(开箱即用)
12
12
 
@@ -14,15 +14,15 @@
14
14
 
15
15
  ## 概述
16
16
 
17
- **Kiro IDE** 是专为 Spec 驱动开发设计的 AI 驱动 IDE。kse (Kiro Spec Engine) 是 Kiro 的核心组件。
17
+ **AI IDE** 是专为 Spec 驱动开发设计的 AI 驱动 IDE。sce (Scene Capability Engine) 是 SCE 的核心组件。
18
18
 
19
- **kseKiro 的集成**是**完全原生的** - 无需设置、无需手动导出、无需配置。一切都开箱即用!
19
+ **sceSCE 的集成**是**完全原生的** - 无需设置、无需手动导出、无需配置。一切都开箱即用!
20
20
 
21
- ### 为什么在 Kiro 中使用 kse
21
+ ### 为什么在 SCE 中使用 sce
22
22
 
23
23
  - ✅ **零配置** - 开箱即用
24
- - ✅ **原生集成** - kseKiro 的一部分
25
- - ✅ **自动上下文** - Kiro 始终知道你的 Spec
24
+ - ✅ **原生集成** - sceSCE 的一部分
25
+ - ✅ **自动上下文** - SCE 始终知道你的 Spec
26
26
  - ✅ **可视化工具** - Spec 浏览器、任务跟踪器等
27
27
  - ✅ **最佳体验** - 专为 Spec 驱动开发设计
28
28
 
@@ -33,10 +33,10 @@
33
33
  **模式:** 原生集成
34
34
 
35
35
  **工作原理:**
36
- 1. Kiro 自动检测 `.kiro/` 目录
37
- 2. Kiro 的 AI 始终可以访问你的 Spec
36
+ 1. SCE 自动检测 `.kiro/` 目录
37
+ 2. SCE 的 AI 始终可以访问你的 Spec
38
38
  3. 无需手动导出或粘贴
39
- 4. Kiro 自动更新任务状态
39
+ 4. SCE 自动更新任务状态
40
40
  5. 可视化工具显示进度
41
41
 
42
42
  ---
@@ -45,13 +45,13 @@
45
45
 
46
46
  ### 无需设置!
47
47
 
48
- 如果你使用 Kiro IDE,kse 已经集成。只需:
48
+ 如果你使用 AI IDE,sce 已经集成。只需:
49
49
 
50
- 1. **打开你的项目** 在 Kiro
51
- 2. **运行 `kse adopt`**(如果尚未采用)
50
+ 1. **打开你的项目** 在 SCE
51
+ 2. **运行 `sce adopt`**(如果尚未采用)
52
52
  3. **开始创建 Spec!**
53
53
 
54
- 就是这样!Kiro 会处理其余的事情。
54
+ 就是这样!SCE 会处理其余的事情。
55
55
 
56
56
  ---
57
57
 
@@ -59,7 +59,7 @@
59
59
 
60
60
  ### 方法 1:使用 Spec 浏览器(推荐)
61
61
 
62
- Kiro 提供了一个可视化的 Spec 浏览器。
62
+ SCE 提供了一个可视化的 Spec 浏览器。
63
63
 
64
64
  **步骤:**
65
65
 
@@ -74,7 +74,7 @@ Kiro 提供了一个可视化的 Spec 浏览器。
74
74
 
75
75
  3. **实现任务**
76
76
  - 点击任务旁边的"实现"按钮
77
- - Kiro 的 AI 自动:
77
+ - SCE 的 AI 自动:
78
78
  - 读取 Spec 上下文
79
79
  - 生成代码
80
80
  - 更新任务状态
@@ -92,7 +92,7 @@ Kiro 提供了一个可视化的 Spec 浏览器。
92
92
  请实现 01-00-user-login 的任务 1.1
93
93
  ```
94
94
 
95
- 3. **Kiro 的 AI 自动:**
95
+ 3. **SCE 的 AI 自动:**
96
96
  - 读取 Spec(无需手动导出!)
97
97
  - 理解需求和设计
98
98
  - 生成代码
@@ -108,18 +108,18 @@ Kiro 提供了一个可视化的 Spec 浏览器。
108
108
 
109
109
  2. **输入:**
110
110
  ```
111
- kse: Implement Task
111
+ sce: Implement Task
112
112
  ```
113
113
 
114
114
  3. **选择:**
115
115
  - 选择 Spec(例如 01-00-user-login)
116
116
  - 选择任务(例如 1.1)
117
117
 
118
- 4. **Kiro 自动实现任务**
118
+ 4. **SCE 自动实现任务**
119
119
 
120
120
  ---
121
121
 
122
- ## Kiro 独有功能
122
+ ## SCE 独有功能
123
123
 
124
124
  ### 1. Spec 浏览器
125
125
 
@@ -139,7 +139,7 @@ Kiro 提供了一个可视化的 Spec 浏览器。
139
139
 
140
140
  ### 3. 需求验证
141
141
 
142
- Kiro 验证你的 Spec:
142
+ SCE 验证你的 Spec:
143
143
  - 检查需求完整性
144
144
  - 验证设计追溯
145
145
  - 建议改进
@@ -155,7 +155,7 @@ Kiro 验证你的 Spec:
155
155
 
156
156
  ### 5. 自动上下文管理
157
157
 
158
- Kiro 自动管理上下文:
158
+ SCE 自动管理上下文:
159
159
  - 无需手动导出
160
160
  - 始终最新
161
161
  - 智能上下文选择
@@ -168,16 +168,16 @@ Kiro 自动管理上下文:
168
168
  ### 完整功能实现工作流
169
169
 
170
170
  ```
171
- 1. 在 Kiro 中创建 Spec
172
- - 命令面板 → "kse: Create Spec"
171
+ 1. 在 SCE 中创建 Spec
172
+ - 命令面板 → "sce: Create Spec"
173
173
  - 输入名称:01-00-user-login
174
174
 
175
175
  2. 编写 Spec
176
- - Kiro 打开 requirements.md
176
+ - SCE 打开 requirements.md
177
177
  - 编写需求
178
- - Kiro 打开 design.md
178
+ - SCE 打开 design.md
179
179
  - 编写设计
180
- - Kiro 打开 tasks.md
180
+ - SCE 打开 tasks.md
181
181
  - 编写任务
182
182
 
183
183
  3. 在 Spec 浏览器中查看 Spec
@@ -186,7 +186,7 @@ Kiro 自动管理上下文:
186
186
 
187
187
  4. 实现任务
188
188
  - 点击任务 1.1 旁边的"实现"
189
- - Kiro 的 AI 生成代码
189
+ - SCE 的 AI 生成代码
190
190
  - 审查并接受
191
191
  - 任务自动标记为完成
192
192
 
@@ -205,14 +205,14 @@ Kiro 自动管理上下文:
205
205
 
206
206
  ### 1. 使用 Spec 浏览器
207
207
 
208
- Spec 浏览器是在 Kiro 中使用 kse 的最佳方式:
208
+ Spec 浏览器是在 SCE 中使用 sce 的最佳方式:
209
209
  - 可视化进度
210
210
  - 快速访问 Spec
211
211
  - 一键任务实现
212
212
 
213
- ### 2. 让 Kiro 管理任务状态
213
+ ### 2. 让 SCE 管理任务状态
214
214
 
215
- 不要手动编辑 tasks.md 中的复选框。让 Kiro 的 AI 更新它们:
215
+ 不要手动编辑 tasks.md 中的复选框。让 SCE 的 AI 更新它们:
216
216
  - 更准确
217
217
  - 自动同步
218
218
  - 在 Spec 浏览器中反映
@@ -220,20 +220,20 @@ Spec 浏览器是在 Kiro 中使用 kse 的最佳方式:
220
220
  ### 3. 使用需求验证
221
221
 
222
222
  在实现前验证你的 Spec:
223
- - 命令面板 → "kse: Validate Spec"
223
+ - 命令面板 → "sce: Validate Spec"
224
224
  - 修复任何问题
225
225
  - 然后开始实现
226
226
 
227
227
  ### 4. 利用设计可视化
228
228
 
229
229
  使用 Mermaid 图进行设计:
230
- - Kiro 渲染它们
230
+ - SCE 渲染它们
231
231
  - 交互式视图
232
232
  - 更容易理解架构
233
233
 
234
- ### 5. 使用 Kiro 的 AI 聊天
234
+ ### 5. 使用 SCE 的 AI 聊天
235
235
 
236
- Kiro 的 AI 始终知道你的 Spec:
236
+ SCE 的 AI 始终知道你的 Spec:
237
237
  - 无需粘贴上下文
238
238
  - 只需询问:"实现任务 1.1"
239
239
  - AI 自动读取 Spec
@@ -265,30 +265,30 @@ Kiro 的 AI 始终知道你的 Spec:
265
265
 
266
266
  ## 与其他工具的比较
267
267
 
268
- ### Kiro vs Cursor
268
+ ### SCE vs Cursor
269
269
 
270
- | 功能 | Kiro | Cursor |
270
+ | 功能 | SCE | Cursor |
271
271
  |------|------|--------|
272
- | kse 集成 | 原生 | 手动导出 |
272
+ | sce 集成 | 原生 | 手动导出 |
273
273
  | Spec 浏览器 | ✅ | ❌ |
274
274
  | 任务跟踪器 | ✅ | ❌ |
275
275
  | 自动上下文 | ✅ | ❌ |
276
276
  | 设置时间 | 0 分钟 | 5 分钟 |
277
277
 
278
- ### Kiro vs Windsurf
278
+ ### SCE vs Windsurf
279
279
 
280
- | 功能 | Kiro | Windsurf |
280
+ | 功能 | SCE | Windsurf |
281
281
  |------|------|----------|
282
- | kse 集成 | 原生 | 命令执行 |
282
+ | sce 集成 | 原生 | 命令执行 |
283
283
  | Spec 浏览器 | ✅ | ❌ |
284
284
  | 可视化工具 | ✅ | ❌ |
285
285
  | Watch 模式 | 内置 | 需要设置 |
286
286
 
287
- ### Kiro vs Claude
287
+ ### SCE vs Claude
288
288
 
289
- | 功能 | Kiro | Claude |
289
+ | 功能 | SCE | Claude |
290
290
  |------|------|--------|
291
- | kse 集成 | 原生 | 手动粘贴 |
291
+ | sce 集成 | 原生 | 手动粘贴 |
292
292
  | IDE 功能 | ✅ | ❌ |
293
293
  | 自动上下文 | ✅ | ❌ |
294
294
  | 任务管理 | ✅ | ❌ |
@@ -300,21 +300,21 @@ Kiro 的 AI 始终知道你的 Spec:
300
300
  ### 问题:Spec 浏览器为空
301
301
 
302
302
  **解决方案:**
303
- 1. 确保你已运行 `kse adopt`
303
+ 1. 确保你已运行 `sce adopt`
304
304
  2. 检查 `.kiro/specs/` 目录是否存在
305
305
  3. 刷新 Spec 浏览器(右键 → 刷新)
306
306
 
307
307
  ### 问题:AI 不读取我的 Spec
308
308
 
309
309
  **解决方案:**
310
- 1. 这不应该发生在 Kiro 中!
311
- 2. 如果发生,重启 Kiro
310
+ 1. 这不应该发生在 SCE 中!
311
+ 2. 如果发生,重启 SCE
312
312
  3. 验证 Spec 文件格式正确
313
313
 
314
314
  ### 问题:任务状态未更新
315
315
 
316
316
  **解决方案:**
317
- 1. 让 Kiro 的 AI 更新任务,不要手动编辑
317
+ 1. 让 SCE 的 AI 更新任务,不要手动编辑
318
318
  2. 如果手动编辑,刷新 Spec 浏览器
319
319
  3. 检查 tasks.md 格式是否正确
320
320
 
@@ -322,7 +322,7 @@ Kiro 的 AI 始终知道你的 Spec:
322
322
 
323
323
  ## 相关文档
324
324
 
325
- - 📖 [快速入门指南](../quick-start.md) - 开始使用 kse
325
+ - 📖 [快速入门指南](../quick-start.md) - 开始使用 sce
326
326
  - 🔌 [集成模式](../integration-modes.md) - 理解原生集成
327
327
  - 📋 [Spec 工作流](../spec-workflow.md) - 创建有效的 Spec
328
328
  - 🔧 [故障排除](../troubleshooting.md) - 常见问题
@@ -1,6 +1,6 @@
1
- # 在 VS Code + Copilot 中使用 kse
1
+ # 在 VS Code + Copilot 中使用 sce
2
2
 
3
- > 将 kse 与 VS Code 和 GitHub Copilot 集成进行 AI 辅助开发的完整指南
3
+ > 将 sce 与 VS Code 和 GitHub Copilot 集成进行 AI 辅助开发的完整指南
4
4
 
5
5
  ---
6
6
 
@@ -16,14 +16,14 @@
16
16
 
17
17
  **VS Code** 是最流行的代码编辑器,**GitHub Copilot** 提供 AI 驱动的代码补全。
18
18
 
19
- **kse 与 VS Code + Copilot 的集成**使用**手动导出**和**内联注释**,让 Copilot 理解你的 Spec 并生成匹配你设计的代码。
19
+ **sce 与 VS Code + Copilot 的集成**使用**手动导出**和**内联注释**,让 Copilot 理解你的 Spec 并生成匹配你设计的代码。
20
20
 
21
- ### 为什么在 VS Code + Copilot 中使用 kse
21
+ ### 为什么在 VS Code + Copilot 中使用 sce
22
22
 
23
23
  - ✅ **熟悉的环境** - 使用你已知的编辑器
24
24
  - ✅ **智能补全** - Copilot 遵循你的 Spec
25
25
  - ✅ **内联建议** - 在你输入时获得上下文感知的代码
26
- - ✅ **灵活集成** - 多种使用 kse 的方式
26
+ - ✅ **灵活集成** - 多种使用 sce 的方式
27
27
 
28
28
  ---
29
29
 
@@ -32,7 +32,7 @@
32
32
  **模式:** 手动导出 + 内联注释
33
33
 
34
34
  **工作原理:**
35
- 1. 你在 kse 中创建 Spec(需求、设计、任务)
35
+ 1. 你在 sce 中创建 Spec(需求、设计、任务)
36
36
  2. 你在代码中添加引用 Spec 的注释
37
37
  3. Copilot 读取注释和 Spec 文件
38
38
  4. Copilot 生成匹配你设计的代码
@@ -46,8 +46,8 @@
46
46
 
47
47
  - 已安装 **VS Code**([下载](https://code.visualstudio.com/))
48
48
  - 已安装 **GitHub Copilot** 扩展
49
- - 已全局安装 **kse**(`npm install -g kiro-spec-engine`)
50
- - 项目已被 kse **采用**(`kse adopt`)
49
+ - 已全局安装 **sce**(`npm install -g scene-capability-engine`)
50
+ - 项目已被 sce **采用**(`sce adopt`)
51
51
 
52
52
  ### 步骤 1:安装推荐的扩展
53
53
 
@@ -80,12 +80,12 @@
80
80
 
81
81
  ### 步骤 3:创建 Workspace 片段(可选但推荐)
82
82
 
83
- 创建 `.vscode/kse.code-snippets`:
83
+ 创建 `.vscode/sce.code-snippets`:
84
84
 
85
85
  ```json
86
86
  {
87
- "kse Spec Reference": {
88
- "prefix": "kse-ref",
87
+ "sce Spec Reference": {
88
+ "prefix": "sce-ref",
89
89
  "body": [
90
90
  "// Task ${1:1.1}: ${2:Task description}",
91
91
  "// Spec: .kiro/specs/${3:spec-name}/",
@@ -93,10 +93,10 @@
93
93
  "// Requirements: ${5:FR-1, FR-2}",
94
94
  "//"
95
95
  ],
96
- "description": "Add kse Spec reference comment"
96
+ "description": "Add sce Spec reference comment"
97
97
  },
98
- "kse Task Header": {
99
- "prefix": "kse-task",
98
+ "sce Task Header": {
99
+ "prefix": "sce-task",
100
100
  "body": [
101
101
  "/**",
102
102
  " * Task ${1:1.1}: ${2:Task description}",
@@ -109,7 +109,7 @@
109
109
  " * - ${6:Note 1}",
110
110
  " */"
111
111
  ],
112
- "description": "Add kse task header comment"
112
+ "description": "Add sce task header comment"
113
113
  }
114
114
  }
115
115
  ```
@@ -187,7 +187,7 @@
187
187
 
188
188
  1. **在文件中输入:**
189
189
  ```
190
- kse-ref
190
+ sce-ref
191
191
  ```
192
192
 
193
193
  2. **按 Tab** - 片段展开为:
@@ -211,7 +211,7 @@
211
211
 
212
212
  ```bash
213
213
  # 1. 创建 Spec
214
- kse spec bootstrap --name 01-00-user-login --non-interactive
214
+ sce spec bootstrap --name 01-00-user-login --non-interactive
215
215
 
216
216
  # 2. 在 VS Code 中编写 Spec
217
217
  # - 打开 requirements.md
@@ -221,8 +221,8 @@ kse spec bootstrap --name 01-00-user-login --non-interactive
221
221
  # 3. 创建实现文件
222
222
  # src/auth/AuthController.js
223
223
 
224
- # 4. 添加 Spec 引用(使用 kse-ref 片段)
225
- kse-ref [Tab]
224
+ # 4. 添加 Spec 引用(使用 sce-ref 片段)
225
+ sce-ref [Tab]
226
226
 
227
227
  # 5. 开始编码 - Copilot 建议代码
228
228
 
@@ -428,7 +428,7 @@ Copilot 使用所有打开文件的上下文。
428
428
 
429
429
  ## 相关文档
430
430
 
431
- - 📖 [快速入门指南](../quick-start.md) - 开始使用 kse
431
+ - 📖 [快速入门指南](../quick-start.md) - 开始使用 sce
432
432
  - 🔌 [集成模式](../integration-modes.md) - 理解手动导出模式
433
433
  - 📋 [Spec 工作流](../spec-workflow.md) - 创建有效的 Spec
434
434
  - 🔧 [故障排除](../troubleshooting.md) - 常见问题