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.
- package/CHANGELOG.md +233 -233
- package/LICENSE +2 -2
- package/README.md +8 -11
- package/README.zh.md +7 -10
- package/bin/kse.js +1 -1
- package/bin/sce.js +1 -1
- package/bin/sco.js +1 -1
- package/docs/331-poc-adaptation-roadmap.md +25 -25
- package/docs/331-poc-dual-track-integration-guide.md +26 -26
- package/docs/331-poc-weekly-delivery-checklist.md +8 -8
- package/docs/OFFLINE_INSTALL.md +10 -10
- package/docs/README.md +24 -24
- package/docs/adopt-migration-guide.md +51 -51
- package/docs/adoption-guide.md +56 -56
- package/docs/agent-hooks-analysis.md +52 -52
- package/docs/architecture.md +6 -6
- package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
- package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
- package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
- package/docs/autonomous-control-guide.md +89 -89
- package/docs/command-reference.md +11 -11
- package/docs/community.md +4 -4
- package/docs/cross-tool-guide.md +47 -47
- package/docs/developer-guide.md +5 -5
- package/docs/document-governance.md +91 -91
- package/docs/environment-management-guide.md +53 -53
- package/docs/examples/add-export-command/design.md +2 -2
- package/docs/examples/add-export-command/requirements.md +5 -5
- package/docs/examples/add-export-command/tasks.md +2 -2
- package/docs/faq.md +69 -69
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
- package/docs/integration-modes.md +60 -60
- package/docs/integration-philosophy.md +48 -48
- package/docs/knowledge-management-guide.md +21 -21
- package/docs/manual-workflows-guide.md +20 -20
- package/docs/moqui-capability-matrix.md +22 -22
- package/docs/moqui-template-core-library-playbook.md +20 -20
- package/docs/multi-agent-coordination-guide.md +19 -19
- package/docs/multi-repo-management-guide.md +93 -93
- package/docs/quick-start-with-ai-tools.md +36 -36
- package/docs/quick-start.md +16 -16
- package/docs/release-checklist.md +7 -7
- package/docs/releases/v1.46.2-validation.md +1 -1
- package/docs/releases/v1.46.2.md +10 -10
- package/docs/scene-runtime-guide.md +42 -42
- package/docs/spec-collaboration-guide.md +43 -43
- package/docs/spec-locking-guide.md +26 -26
- package/docs/spec-numbering-guide.md +6 -6
- package/docs/spec-workflow.md +25 -25
- package/docs/steering-strategy-guide.md +36 -36
- package/docs/team-collaboration-guide.md +23 -23
- package/docs/testing-strategy.md +2 -2
- package/docs/tools/claude-guide.md +26 -26
- package/docs/tools/cursor-guide.md +31 -31
- package/docs/tools/generic-guide.md +22 -22
- package/docs/tools/kiro-guide.md +43 -43
- package/docs/tools/vscode-guide.md +18 -18
- package/docs/tools/windsurf-guide.md +50 -50
- package/docs/troubleshooting.md +116 -116
- package/docs/upgrade-guide.md +49 -49
- package/docs/value-observability-guide.md +6 -6
- package/docs/zh/README.md +22 -22
- package/docs/zh/quick-start.md +34 -34
- package/docs/zh/release-checklist.md +6 -6
- package/docs/zh/releases/v1.46.2-validation.md +1 -1
- package/docs/zh/releases/v1.46.2.md +9 -9
- package/docs/zh/spec-numbering-guide.md +6 -6
- package/docs/zh/tools/claude-guide.md +14 -14
- package/docs/zh/tools/cursor-guide.md +18 -18
- package/docs/zh/tools/generic-guide.md +40 -40
- package/docs/zh/tools/kiro-guide.md +50 -50
- package/docs/zh/tools/vscode-guide.md +20 -20
- package/docs/zh/tools/windsurf-guide.md +49 -49
- package/docs/zh/value-observability-guide.md +6 -6
- package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
- package/lib/adoption/adoption-logger.js +1 -1
- package/lib/adoption/adoption-strategy.js +3 -3
- package/lib/adoption/detection-engine.js +1 -1
- package/lib/adoption/error-formatter.js +17 -17
- package/lib/adoption/progress-reporter.js +2 -2
- package/lib/adoption/smart-orchestrator.js +2 -2
- package/lib/adoption/strategy-selector.js +2 -2
- package/lib/adoption/summary-generator.js +3 -3
- package/lib/auto/autonomous-engine.js +2 -2
- package/lib/auto/close-loop-runner.js +9 -9
- package/lib/backup/backup-system.js +2 -2
- package/lib/collab/collab-manager.js +2 -2
- package/lib/commands/adopt.js +16 -16
- package/lib/commands/auto.js +93 -93
- package/lib/commands/collab.js +8 -8
- package/lib/commands/docs.js +26 -26
- package/lib/commands/doctor.js +2 -2
- package/lib/commands/env.js +14 -14
- package/lib/commands/knowledge.js +13 -13
- package/lib/commands/lock.js +6 -6
- package/lib/commands/ops.js +19 -19
- package/lib/commands/orchestrate.js +5 -5
- package/lib/commands/prompt.js +3 -3
- package/lib/commands/rollback.js +4 -4
- package/lib/commands/scene.js +29 -29
- package/lib/commands/spec-bootstrap.js +1 -1
- package/lib/commands/spec-gate.js +1 -1
- package/lib/commands/spec-pipeline.js +1 -1
- package/lib/commands/task.js +1 -1
- package/lib/commands/templates.js +27 -27
- package/lib/commands/upgrade.js +8 -8
- package/lib/commands/value.js +4 -4
- package/lib/commands/watch.js +9 -9
- package/lib/commands/workflows.js +5 -5
- package/lib/commands/workspace-multi.js +17 -17
- package/lib/commands/workspace.js +5 -5
- package/lib/context/context-exporter.js +1 -1
- package/lib/context/prompt-generator.js +1 -1
- package/lib/data/moqui-capability-lexicon.json +1 -1
- package/lib/environment/environment-manager.js +1 -1
- package/lib/gitignore/gitignore-detector.js +4 -4
- package/lib/gitignore/gitignore-integration.js +2 -2
- package/lib/gitignore/gitignore-transformer.js +3 -3
- package/lib/gitignore/layered-rules-template.js +2 -2
- package/lib/governance/diagnostic-engine.js +4 -4
- package/lib/governance/doc-reference-checker.js +1 -1
- package/lib/governance/hooks-manager.js +5 -5
- package/lib/governance/reporter.js +1 -1
- package/lib/knowledge/knowledge-manager.js +6 -6
- package/lib/orchestrator/agent-spawner.js +1 -1
- package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
- package/lib/repo/config-manager.js +2 -2
- package/lib/repo/handlers/init-handler.js +3 -3
- package/lib/scene-runtime/audit-emitter.js +2 -2
- package/lib/scene-runtime/binding-plugin-loader.js +1 -1
- package/lib/scene-runtime/moqui-adapter.js +2 -2
- package/lib/scene-runtime/moqui-extractor.js +3 -3
- package/lib/scene-runtime/scene-loader.js +3 -3
- package/lib/scene-runtime/scene-template-linter.js +1 -1
- package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
- package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
- package/lib/spec/multi-spec-orchestrate.js +1 -1
- package/lib/spec-gate/rules/default-rules.js +1 -1
- package/lib/steering/adoption-config.js +1 -1
- package/lib/steering/compliance-auto-fixer.js +1 -1
- package/lib/steering/compliance-cache.js +3 -3
- package/lib/steering/compliance-error-reporter.js +1 -1
- package/lib/steering/index.js +1 -1
- package/lib/steering/steering-manager.js +7 -7
- package/lib/task/task-claimer.js +2 -1
- package/lib/templates/metadata-collector.js +6 -6
- package/lib/templates/template-creator.js +2 -2
- package/lib/templates/template-exporter.js +12 -12
- package/lib/upgrade/migration-engine.js +4 -4
- package/lib/utils/tool-detector.js +25 -25
- package/lib/utils/validation.js +3 -3
- package/lib/version/version-checker.js +13 -13
- package/lib/version/version-manager.js +7 -7
- package/lib/watch/presets.js +4 -4
- package/lib/workspace/multi/path-utils.js +1 -1
- package/lib/workspace/multi/workspace-context-resolver.js +9 -9
- package/lib/workspace/multi/workspace-registry.js +2 -2
- package/lib/workspace/multi/workspace-state-manager.js +1 -1
- package/lib/workspace/multi/workspace.js +1 -1
- package/lib/workspace/workspace-sync.js +1 -1
- package/locales/en.json +1 -1
- package/locales/zh.json +1 -1
- package/package.json +3 -5
- package/template/.kiro/README.md +40 -40
- package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
- package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
- package/template/.kiro/steering/ENVIRONMENT.md +2 -2
- package/template/README.md +3 -3
- /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# 在任何 AI 工具中使用
|
|
1
|
+
# 在任何 AI 工具中使用 sce
|
|
2
2
|
|
|
3
|
-
> 将
|
|
3
|
+
> 将 sce 与任何 AI 编码助手集成的通用指南
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -14,9 +14,9 @@
|
|
|
14
14
|
|
|
15
15
|
## 概述
|
|
16
16
|
|
|
17
|
-
**
|
|
17
|
+
**sce 适用于任何 AI 编码工具。** 本指南展示了如何将 sce 与任何 AI 助手集成,无论是 IDE、聊天机器人还是命令行工具。
|
|
18
18
|
|
|
19
|
-
### 为什么在任何 AI 工具中使用
|
|
19
|
+
### 为什么在任何 AI 工具中使用 sce?
|
|
20
20
|
|
|
21
21
|
- ✅ **工具无关** - 适用于任何 AI 助手
|
|
22
22
|
- ✅ **灵活集成** - 选择最适合你的模式
|
|
@@ -27,35 +27,35 @@
|
|
|
27
27
|
|
|
28
28
|
## 三种集成模式
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
sce 支持三种集成模式。选择最适合你的 AI 工具的一种:
|
|
31
31
|
|
|
32
32
|
### 模式 1:原生集成
|
|
33
33
|
|
|
34
34
|
**最佳用于:** 可以执行 shell 命令的 AI 工具
|
|
35
35
|
|
|
36
|
-
**工具示例:** Windsurf、Cline、
|
|
36
|
+
**工具示例:** Windsurf、Cline、SCE、Aider
|
|
37
37
|
|
|
38
38
|
**工作原理:**
|
|
39
|
-
1. AI 工具直接运行
|
|
39
|
+
1. AI 工具直接运行 sce 命令
|
|
40
40
|
2. AI 读取导出的上下文
|
|
41
41
|
3. AI 生成代码
|
|
42
42
|
4. AI 可以更新任务状态
|
|
43
43
|
|
|
44
44
|
**设置:**
|
|
45
45
|
```bash
|
|
46
|
-
# 确保
|
|
47
|
-
|
|
46
|
+
# 确保 sce 已安装并在 PATH 中
|
|
47
|
+
sce --version
|
|
48
48
|
|
|
49
49
|
# 采用项目
|
|
50
|
-
|
|
50
|
+
sce adopt
|
|
51
51
|
|
|
52
52
|
# 创建 Spec
|
|
53
|
-
|
|
53
|
+
sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
**使用:**
|
|
57
57
|
```
|
|
58
|
-
告诉 AI:"使用
|
|
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. 你使用
|
|
68
|
+
1. 你使用 sce 导出上下文
|
|
69
69
|
2. 你将上下文复制到 AI 工具
|
|
70
70
|
3. AI 生成代码
|
|
71
71
|
4. 你手动更新任务状态
|
|
72
72
|
|
|
73
73
|
**设置:**
|
|
74
74
|
```bash
|
|
75
|
-
# 安装
|
|
76
|
-
npm install -g
|
|
75
|
+
# 安装 sce
|
|
76
|
+
npm install -g scene-capability-engine
|
|
77
77
|
|
|
78
78
|
# 采用项目
|
|
79
|
-
|
|
79
|
+
sce adopt
|
|
80
80
|
|
|
81
81
|
# 创建 Spec
|
|
82
|
-
|
|
82
|
+
sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
**使用:**
|
|
86
86
|
```bash
|
|
87
87
|
# 导出上下文
|
|
88
|
-
|
|
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
|
-
|
|
110
|
+
sce watch start
|
|
111
111
|
|
|
112
112
|
# 配置自动导出
|
|
113
|
-
|
|
114
|
-
|
|
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
|
-
|
|
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:"使用
|
|
145
|
+
告诉 AI:"使用 sce 检查 spec 并实现任务 1.1"
|
|
146
146
|
```
|
|
147
147
|
|
|
148
148
|
**选项 B:手动导出**
|
|
149
149
|
```bash
|
|
150
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
318
|
+
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
319
319
|
|
|
320
320
|
# 2. 生成任务特定提示
|
|
321
|
-
|
|
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
|
-
|
|
337
|
+
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
338
338
|
|
|
339
339
|
# 2. 在 Windsurf 中告诉 AI:
|
|
340
|
-
"使用
|
|
340
|
+
"使用 sce 检查 01-00-user-login 的 spec 并实现任务 1.1"
|
|
341
341
|
|
|
342
342
|
# 3. Windsurf 自动:
|
|
343
|
-
# - 运行
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
432
|
+
sce context export $SPEC
|
|
433
433
|
|
|
434
434
|
# 生成提示
|
|
435
|
-
|
|
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
|
-
|
|
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) - 开始使用
|
|
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
|
-
- [
|
|
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
|
-
# 在
|
|
1
|
+
# 在 SCE 中使用 sce
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> sce 与 AI IDE 的原生集成 - 最无缝的体验
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
**版本**: 1.42.0
|
|
8
8
|
**最后更新**: 2026-02-11
|
|
9
|
-
**工具**:
|
|
9
|
+
**工具**: AI IDE
|
|
10
10
|
**集成模式**: 原生集成
|
|
11
11
|
**预计设置时间**: 0 分钟(开箱即用)
|
|
12
12
|
|
|
@@ -14,15 +14,15 @@
|
|
|
14
14
|
|
|
15
15
|
## 概述
|
|
16
16
|
|
|
17
|
-
**
|
|
17
|
+
**AI IDE** 是专为 Spec 驱动开发设计的 AI 驱动 IDE。sce (Scene Capability Engine) 是 SCE 的核心组件。
|
|
18
18
|
|
|
19
|
-
**
|
|
19
|
+
**sce 与 SCE 的集成**是**完全原生的** - 无需设置、无需手动导出、无需配置。一切都开箱即用!
|
|
20
20
|
|
|
21
|
-
### 为什么在
|
|
21
|
+
### 为什么在 SCE 中使用 sce?
|
|
22
22
|
|
|
23
23
|
- ✅ **零配置** - 开箱即用
|
|
24
|
-
- ✅ **原生集成** -
|
|
25
|
-
- ✅ **自动上下文** -
|
|
24
|
+
- ✅ **原生集成** - sce 是 SCE 的一部分
|
|
25
|
+
- ✅ **自动上下文** - SCE 始终知道你的 Spec
|
|
26
26
|
- ✅ **可视化工具** - Spec 浏览器、任务跟踪器等
|
|
27
27
|
- ✅ **最佳体验** - 专为 Spec 驱动开发设计
|
|
28
28
|
|
|
@@ -33,10 +33,10 @@
|
|
|
33
33
|
**模式:** 原生集成
|
|
34
34
|
|
|
35
35
|
**工作原理:**
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
36
|
+
1. SCE 自动检测 `.kiro/` 目录
|
|
37
|
+
2. SCE 的 AI 始终可以访问你的 Spec
|
|
38
38
|
3. 无需手动导出或粘贴
|
|
39
|
-
4.
|
|
39
|
+
4. SCE 自动更新任务状态
|
|
40
40
|
5. 可视化工具显示进度
|
|
41
41
|
|
|
42
42
|
---
|
|
@@ -45,13 +45,13 @@
|
|
|
45
45
|
|
|
46
46
|
### 无需设置!
|
|
47
47
|
|
|
48
|
-
如果你使用
|
|
48
|
+
如果你使用 AI IDE,sce 已经集成。只需:
|
|
49
49
|
|
|
50
|
-
1. **打开你的项目** 在
|
|
51
|
-
2. **运行 `
|
|
50
|
+
1. **打开你的项目** 在 SCE 中
|
|
51
|
+
2. **运行 `sce adopt`**(如果尚未采用)
|
|
52
52
|
3. **开始创建 Spec!**
|
|
53
53
|
|
|
54
|
-
就是这样!
|
|
54
|
+
就是这样!SCE 会处理其余的事情。
|
|
55
55
|
|
|
56
56
|
---
|
|
57
57
|
|
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
|
|
60
60
|
### 方法 1:使用 Spec 浏览器(推荐)
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
SCE 提供了一个可视化的 Spec 浏览器。
|
|
63
63
|
|
|
64
64
|
**步骤:**
|
|
65
65
|
|
|
@@ -74,7 +74,7 @@ Kiro 提供了一个可视化的 Spec 浏览器。
|
|
|
74
74
|
|
|
75
75
|
3. **实现任务**
|
|
76
76
|
- 点击任务旁边的"实现"按钮
|
|
77
|
-
-
|
|
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. **
|
|
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
|
-
|
|
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. **
|
|
118
|
+
4. **SCE 自动实现任务**
|
|
119
119
|
|
|
120
120
|
---
|
|
121
121
|
|
|
122
|
-
##
|
|
122
|
+
## SCE 独有功能
|
|
123
123
|
|
|
124
124
|
### 1. Spec 浏览器
|
|
125
125
|
|
|
@@ -139,7 +139,7 @@ Kiro 提供了一个可视化的 Spec 浏览器。
|
|
|
139
139
|
|
|
140
140
|
### 3. 需求验证
|
|
141
141
|
|
|
142
|
-
|
|
142
|
+
SCE 验证你的 Spec:
|
|
143
143
|
- 检查需求完整性
|
|
144
144
|
- 验证设计追溯
|
|
145
145
|
- 建议改进
|
|
@@ -155,7 +155,7 @@ Kiro 验证你的 Spec:
|
|
|
155
155
|
|
|
156
156
|
### 5. 自动上下文管理
|
|
157
157
|
|
|
158
|
-
|
|
158
|
+
SCE 自动管理上下文:
|
|
159
159
|
- 无需手动导出
|
|
160
160
|
- 始终最新
|
|
161
161
|
- 智能上下文选择
|
|
@@ -168,16 +168,16 @@ Kiro 自动管理上下文:
|
|
|
168
168
|
### 完整功能实现工作流
|
|
169
169
|
|
|
170
170
|
```
|
|
171
|
-
1. 在
|
|
172
|
-
- 命令面板 → "
|
|
171
|
+
1. 在 SCE 中创建 Spec
|
|
172
|
+
- 命令面板 → "sce: Create Spec"
|
|
173
173
|
- 输入名称:01-00-user-login
|
|
174
174
|
|
|
175
175
|
2. 编写 Spec
|
|
176
|
-
-
|
|
176
|
+
- SCE 打开 requirements.md
|
|
177
177
|
- 编写需求
|
|
178
|
-
-
|
|
178
|
+
- SCE 打开 design.md
|
|
179
179
|
- 编写设计
|
|
180
|
-
-
|
|
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
|
-
-
|
|
189
|
+
- SCE 的 AI 生成代码
|
|
190
190
|
- 审查并接受
|
|
191
191
|
- 任务自动标记为完成
|
|
192
192
|
|
|
@@ -205,14 +205,14 @@ Kiro 自动管理上下文:
|
|
|
205
205
|
|
|
206
206
|
### 1. 使用 Spec 浏览器
|
|
207
207
|
|
|
208
|
-
Spec 浏览器是在
|
|
208
|
+
Spec 浏览器是在 SCE 中使用 sce 的最佳方式:
|
|
209
209
|
- 可视化进度
|
|
210
210
|
- 快速访问 Spec
|
|
211
211
|
- 一键任务实现
|
|
212
212
|
|
|
213
|
-
### 2. 让
|
|
213
|
+
### 2. 让 SCE 管理任务状态
|
|
214
214
|
|
|
215
|
-
不要手动编辑 tasks.md 中的复选框。让
|
|
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
|
-
- 命令面板 → "
|
|
223
|
+
- 命令面板 → "sce: Validate Spec"
|
|
224
224
|
- 修复任何问题
|
|
225
225
|
- 然后开始实现
|
|
226
226
|
|
|
227
227
|
### 4. 利用设计可视化
|
|
228
228
|
|
|
229
229
|
使用 Mermaid 图进行设计:
|
|
230
|
-
-
|
|
230
|
+
- SCE 渲染它们
|
|
231
231
|
- 交互式视图
|
|
232
232
|
- 更容易理解架构
|
|
233
233
|
|
|
234
|
-
### 5. 使用
|
|
234
|
+
### 5. 使用 SCE 的 AI 聊天
|
|
235
235
|
|
|
236
|
-
|
|
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
|
-
###
|
|
268
|
+
### SCE vs Cursor
|
|
269
269
|
|
|
270
|
-
| 功能 |
|
|
270
|
+
| 功能 | SCE | Cursor |
|
|
271
271
|
|------|------|--------|
|
|
272
|
-
|
|
|
272
|
+
| sce 集成 | 原生 | 手动导出 |
|
|
273
273
|
| Spec 浏览器 | ✅ | ❌ |
|
|
274
274
|
| 任务跟踪器 | ✅ | ❌ |
|
|
275
275
|
| 自动上下文 | ✅ | ❌ |
|
|
276
276
|
| 设置时间 | 0 分钟 | 5 分钟 |
|
|
277
277
|
|
|
278
|
-
###
|
|
278
|
+
### SCE vs Windsurf
|
|
279
279
|
|
|
280
|
-
| 功能 |
|
|
280
|
+
| 功能 | SCE | Windsurf |
|
|
281
281
|
|------|------|----------|
|
|
282
|
-
|
|
|
282
|
+
| sce 集成 | 原生 | 命令执行 |
|
|
283
283
|
| Spec 浏览器 | ✅ | ❌ |
|
|
284
284
|
| 可视化工具 | ✅ | ❌ |
|
|
285
285
|
| Watch 模式 | 内置 | 需要设置 |
|
|
286
286
|
|
|
287
|
-
###
|
|
287
|
+
### SCE vs Claude
|
|
288
288
|
|
|
289
|
-
| 功能 |
|
|
289
|
+
| 功能 | SCE | Claude |
|
|
290
290
|
|------|------|--------|
|
|
291
|
-
|
|
|
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. 确保你已运行 `
|
|
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. 这不应该发生在
|
|
311
|
-
2. 如果发生,重启
|
|
310
|
+
1. 这不应该发生在 SCE 中!
|
|
311
|
+
2. 如果发生,重启 SCE
|
|
312
312
|
3. 验证 Spec 文件格式正确
|
|
313
313
|
|
|
314
314
|
### 问题:任务状态未更新
|
|
315
315
|
|
|
316
316
|
**解决方案:**
|
|
317
|
-
1. 让
|
|
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) - 开始使用
|
|
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 中使用
|
|
1
|
+
# 在 VS Code + Copilot 中使用 sce
|
|
2
2
|
|
|
3
|
-
> 将
|
|
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
|
-
**
|
|
19
|
+
**sce 与 VS Code + Copilot 的集成**使用**手动导出**和**内联注释**,让 Copilot 理解你的 Spec 并生成匹配你设计的代码。
|
|
20
20
|
|
|
21
|
-
### 为什么在 VS Code + Copilot 中使用
|
|
21
|
+
### 为什么在 VS Code + Copilot 中使用 sce?
|
|
22
22
|
|
|
23
23
|
- ✅ **熟悉的环境** - 使用你已知的编辑器
|
|
24
24
|
- ✅ **智能补全** - Copilot 遵循你的 Spec
|
|
25
25
|
- ✅ **内联建议** - 在你输入时获得上下文感知的代码
|
|
26
|
-
- ✅ **灵活集成** - 多种使用
|
|
26
|
+
- ✅ **灵活集成** - 多种使用 sce 的方式
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
**模式:** 手动导出 + 内联注释
|
|
33
33
|
|
|
34
34
|
**工作原理:**
|
|
35
|
-
1. 你在
|
|
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
|
-
- 已全局安装 **
|
|
50
|
-
- 项目已被
|
|
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/
|
|
83
|
+
创建 `.vscode/sce.code-snippets`:
|
|
84
84
|
|
|
85
85
|
```json
|
|
86
86
|
{
|
|
87
|
-
"
|
|
88
|
-
"prefix": "
|
|
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
|
|
96
|
+
"description": "Add sce Spec reference comment"
|
|
97
97
|
},
|
|
98
|
-
"
|
|
99
|
-
"prefix": "
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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 引用(使用
|
|
225
|
-
|
|
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) - 开始使用
|
|
431
|
+
- 📖 [快速入门指南](../quick-start.md) - 开始使用 sce
|
|
432
432
|
- 🔌 [集成模式](../integration-modes.md) - 理解手动导出模式
|
|
433
433
|
- 📋 [Spec 工作流](../spec-workflow.md) - 创建有效的 Spec
|
|
434
434
|
- 🔧 [故障排除](../troubleshooting.md) - 常见问题
|