scene-capability-engine 3.0.0 → 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 +234 -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 +5 -6
- 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
package/LICENSE
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
MIT License
|
|
2
2
|
|
|
3
|
-
Copyright (c) 2026
|
|
3
|
+
Copyright (c) 2026 heguangyong
|
|
4
4
|
|
|
5
5
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
6
|
of this software and associated documentation files (the "Software"), to deal
|
|
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
18
18
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
19
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
20
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -4,8 +4,7 @@
|
|
|
4
4
|
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
6
|
> **⚠️ Important Clarification**: `scene-capability-engine` (`sce`) is an **npm package and CLI tool** for spec-driven development.
|
|
7
|
-
>
|
|
8
|
-
> Legacy/compatibility commands `sco`, `kse`, and `kiro-spec-engine` remain available.
|
|
7
|
+
> Primary command is `sce`. Compatibility aliases are preserved for migration.
|
|
9
8
|
|
|
10
9
|
**A context provider for AI coding tools** - Structure your project requirements, design, and tasks so AI assistants can help you build better software.
|
|
11
10
|
|
|
@@ -61,7 +60,7 @@ graph LR
|
|
|
61
60
|
| Queue-driven autonomous runtime | `auto close-loop-controller` persistent queue drain | Program-scale backlogs continue without manual re-triggering |
|
|
62
61
|
| Autonomous convergence governance | Program gate (`min-success-rate` + `max-risk-level`) + audit JSON output | Program completion is policy-verified and traceable |
|
|
63
62
|
| Measurable outcomes | KPI automation (`value metrics snapshot/baseline/trend`) | Delivery quality can be tracked week-over-week |
|
|
64
|
-
| Tool-agnostic adoption | Works across Claude/Cursor/Windsurf/Copilot
|
|
63
|
+
| Tool-agnostic adoption | Works across Claude/Cursor/Windsurf/Copilot | No lock-in to a single AI IDE |
|
|
65
64
|
| Built-in governance | Docs governance, lock management, audit, env/workspace controls | Team collaboration stays auditable and stable |
|
|
66
65
|
|
|
67
66
|
### 90-Second Value Proof
|
|
@@ -134,7 +133,7 @@ This creates a `.kiro/` directory with:
|
|
|
134
133
|
|
|
135
134
|
#### Step 3: Tell Your AI About the Methodology (30 seconds)
|
|
136
135
|
|
|
137
|
-
**In your AI tool (Cursor, Claude, Windsurf,
|
|
136
|
+
**In your AI tool (Cursor, Claude, Windsurf, etc.), say:**
|
|
138
137
|
|
|
139
138
|
```
|
|
140
139
|
Please read .kiro/README.md to understand how this project works.
|
|
@@ -201,7 +200,7 @@ A **Spec** is a structured description of a feature or project component. Each S
|
|
|
201
200
|
|
|
202
201
|
sce supports three ways to work with AI tools:
|
|
203
202
|
|
|
204
|
-
1. **
|
|
203
|
+
1. **Direct Workspace Integration** - AI tool directly accesses sce in your workspace
|
|
205
204
|
2. **Manual Export** - You export and paste context (Claude, ChatGPT, Cursor)
|
|
206
205
|
3. **Watch Mode** - Automatic context updates on file changes (all tools)
|
|
207
206
|
|
|
@@ -218,7 +217,6 @@ sce works with any AI coding assistant. Choose your tool for specific guidance:
|
|
|
218
217
|
- **[Cursor](docs/tools/cursor-guide.md)** - IDE with AI pair programming
|
|
219
218
|
- **[Claude Code](docs/tools/claude-guide.md)** - Anthropic's coding assistant
|
|
220
219
|
- **[Windsurf](docs/tools/windsurf-guide.md)** - AI agent with command execution
|
|
221
|
-
- **[Kiro](docs/tools/kiro-guide.md)** - Native integration, no manual export needed
|
|
222
220
|
- **[VS Code + Copilot](docs/tools/vscode-guide.md)** - GitHub Copilot integration
|
|
223
221
|
- **[Generic AI Tools](docs/tools/generic-guide.md)** - Works with any AI assistant
|
|
224
222
|
|
|
@@ -264,7 +262,6 @@ sequenceDiagram
|
|
|
264
262
|
- [Cursor Integration](docs/tools/cursor-guide.md)
|
|
265
263
|
- [Claude Code Integration](docs/tools/claude-guide.md)
|
|
266
264
|
- [Windsurf Integration](docs/tools/windsurf-guide.md)
|
|
267
|
-
- [Kiro Integration](docs/tools/kiro-guide.md)
|
|
268
265
|
- [VS Code + Copilot Integration](docs/tools/vscode-guide.md)
|
|
269
266
|
- [Generic AI Tools](docs/tools/generic-guide.md)
|
|
270
267
|
|
|
@@ -364,7 +361,7 @@ Structure your work with Requirements → Design → Tasks workflow
|
|
|
364
361
|
- **Smart Exclusions**: Automatically skip common non-repository directories (node_modules, build, etc.)
|
|
365
362
|
|
|
366
363
|
### Moqui ERP Integration 🚀 NEW in v1.39.0
|
|
367
|
-
- **Moqui ERP Adapter**: Connect
|
|
364
|
+
- **Moqui ERP Adapter**: Connect sce scene runtime to live Moqui ERP instances
|
|
368
365
|
- `MoquiClient` — HTTP client with JWT auth lifecycle (login, refresh, re-login, logout) and retry logic
|
|
369
366
|
- `MoquiAdapter` — Binding handler for `spec.erp.*` and `moqui.*` refs, entity CRUD, service invocation, screen discovery
|
|
370
367
|
- **Scene Template Extractor** (v1.40.0): Analyze Moqui resources, identify business patterns, generate reusable scene templates
|
|
@@ -601,7 +598,7 @@ sce repo exec "<command>" # Execute command in all repositories
|
|
|
601
598
|
# Spec-level collaboration (NEW in v1.22.0)
|
|
602
599
|
sce collab init <master> [options] # Initialize Master Spec with Sub-Specs
|
|
603
600
|
sce collab status [spec] [--graph] # Display collaboration status
|
|
604
|
-
sce collab assign <spec> <
|
|
601
|
+
sce collab assign <spec> <assignee> # Assign Spec to an assignee
|
|
605
602
|
sce collab verify <spec> # Verify interface contracts
|
|
606
603
|
sce collab integrate <specs...> # Run integration tests
|
|
607
604
|
sce collab migrate <spec> # Convert standalone Spec to collaborative
|
|
@@ -697,7 +694,7 @@ We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for:
|
|
|
697
694
|
|
|
698
695
|
```bash
|
|
699
696
|
git clone https://github.com/heguangyong/scene-capability-engine.git
|
|
700
|
-
cd
|
|
697
|
+
cd scene-capability-engine
|
|
701
698
|
npm install
|
|
702
699
|
npm link # For local development
|
|
703
700
|
npm test # Run tests
|
|
@@ -714,7 +711,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
|
|
|
714
711
|
## Acknowledgments
|
|
715
712
|
|
|
716
713
|
- Inspired by the **Sisyphus** myth and the concept of noble struggle
|
|
717
|
-
- Built on
|
|
714
|
+
- Built on practical **Spec-driven development** methodology
|
|
718
715
|
- Influenced by **oh-my-opencode** and the Ultrawork Manifesto
|
|
719
716
|
|
|
720
717
|
---
|
package/README.zh.md
CHANGED
|
@@ -4,8 +4,7 @@
|
|
|
4
4
|
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
6
|
> **⚠️ 重要说明**: `scene-capability-engine`(`sce`)是一个 **npm 包和 CLI 工具**,用于 Spec 驱动开发。
|
|
7
|
-
>
|
|
8
|
-
> 兼容保留命令:`sco`、`kse` 与 `kiro-spec-engine`。
|
|
7
|
+
> 主命令为 `sce`,兼容别名保留用于迁移。
|
|
9
8
|
|
|
10
9
|
**AI 编码工具的上下文提供者** - 结构化你的项目需求、设计和任务,让 AI 助手帮你构建更好的软件。
|
|
11
10
|
|
|
@@ -59,7 +58,7 @@ graph LR
|
|
|
59
58
|
| 队列驱动自治执行 | `auto close-loop-controller` 持续消费目标队列 | 程序级积压目标无需人工反复触发 |
|
|
60
59
|
| 自治收敛治理 | Program Gate(最小成功率 + 最大风险)+ 审计 JSON 导出 | 完成结果可按策略验收且全程可追溯 |
|
|
61
60
|
| 结果可量化 | KPI 自动化(`value metrics snapshot/baseline/trend`) | 周度趋势可追踪、可审计 |
|
|
62
|
-
| 工具无锁定 | 兼容 Claude/Cursor/Windsurf/Copilot
|
|
61
|
+
| 工具无锁定 | 兼容 Claude/Cursor/Windsurf/Copilot | 团队可保留现有 AI 工具链 |
|
|
63
62
|
| 治理内建 | 文档治理、锁机制、审计、环境/工作区管理 | 协作更稳定,过程可回放 |
|
|
64
63
|
|
|
65
64
|
### 90 秒价值验证
|
|
@@ -132,7 +131,7 @@ sce adopt
|
|
|
132
131
|
|
|
133
132
|
#### 步骤 3:告诉 AI 项目的开发方法(30 秒)
|
|
134
133
|
|
|
135
|
-
**在你的 AI 工具中(Cursor、Claude、Windsurf
|
|
134
|
+
**在你的 AI 工具中(Cursor、Claude、Windsurf 等),说:**
|
|
136
135
|
|
|
137
136
|
```
|
|
138
137
|
请阅读 .kiro/README.md 了解项目的开发方法。
|
|
@@ -199,7 +198,7 @@ sce adopt
|
|
|
199
198
|
|
|
200
199
|
sce 支持三种与 AI 工具协作的方式:
|
|
201
200
|
|
|
202
|
-
1.
|
|
201
|
+
1. **工作区直连集成** - AI 工具直接在你的工作区访问 sce
|
|
203
202
|
2. **手动导出** - 你导出并粘贴上下文(Claude、ChatGPT、Cursor)
|
|
204
203
|
3. **Watch 模式** - 文件更改时自动更新上下文(所有工具)
|
|
205
204
|
|
|
@@ -216,7 +215,6 @@ sce 适用于任何 AI 编码助手。选择你的工具获取具体指导:
|
|
|
216
215
|
- **[Cursor](docs/zh/tools/cursor-guide.md)** - 带 AI 结对编程的 IDE
|
|
217
216
|
- **[Claude Code](docs/zh/tools/claude-guide.md)** - Anthropic 的编码助手
|
|
218
217
|
- **[Windsurf](docs/zh/tools/windsurf-guide.md)** - 支持命令执行的 AI 代理
|
|
219
|
-
- **[Kiro](docs/zh/tools/kiro-guide.md)** - 原生集成,无需手动导出
|
|
220
218
|
- **[VS Code + Copilot](docs/zh/tools/vscode-guide.md)** - GitHub Copilot 集成
|
|
221
219
|
- **[通用 AI 工具](docs/zh/tools/generic-guide.md)** - 适用于任何 AI 助手
|
|
222
220
|
|
|
@@ -260,7 +258,6 @@ sequenceDiagram
|
|
|
260
258
|
- [Cursor 集成](docs/zh/tools/cursor-guide.md)
|
|
261
259
|
- [Claude Code 集成](docs/zh/tools/claude-guide.md)
|
|
262
260
|
- [Windsurf 集成](docs/zh/tools/windsurf-guide.md)
|
|
263
|
-
- [Kiro 集成](docs/zh/tools/kiro-guide.md)
|
|
264
261
|
- [VS Code + Copilot 集成](docs/zh/tools/vscode-guide.md)
|
|
265
262
|
- [通用 AI 工具](docs/zh/tools/generic-guide.md)
|
|
266
263
|
|
|
@@ -320,7 +317,7 @@ sequenceDiagram
|
|
|
320
317
|
- **跨平台**:在 Windows、Linux 和 macOS 上无缝工作
|
|
321
318
|
|
|
322
319
|
### Moqui ERP 集成 🚀 v1.39.0 新增
|
|
323
|
-
- **Moqui ERP 适配器**: 将
|
|
320
|
+
- **Moqui ERP 适配器**: 将 sce 场景运行时连接到 Moqui ERP 实例
|
|
324
321
|
- `MoquiClient` — 支持 JWT 认证生命周期(登录、刷新、重登录、登出)和重试逻辑的 HTTP 客户端
|
|
325
322
|
- `MoquiAdapter` — 处理 `spec.erp.*` 和 `moqui.*` 引用的绑定处理器,支持实体 CRUD、服务调用、屏幕发现
|
|
326
323
|
- **场景模板提取器**(v1.40.0): 分析 Moqui 资源,识别业务模式,生成可复用场景模板
|
|
@@ -592,7 +589,7 @@ sce workflows # 列出可用工作流
|
|
|
592
589
|
|
|
593
590
|
```bash
|
|
594
591
|
git clone https://github.com/heguangyong/scene-capability-engine.git
|
|
595
|
-
cd
|
|
592
|
+
cd scene-capability-engine
|
|
596
593
|
npm install
|
|
597
594
|
npm link # 用于本地开发
|
|
598
595
|
npm test # 运行测试
|
|
@@ -609,7 +606,7 @@ MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
|
|
|
609
606
|
## 致谢
|
|
610
607
|
|
|
611
608
|
- 受 **西西弗斯** 神话和高贵奋斗概念的启发
|
|
612
|
-
-
|
|
609
|
+
- 建立在务实的 **Spec 驱动开发** 方法论基础上
|
|
613
610
|
- 受 **oh-my-opencode** 和 Ultrawork 宣言的影响
|
|
614
611
|
|
|
615
612
|
---
|
package/bin/kse.js
CHANGED
package/bin/sce.js
CHANGED
package/bin/sco.js
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# 331-poc 适配持续推进路线图(
|
|
1
|
+
# 331-poc 适配持续推进路线图(sce 侧)
|
|
2
2
|
|
|
3
|
-
> 范围:`
|
|
3
|
+
> 范围:`scene-capability-engine` 侧围绕 331-poc handoff 的持续适配工作,不包含 331 业务实现本身。
|
|
4
4
|
|
|
5
5
|
## 已完成(本轮)
|
|
6
6
|
|
|
7
7
|
1. 新增 handoff 自动化命令:
|
|
8
|
-
- `
|
|
9
|
-
- `
|
|
8
|
+
- `sce auto handoff plan`
|
|
9
|
+
- `sce auto handoff queue`
|
|
10
10
|
2. 将 handoff manifest 解析为可执行阶段计划(precheck/spec validation/execution/observability)。
|
|
11
11
|
3. 将 handoff manifest 生成 close-loop-batch 目标队列(支持 dry-run、append、known-gaps 开关)。
|
|
12
12
|
4. 补齐单测覆盖(plan/queue/dry-run 分支)。
|
|
13
13
|
5. 更新命令参考与中英文文档入口。
|
|
14
|
-
6. 新增 `
|
|
14
|
+
6. 新增 `sce auto handoff run`:
|
|
15
15
|
- 一条命令串行执行 `plan -> queue -> close-loop-batch -> observability`。
|
|
16
16
|
- 支持 `--dry-run` 与失败自动中断。
|
|
17
17
|
7. 新增 handoff 结果归档:
|
|
@@ -25,12 +25,12 @@
|
|
|
25
25
|
- 从 manifest `specs[].depends_on` 构建依赖拓扑批次。
|
|
26
26
|
- `handoff run` 默认按依赖批次顺序执行 spec 集成目标。
|
|
27
27
|
10. 新增模板差异检测:
|
|
28
|
-
- `
|
|
28
|
+
- `sce auto handoff template-diff` 对比 manifest 模板与本地模板库。
|
|
29
29
|
11. 新增跨轮次回归分析:
|
|
30
|
-
- `
|
|
30
|
+
- `sce auto handoff regression` 对比相邻批次成功率/风险/失败目标/耗时变化。
|
|
31
31
|
- `handoff run` 结果中自动附加 regression 摘要。
|
|
32
32
|
12. 新增断点续跑能力:
|
|
33
|
-
- `
|
|
33
|
+
- `sce auto handoff run --continue-from <session|latest|file>`。
|
|
34
34
|
- 支持 `--continue-strategy auto|pending|failed-only`。
|
|
35
35
|
13. 新增 release evidence 自动归并:
|
|
36
36
|
- `handoff run` 结束后自动将批次结果合并到 `.kiro/reports/release-evidence/handoff-runs.json`。
|
|
@@ -42,10 +42,10 @@
|
|
|
42
42
|
- `handoff run` 支持 `--release-evidence-window <n>`(默认 5)。
|
|
43
43
|
- release evidence 自动写入 `latest_trend_window` 与每个 session 的 `trend_window`,支持发布包一键审阅。
|
|
44
44
|
16. 新增 release evidence 快速审阅命令:
|
|
45
|
-
- `
|
|
45
|
+
- `sce auto handoff evidence` 直接聚合当前批次 gate/ontology/regression/risk-layer 概览。
|
|
46
46
|
- 支持 JSON/markdown 输出与 `--window` 会话窗口聚合。
|
|
47
47
|
17. 新增 release draft 自动生成:
|
|
48
|
-
- `
|
|
48
|
+
- `sce auto handoff evidence --release-draft <path>` 一次命令生成 evidence 审阅 markdown + release notes 草稿。
|
|
49
49
|
- 草稿自动注入当前批次 gate/ontology/regression/risk-layer 摘要与证据路径。
|
|
50
50
|
18. 新增 CI 发布链路集成:
|
|
51
51
|
- `release.yml` 在 tag 发布时自动尝试基于 `handoff-runs.json` 生成 release notes 草稿。
|
|
@@ -63,7 +63,7 @@
|
|
|
63
63
|
- 编排引擎在 429/RateLimit 错误重试时,支持解析 `Retry-After`/`try again in` 提示并抬升 backoff。
|
|
64
64
|
- 减少服务端限流窗口内的无效重试与“卡死感”。
|
|
65
65
|
23. 新增 release gate 历史索引命令:
|
|
66
|
-
- `
|
|
66
|
+
- `sce auto handoff gate-index` 聚合 `release-gate-*.json` 为跨版本历史索引。
|
|
67
67
|
- 支持与已有历史索引合并去重(按 tag/file),输出门禁通过率与风险分布聚合指标。
|
|
68
68
|
24. 发布流程自动产出门禁历史索引:
|
|
69
69
|
- `release.yml` 在 gate 评估后自动执行 `handoff gate-index`,生成 `release-gate-history.json` 与当次 summary。
|
|
@@ -75,7 +75,7 @@
|
|
|
75
75
|
- `release.yml` 在发布前将 `release-gate-history` 的近 5 版趋势追加到 Release Notes。
|
|
76
76
|
- 发布页可直接看到 gate pass ratio、风险分布与近期版本轨迹。
|
|
77
77
|
27. 新增 gate-index Markdown 趋势卡片:
|
|
78
|
-
- `
|
|
78
|
+
- `sce auto handoff gate-index --markdown-out <path>` 直接产出可读趋势卡片。
|
|
79
79
|
- 便于在 PR/Issue 中复用,降低历史门禁审阅成本。
|
|
80
80
|
28. 发布流程附带趋势卡片资产:
|
|
81
81
|
- `release.yml` 自动生成并上传 `release-gate-history-<tag>.md`。
|
|
@@ -96,34 +96,34 @@
|
|
|
96
96
|
- `release.yml` 将 drift 评估结果回写到 `release-gate-<tag>.json` 的 `drift` 字段。
|
|
97
97
|
- 单一门禁产物同时覆盖 gate 与 drift 审计口径,便于回放。
|
|
98
98
|
34. gate-index 漂移趋势聚合:
|
|
99
|
-
- `
|
|
99
|
+
- `sce auto handoff gate-index` 聚合 `drift_alert_count/drift_blocked` 指标并输出 markdown 趋势。
|
|
100
100
|
- 发布流程在 drift 合并后自动刷新一次 gate-index,确保当次 release 资产包含 drift 最新状态。
|
|
101
101
|
35. 治理默认评估接入 handoff 发布信号:
|
|
102
|
-
- `
|
|
102
|
+
- `sce auto governance stats` 默认读取 `release-gate-history.json`,将 gate/drift/scene-batch 信号纳入风险评估。
|
|
103
103
|
- 治理健康输出新增 `health.release_gate` 快照,concerns/recommendations 自动给出 release 质量回归处置建议。
|
|
104
104
|
36. 治理 close-loop 轮次遥测接入发布信号:
|
|
105
|
-
- `
|
|
105
|
+
- `sce auto governance close-loop` 每轮输出 `release_gate_before/release_gate_after`,与 `risk_before/risk_after` 对齐。
|
|
106
106
|
- 轮次级审计可直接追踪 release gate/drift/scene-batch 信号在治理动作前后的变化。
|
|
107
107
|
37. 治理会话统计聚合 release gate 轮次趋势:
|
|
108
|
-
- `
|
|
108
|
+
- `sce auto governance session stats` 新增 `release_gate` 聚合区块,覆盖 gate fail/drift alert/blocked 与通过率均值。
|
|
109
109
|
- 会话统计输出同时汇总 `round_telemetry_observed/changed`,可量化治理轮次对发布质量信号的影响。
|
|
110
110
|
38. 治理 close-loop 接入 release gate 阻断语义:
|
|
111
|
-
- `
|
|
111
|
+
- `sce auto governance close-loop` 在 release gate/drift 信号异常时输出 `stop_reason=release-gate-blocked`。
|
|
112
112
|
- 结果新增 `stop_detail` 与 `recommendations`,显式给出阻断原因与处置命令。
|
|
113
113
|
39. 治理 maintain 计划默认优先 release gate 修复:
|
|
114
|
-
- `
|
|
114
|
+
- `sce auto governance maintain` 在 release gate 阻断时优先产出 `release-gate-evidence-review` / `release-gate-scene-batch-remediate`。
|
|
115
115
|
- 发布质量阻断先处理,再执行常规会话/内存清理动作。
|
|
116
116
|
40. handoff run 接入 release gate preflight 与失败摘要:
|
|
117
|
-
- `
|
|
117
|
+
- `sce auto handoff run` 默认输出 `release_gate_preflight`,在 precheck 阶段给出 release gate 阻断提示。
|
|
118
118
|
- 失败结果新增 `failure_summary`,统一汇总 phase/gate/release-gate 阻断原因并联动推荐命令。
|
|
119
119
|
41. handoff run 增加 release gate 可选硬门禁:
|
|
120
120
|
- 新增 `--require-release-gate-preflight`,可在生产场景将 release gate preflight 从 advisory 升级为 hard-fail。
|
|
121
121
|
- 默认保持 advisory,避免对现有项目引入破坏性变更。
|
|
122
122
|
42. release draft/evidence review 纳入 preflight 与失败摘要信号:
|
|
123
|
-
- `
|
|
123
|
+
- `sce auto handoff evidence --format markdown` 新增 `Current Release Gate Preflight` 与 `Current Failure Summary`。
|
|
124
124
|
- release notes draft 摘要新增 preflight 可用性、阻断状态、hard-gate 模式与失败高亮。
|
|
125
125
|
43. gate-index 趋势卡片纳入 preflight/hard-gate 聚合:
|
|
126
|
-
- `
|
|
126
|
+
- `sce auto handoff gate-index` 聚合 `release_gate_preflight_*` 指标并在 markdown 趋势卡片展示。
|
|
127
127
|
- Recent entries 行新增 `preflight-blocked` / `hard-gate` 维度,便于跨版本定位阻断模式。
|
|
128
128
|
44. release workflow 漂移判定纳入 preflight/hard-gate 趋势:
|
|
129
129
|
- `release.yml` 的 drift alert 增加 preflight blocked rate、hard-gate blocked streak、preflight unavailable streak 三类阈值。
|
|
@@ -142,12 +142,12 @@
|
|
|
142
142
|
- `release.yml` 的 Evaluate drift 步骤改为直接调用脚本,消除大段内联 heredoc,降低语法错误与维护成本。
|
|
143
143
|
- 新增 `tests/unit/scripts/release-drift-evaluate.test.js` 覆盖 advisory/enforce/missing history/gate report 写回四类场景。
|
|
144
144
|
2. handoff 质量指标接入 governance 默认评估闭环:
|
|
145
|
-
- `
|
|
145
|
+
- `sce auto governance stats` 默认聚合 `.kiro/reports/release-evidence/handoff-runs.json`,输出 `health.handoff_quality` 快照。
|
|
146
146
|
- `risk/concerns/recommendations` 自动纳入 handoff 最新状态、gate、ontology、capability、preflight 阻断等信号。
|
|
147
|
-
- `
|
|
148
|
-
- `
|
|
147
|
+
- `sce auto governance close-loop` 的阻断判断纳入 handoff 严重质量信号,统一通过 `stop_reason=release-gate-blocked` 回传处置语义。
|
|
148
|
+
- `sce auto governance maintain` 在 handoff 质量阻断时新增 `release-gate-handoff-remediate` 建议动作。
|
|
149
149
|
3. release evidence 与治理视图合并:
|
|
150
|
-
- `
|
|
150
|
+
- `sce auto handoff evidence` 报告新增 `governance_snapshot`(risk/concerns/recommendations + release/handoff health)。
|
|
151
151
|
- evidence markdown 与 release draft 同步输出 `Governance Snapshot` 区块,形成可发布的一体化治理审阅材料。
|
|
152
152
|
|
|
153
153
|
## 下一阶段(新)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
|
|
1
|
+
# 331-poc 双轨协同对接手册
|
|
2
2
|
|
|
3
|
-
> 目的:在 `
|
|
3
|
+
> 目的:在 `scene-capability-engine` 侧承接 331-poc 的深度补全成果,完成模板接入、ontology 校验、主从编排与闭环验收。
|
|
4
4
|
|
|
5
5
|
## 1. 输入契约(来自 331-poc)
|
|
6
6
|
|
|
@@ -10,22 +10,22 @@
|
|
|
10
10
|
2. 模板导出目录:`.kiro/templates/exports/<template-name>/`。
|
|
11
11
|
3. 交接包:`docs/handoffs/handoff-manifest.json` + 证据文档。
|
|
12
12
|
|
|
13
|
-
若输入不满足以上三类,
|
|
13
|
+
若输入不满足以上三类,sce 侧不进入接入批次。
|
|
14
14
|
|
|
15
|
-
## 2.
|
|
15
|
+
## 2. sce 侧接入流程
|
|
16
16
|
|
|
17
17
|
## 2.0 一键化入口(推荐)
|
|
18
18
|
|
|
19
19
|
推荐直接使用一条命令闭环执行:
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
npx
|
|
22
|
+
npx sce auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
需要提高成功率门槛时:
|
|
26
26
|
|
|
27
27
|
```bash
|
|
28
|
-
npx
|
|
28
|
+
npx sce auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json \
|
|
29
29
|
--min-spec-success-rate 95 \
|
|
30
30
|
--max-risk-level medium \
|
|
31
31
|
--json
|
|
@@ -34,15 +34,15 @@ npx kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.js
|
|
|
34
34
|
建议每轮执行后追加两条诊断命令:
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
|
-
npx
|
|
38
|
-
npx
|
|
37
|
+
npx sce auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
|
|
38
|
+
npx sce auto handoff regression --session-id latest --json
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
## 2.1 批次 1:输入预检
|
|
42
42
|
|
|
43
43
|
```bash
|
|
44
|
-
npx
|
|
45
|
-
npx
|
|
44
|
+
npx sce status --verbose
|
|
45
|
+
npx sce doctor --docs
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
核对 `handoff-manifest.json`:
|
|
@@ -55,10 +55,10 @@ npx kse doctor --docs
|
|
|
55
55
|
对每个 handoff spec 执行:
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
|
-
npx
|
|
59
|
-
npx
|
|
60
|
-
npx
|
|
61
|
-
npx
|
|
58
|
+
npx sce scene package-validate --spec <spec-name> --spec-package custom/scene-package.json --strict --json
|
|
59
|
+
npx sce scene ontology validate --package .kiro/specs/<spec-name>/custom --json
|
|
60
|
+
npx sce scene ontology impact --package .kiro/specs/<spec-name>/custom --ref <ref> --max-depth 2 --json
|
|
61
|
+
npx sce scene ontology path --package .kiro/specs/<spec-name>/custom --from <from-ref> --to <to-ref> --json
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
## 2.3 批次 3:模板层接入
|
|
@@ -66,10 +66,10 @@ npx kse scene ontology path --package .kiro/specs/<spec-name>/custom --from <fro
|
|
|
66
66
|
对于 scene package 模板链路(如果本轮包含 scene-package 模板):
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
|
-
npx
|
|
70
|
-
npx
|
|
71
|
-
npx
|
|
72
|
-
npx
|
|
69
|
+
npx sce scene package-publish --spec <spec-name> --out-dir .kiro/templates/scene-packages --json --force
|
|
70
|
+
npx sce scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
|
|
71
|
+
npx sce scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
|
|
72
|
+
npx sce scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
说明:Spec 模板(`templates create-from-spec` 导出)与 scene package 模板是两条链路,可并行维护,但推荐在同一交接批次一并校验。
|
|
@@ -79,9 +79,9 @@ npx kse scene package-gate --registry .kiro/templates/scene-packages/registry.js
|
|
|
79
79
|
基于本轮 spec 组合,执行自动闭环 dry-run/正式 run:
|
|
80
80
|
|
|
81
81
|
```bash
|
|
82
|
-
npx
|
|
83
|
-
npx
|
|
84
|
-
npx
|
|
82
|
+
npx sce auto close-loop --specs "<spec-a>,<spec-b>,<spec-c>" --dry-run --json
|
|
83
|
+
npx sce auto close-loop --specs "<spec-a>,<spec-b>,<spec-c>" --json
|
|
84
|
+
npx sce auto observability snapshot --json
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
判定标准:
|
|
@@ -89,7 +89,7 @@ npx kse auto observability snapshot --json
|
|
|
89
89
|
2. 不出现高风险未处置项。
|
|
90
90
|
3. observability 快照可追踪到本轮变更。
|
|
91
91
|
|
|
92
|
-
## 3.
|
|
92
|
+
## 3. sce 侧当前需持续适配的点
|
|
93
93
|
|
|
94
94
|
1. 对接自动化:把 331 handoff manifest 解析为可执行批次计划。
|
|
95
95
|
2. ontology 深化:将“业务规则/决策逻辑”映射为可量化 gate 指标。
|
|
@@ -99,22 +99,22 @@ npx kse auto observability snapshot --json
|
|
|
99
99
|
## 4. 角色划分
|
|
100
100
|
|
|
101
101
|
1. 331-poc Agent:交付业务事实、完成态 Spec、模板和证据。
|
|
102
|
-
2.
|
|
102
|
+
2. sce Agent:执行接入验证、治理门禁、主从闭环与发布收口。
|
|
103
103
|
3. Master Agent:维护跨仓上下文与批次节奏。
|
|
104
104
|
|
|
105
105
|
## 5. 失败处理
|
|
106
106
|
|
|
107
|
-
1. 输入缺失:退回 331-poc,标注缺失项,不进入
|
|
107
|
+
1. 输入缺失:退回 331-poc,标注缺失项,不进入 sce 接入。
|
|
108
108
|
2. ontology 校验失败:先修 ref/lineage,再跑 gate。
|
|
109
109
|
3. 主从编排失败:降并发、缩批次、保留快照后重试。
|
|
110
110
|
|
|
111
111
|
## 6. 最终交付口径
|
|
112
112
|
|
|
113
|
-
每个接入批次结束后,
|
|
113
|
+
每个接入批次结束后,sce 侧必须输出:
|
|
114
114
|
1. 接入批次执行记录(命令、结果、失败点)。
|
|
115
115
|
2. gate 与 observability 快照。
|
|
116
116
|
3. 下一批次建议(可直接执行)。
|
|
117
117
|
|
|
118
118
|
## 7. 持续推进参考
|
|
119
119
|
|
|
120
|
-
|
|
120
|
+
sce 侧后续增强计划见:`docs/331-poc-adaptation-roadmap.md`
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
# 331-poc Weekly Delivery Checklist (For sce Integration)
|
|
2
2
|
|
|
3
3
|
Use this checklist before each integration batch.
|
|
4
4
|
|
|
@@ -24,24 +24,24 @@ Use this checklist before each integration batch.
|
|
|
24
24
|
- Dependency relations (`depends_on`) are present for multi-spec batches.
|
|
25
25
|
- High-risk gaps have mitigation notes.
|
|
26
26
|
|
|
27
|
-
##
|
|
27
|
+
## sce Acceptance Commands
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
npx
|
|
30
|
+
npx sce auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json \\
|
|
31
31
|
--min-spec-success-rate 95 \\
|
|
32
32
|
--max-risk-level medium \\
|
|
33
33
|
--json
|
|
34
34
|
|
|
35
|
-
npx
|
|
36
|
-
npx
|
|
35
|
+
npx sce auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
|
|
36
|
+
npx sce auto handoff regression --session-id latest --json
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
## Scene Package Gate Commands
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
npx
|
|
43
|
-
npx
|
|
44
|
-
npx
|
|
42
|
+
npx sce scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
|
|
43
|
+
npx sce scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
|
|
44
|
+
npx sce scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
|
|
45
45
|
```
|
|
46
46
|
|
|
47
47
|
## Batch Exit Criteria
|
package/docs/OFFLINE_INSTALL.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# sce 离线安装指南
|
|
2
2
|
|
|
3
3
|
> 适用于无法直接访问 npm registry 的环境。
|
|
4
4
|
|
|
@@ -25,18 +25,18 @@ npm --version
|
|
|
25
25
|
|
|
26
26
|
## 方式 1:使用 `.tgz` 离线包安装(推荐)
|
|
27
27
|
|
|
28
|
-
1. 获取离线包文件(示例:`
|
|
28
|
+
1. 获取离线包文件(示例:`scene-capability-engine-1.46.2.tgz`)。
|
|
29
29
|
2. 在目标机器执行:
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
npm install -g
|
|
32
|
+
npm install -g scene-capability-engine-1.46.2.tgz
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
3. 验证:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
|
|
39
|
-
|
|
38
|
+
sce --version
|
|
39
|
+
sce --help
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
---
|
|
@@ -54,7 +54,7 @@ npm install -g .
|
|
|
54
54
|
3. 验证:
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
-
|
|
57
|
+
sce --version
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
---
|
|
@@ -78,10 +78,10 @@ npm --version
|
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
80
|
cd your-project
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
81
|
+
sce adopt
|
|
82
|
+
sce spec bootstrap --name 01-00-demo-feature --non-interactive
|
|
83
|
+
sce value metrics sample --out ./kpi-input.json --json
|
|
84
|
+
sce value metrics snapshot --input ./kpi-input.json --json
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
如果最后一步成功,说明你的环境已经可以输出机器可读 KPI 结果(用于周度评审和门禁证据)。
|