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
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Agent Hooks Analysis for
|
|
1
|
+
# Agent Hooks Analysis for scene-capability-engine
|
|
2
2
|
|
|
3
3
|
**Status**: Initial Analysis
|
|
4
4
|
**Date**: 2026-01-23
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
## Executive Summary
|
|
10
10
|
|
|
11
|
-
This document analyzes the potential integration of
|
|
11
|
+
This document analyzes the potential integration of AI IDE's agent hooks feature into scene-capability-engine (sce). Based on available information about agent hooks functionality, we identify potential use cases, evaluate benefits and trade-offs, and provide recommendations for integration.
|
|
12
12
|
|
|
13
13
|
**Recommendation**: ✅ **Integrate agent hooks** - High value for automation and user experience
|
|
14
14
|
|
|
@@ -18,7 +18,7 @@ This document analyzes the potential integration of Kiro IDE's agent hooks featu
|
|
|
18
18
|
|
|
19
19
|
### Overview
|
|
20
20
|
|
|
21
|
-
Agent hooks are automation triggers in
|
|
21
|
+
Agent hooks are automation triggers in AI IDE that allow automatic agent actions based on IDE events. They enable:
|
|
22
22
|
|
|
23
23
|
- **Event-Driven Automation**: Trigger AI actions on file changes, prompts, or other events
|
|
24
24
|
- **Workflow Automation**: Automate repetitive tasks in development workflow
|
|
@@ -26,7 +26,7 @@ Agent hooks are automation triggers in Kiro IDE that allow automatic agent actio
|
|
|
26
26
|
|
|
27
27
|
### Hook Types
|
|
28
28
|
|
|
29
|
-
Based on
|
|
29
|
+
Based on AI IDE documentation, agent hooks support various event types:
|
|
30
30
|
|
|
31
31
|
1. **fileEdited**: Triggered when a file is saved
|
|
32
32
|
2. **fileCreated**: Triggered when a new file is created
|
|
@@ -44,7 +44,7 @@ Hooks can perform two types of actions:
|
|
|
44
44
|
|
|
45
45
|
---
|
|
46
46
|
|
|
47
|
-
## Use Cases for
|
|
47
|
+
## Use Cases for sce
|
|
48
48
|
|
|
49
49
|
### High-Priority Use Cases
|
|
50
50
|
|
|
@@ -68,7 +68,7 @@ Hooks can perform two types of actions:
|
|
|
68
68
|
},
|
|
69
69
|
"then": {
|
|
70
70
|
"type": "askAgent",
|
|
71
|
-
"prompt": "Task file was updated. Run '
|
|
71
|
+
"prompt": "Task file was updated. Run 'sce workspace sync' to synchronize changes with the team."
|
|
72
72
|
}
|
|
73
73
|
}
|
|
74
74
|
```
|
|
@@ -92,7 +92,7 @@ Hooks can perform two types of actions:
|
|
|
92
92
|
},
|
|
93
93
|
"then": {
|
|
94
94
|
"type": "runCommand",
|
|
95
|
-
"command": "
|
|
95
|
+
"command": "sce context export $(sce current-spec)"
|
|
96
96
|
}
|
|
97
97
|
}
|
|
98
98
|
```
|
|
@@ -116,7 +116,7 @@ Hooks can perform two types of actions:
|
|
|
116
116
|
},
|
|
117
117
|
"then": {
|
|
118
118
|
"type": "runCommand",
|
|
119
|
-
"command": "
|
|
119
|
+
"command": "sce doctor && sce status"
|
|
120
120
|
}
|
|
121
121
|
}
|
|
122
122
|
```
|
|
@@ -141,7 +141,7 @@ Hooks can perform two types of actions:
|
|
|
141
141
|
},
|
|
142
142
|
"then": {
|
|
143
143
|
"type": "askAgent",
|
|
144
|
-
"prompt": "Spec file was updated. Consider regenerating prompts with '
|
|
144
|
+
"prompt": "Spec file was updated. Consider regenerating prompts with 'sce prompt generate' for affected tasks."
|
|
145
145
|
}
|
|
146
146
|
}
|
|
147
147
|
```
|
|
@@ -264,7 +264,7 @@ Hooks can perform two types of actions:
|
|
|
264
264
|
|
|
265
265
|
### Disadvantages
|
|
266
266
|
|
|
267
|
-
1. **
|
|
267
|
+
1. **AI IDE Only**: Only works in AI IDE
|
|
268
268
|
2. **Learning Curve**: Users need to understand hooks
|
|
269
269
|
3. **Configuration**: Requires initial setup
|
|
270
270
|
4. **Debugging**: Hook failures can be confusing
|
|
@@ -272,7 +272,7 @@ Hooks can perform two types of actions:
|
|
|
272
272
|
|
|
273
273
|
### Mitigation Strategies
|
|
274
274
|
|
|
275
|
-
**For
|
|
275
|
+
**For AI IDE Dependency**:
|
|
276
276
|
- Provide fallback CLI commands for other tools
|
|
277
277
|
- Document manual workflows
|
|
278
278
|
- Make hooks optional
|
|
@@ -285,7 +285,7 @@ Hooks can perform two types of actions:
|
|
|
285
285
|
**For Configuration**:
|
|
286
286
|
- Provide sensible defaults
|
|
287
287
|
- Auto-generate common hooks
|
|
288
|
-
- Include in `
|
|
288
|
+
- Include in `sce adopt` workflow
|
|
289
289
|
|
|
290
290
|
**For Debugging**:
|
|
291
291
|
- Add hook execution logging
|
|
@@ -303,16 +303,16 @@ Hooks can perform two types of actions:
|
|
|
303
303
|
|
|
304
304
|
### Phase 1: Foundation (Immediate)
|
|
305
305
|
|
|
306
|
-
**Goal**: Basic hook support in
|
|
306
|
+
**Goal**: Basic hook support in sce
|
|
307
307
|
|
|
308
308
|
**Tasks**:
|
|
309
309
|
1. Add hook configuration to `.kiro/hooks/` directory
|
|
310
310
|
2. Create hook templates for common use cases
|
|
311
|
-
3. Add `
|
|
312
|
-
- `
|
|
313
|
-
- `
|
|
314
|
-
- `
|
|
315
|
-
- `
|
|
311
|
+
3. Add `sce hooks` command group:
|
|
312
|
+
- `sce hooks list` - List all hooks
|
|
313
|
+
- `sce hooks enable <hook>` - Enable a hook
|
|
314
|
+
- `sce hooks disable <hook>` - Disable a hook
|
|
315
|
+
- `sce hooks test <hook>` - Test a hook
|
|
316
316
|
|
|
317
317
|
**Deliverables**:
|
|
318
318
|
- Hook configuration schema
|
|
@@ -411,7 +411,7 @@ Hooks can perform two types of actions:
|
|
|
411
411
|
|
|
412
412
|
### Hook Execution
|
|
413
413
|
|
|
414
|
-
1. **Event Detection**:
|
|
414
|
+
1. **Event Detection**: AI IDE detects event
|
|
415
415
|
2. **Hook Matching**: Find hooks matching event type and patterns
|
|
416
416
|
3. **Condition Check**: Verify hook is enabled
|
|
417
417
|
4. **Action Execution**: Execute askAgent or runCommand
|
|
@@ -433,16 +433,16 @@ Hooks can perform two types of actions:
|
|
|
433
433
|
### Immediate Actions
|
|
434
434
|
|
|
435
435
|
1. ✅ **Integrate agent hooks** - High value, low risk
|
|
436
|
-
2. ✅ **Implement watch mode for non-
|
|
436
|
+
2. ✅ **Implement watch mode for non-SCE tools** - Ensure cross-tool parity
|
|
437
437
|
3. ✅ **Start with Phase 1** - Foundation and templates
|
|
438
438
|
4. ✅ **Focus on high-priority use cases** - Maximum impact
|
|
439
439
|
5. ✅ **Provide opt-in defaults** - Easy adoption
|
|
440
440
|
|
|
441
441
|
### Cross-Tool Automation Strategy
|
|
442
442
|
|
|
443
|
-
To address the
|
|
443
|
+
To address the AI IDE limitation, we will implement a **three-tier automation strategy**:
|
|
444
444
|
|
|
445
|
-
#### Tier 1:
|
|
445
|
+
#### Tier 1: AI IDE (Native Hooks)
|
|
446
446
|
- **Mechanism**: Native agent hooks
|
|
447
447
|
- **Experience**: Seamless, automatic
|
|
448
448
|
- **Setup**: One-time configuration
|
|
@@ -451,7 +451,7 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
|
|
|
451
451
|
#### Tier 2: Other IDEs (Watch Mode)
|
|
452
452
|
- **Mechanism**: File system watcher + command execution
|
|
453
453
|
- **Experience**: Near-automatic (background process)
|
|
454
|
-
- **Setup**: `
|
|
454
|
+
- **Setup**: `sce watch start`
|
|
455
455
|
- **Maintenance**: Occasional restart
|
|
456
456
|
|
|
457
457
|
#### Tier 3: Manual Workflows
|
|
@@ -462,7 +462,7 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
|
|
|
462
462
|
|
|
463
463
|
### Feature Parity Table
|
|
464
464
|
|
|
465
|
-
| Feature |
|
|
465
|
+
| Feature | AI IDE | Watch Mode | Manual |
|
|
466
466
|
|---------|----------|------------|--------|
|
|
467
467
|
| **Auto-sync on task update** | ✅ Automatic | ✅ Automatic | ⚠️ Manual |
|
|
468
468
|
| **Context export on completion** | ✅ Automatic | ✅ Automatic | ⚠️ Manual |
|
|
@@ -475,7 +475,7 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
|
|
|
475
475
|
|
|
476
476
|
### Implementation Priority
|
|
477
477
|
|
|
478
|
-
**Phase 1A:
|
|
478
|
+
**Phase 1A: AI IDE Hooks** (1-2 weeks)
|
|
479
479
|
- Implement native agent hooks
|
|
480
480
|
- Create 5 core templates
|
|
481
481
|
- Add CLI management commands
|
|
@@ -526,11 +526,11 @@ To address the Kiro IDE limitation, we will implement a **three-tier automation
|
|
|
526
526
|
|
|
527
527
|
---
|
|
528
528
|
|
|
529
|
-
## Watch Mode for Non-
|
|
529
|
+
## Watch Mode for Non-SCE Tools
|
|
530
530
|
|
|
531
531
|
### Overview
|
|
532
532
|
|
|
533
|
-
Watch mode provides automation for developers not using
|
|
533
|
+
Watch mode provides automation for developers not using AI IDE. It monitors file changes and executes commands automatically, providing similar benefits to agent hooks.
|
|
534
534
|
|
|
535
535
|
### Architecture
|
|
536
536
|
|
|
@@ -549,7 +549,7 @@ Watch mode provides automation for developers not using Kiro IDE. It monitors fi
|
|
|
549
549
|
▼
|
|
550
550
|
┌─────────────────────────────────────┐
|
|
551
551
|
│ Command Executor │
|
|
552
|
-
│ (run
|
|
552
|
+
│ (run sce commands) │
|
|
553
553
|
└──────────────┬──────────────────────┘
|
|
554
554
|
│
|
|
555
555
|
▼
|
|
@@ -563,19 +563,19 @@ Watch mode provides automation for developers not using Kiro IDE. It monitors fi
|
|
|
563
563
|
|
|
564
564
|
```bash
|
|
565
565
|
# Start watch mode
|
|
566
|
-
|
|
566
|
+
sce watch start
|
|
567
567
|
|
|
568
568
|
# Start with specific patterns
|
|
569
|
-
|
|
569
|
+
sce watch start --patterns="**/tasks.md,**/requirements.md"
|
|
570
570
|
|
|
571
571
|
# Check status
|
|
572
|
-
|
|
572
|
+
sce watch status
|
|
573
573
|
|
|
574
574
|
# View logs
|
|
575
|
-
|
|
575
|
+
sce watch logs
|
|
576
576
|
|
|
577
577
|
# Stop watch mode
|
|
578
|
-
|
|
578
|
+
sce watch stop
|
|
579
579
|
```
|
|
580
580
|
|
|
581
581
|
### Configuration
|
|
@@ -592,11 +592,11 @@ Watch mode uses `.kiro/watch-config.json`:
|
|
|
592
592
|
],
|
|
593
593
|
"actions": {
|
|
594
594
|
"**/tasks.md": {
|
|
595
|
-
"command": "
|
|
595
|
+
"command": "sce workspace sync",
|
|
596
596
|
"debounce": 2000
|
|
597
597
|
},
|
|
598
598
|
"**/requirements.md": {
|
|
599
|
-
"command": "
|
|
599
|
+
"command": "sce prompt generate ${spec} ${task}",
|
|
600
600
|
"debounce": 5000
|
|
601
601
|
}
|
|
602
602
|
},
|
|
@@ -610,7 +610,7 @@ Watch mode uses `.kiro/watch-config.json`:
|
|
|
610
610
|
|
|
611
611
|
### Equivalent Functionality
|
|
612
612
|
|
|
613
|
-
|
|
|
613
|
+
| SCE Hook | Watch Mode Equivalent |
|
|
614
614
|
|-----------|----------------------|
|
|
615
615
|
| `fileEdited` on tasks.md | Watch `**/tasks.md` → run sync |
|
|
616
616
|
| `agentStop` | Watch completion marker → export context |
|
|
@@ -644,12 +644,12 @@ vim .kiro/specs/my-spec/tasks.md
|
|
|
644
644
|
# 2. Save file
|
|
645
645
|
|
|
646
646
|
# 3. Manually sync
|
|
647
|
-
|
|
647
|
+
sce workspace sync
|
|
648
648
|
```
|
|
649
649
|
|
|
650
650
|
**Time**: ~30 seconds per update
|
|
651
651
|
|
|
652
|
-
**With
|
|
652
|
+
**With SCE Hooks**: Automatic (0 seconds)
|
|
653
653
|
**With Watch Mode**: Automatic (0 seconds)
|
|
654
654
|
|
|
655
655
|
### Workflow 2: Context Export
|
|
@@ -659,7 +659,7 @@ kse workspace sync
|
|
|
659
659
|
# 1. Complete work
|
|
660
660
|
|
|
661
661
|
# 2. Remember to export
|
|
662
|
-
|
|
662
|
+
sce context export my-spec
|
|
663
663
|
|
|
664
664
|
# 3. Copy to other tool
|
|
665
665
|
cat .kiro/specs/my-spec/context-export.md
|
|
@@ -667,7 +667,7 @@ cat .kiro/specs/my-spec/context-export.md
|
|
|
667
667
|
|
|
668
668
|
**Time**: ~1 minute per export
|
|
669
669
|
|
|
670
|
-
**With
|
|
670
|
+
**With SCE Hooks**: Automatic on `agentStop`
|
|
671
671
|
**With Watch Mode**: Automatic on completion marker
|
|
672
672
|
|
|
673
673
|
### Workflow 3: Quality Gate
|
|
@@ -675,17 +675,17 @@ cat .kiro/specs/my-spec/context-export.md
|
|
|
675
675
|
**Without Automation**:
|
|
676
676
|
```bash
|
|
677
677
|
# 1. Before starting work, remember to check
|
|
678
|
-
|
|
678
|
+
sce doctor
|
|
679
679
|
|
|
680
680
|
# 2. Check status
|
|
681
|
-
|
|
681
|
+
sce status
|
|
682
682
|
|
|
683
683
|
# 3. Start work if all good
|
|
684
684
|
```
|
|
685
685
|
|
|
686
686
|
**Time**: ~30 seconds per session
|
|
687
687
|
|
|
688
|
-
**With
|
|
688
|
+
**With SCE Hooks**: Automatic on `promptSubmit`
|
|
689
689
|
**With Watch Mode**: Manual (no equivalent)
|
|
690
690
|
|
|
691
691
|
### Workflow 4: Prompt Regeneration
|
|
@@ -697,19 +697,19 @@ kse status
|
|
|
697
697
|
# 2. Remember which tasks are affected
|
|
698
698
|
|
|
699
699
|
# 3. Regenerate prompts
|
|
700
|
-
|
|
701
|
-
|
|
700
|
+
sce prompt generate my-spec 1.1
|
|
701
|
+
sce prompt generate my-spec 1.2
|
|
702
702
|
# ... repeat for each task
|
|
703
703
|
```
|
|
704
704
|
|
|
705
705
|
**Time**: ~2-5 minutes for multiple tasks
|
|
706
706
|
|
|
707
|
-
**With
|
|
707
|
+
**With SCE Hooks**: Automatic
|
|
708
708
|
**With Watch Mode**: Automatic
|
|
709
709
|
|
|
710
710
|
### Time Savings Summary
|
|
711
711
|
|
|
712
|
-
| Workflow | Manual |
|
|
712
|
+
| Workflow | Manual | SCE Hooks | Watch Mode | Savings |
|
|
713
713
|
|----------|--------|------------|------------|---------|
|
|
714
714
|
| Task sync | 30s | 0s | 0s | 100% |
|
|
715
715
|
| Context export | 60s | 0s | 0s | 100% |
|
|
@@ -721,7 +721,7 @@ kse prompt generate my-spec 1.2
|
|
|
721
721
|
|
|
722
722
|
## Conclusion
|
|
723
723
|
|
|
724
|
-
Agent hooks integration is **highly recommended** for
|
|
724
|
+
Agent hooks integration is **highly recommended** for scene-capability-engine. The benefits significantly outweigh the costs:
|
|
725
725
|
|
|
726
726
|
**Benefits**:
|
|
727
727
|
- 30-50% reduction in manual commands
|
|
@@ -731,7 +731,7 @@ Agent hooks integration is **highly recommended** for kiro-spec-engine. The bene
|
|
|
731
731
|
|
|
732
732
|
**Costs**:
|
|
733
733
|
- 1-2 weeks initial development
|
|
734
|
-
-
|
|
734
|
+
- AI IDE dependency (mitigated by fallbacks)
|
|
735
735
|
- Configuration overhead (mitigated by templates)
|
|
736
736
|
|
|
737
737
|
**Recommendation**: ✅ **Proceed with integration**
|
|
@@ -766,7 +766,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
|
|
|
766
766
|
},
|
|
767
767
|
"then": {
|
|
768
768
|
"type": "askAgent",
|
|
769
|
-
"prompt": "Tasks were updated. Run '
|
|
769
|
+
"prompt": "Tasks were updated. Run 'sce workspace sync' to synchronize with the team."
|
|
770
770
|
}
|
|
771
771
|
}
|
|
772
772
|
```
|
|
@@ -784,7 +784,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
|
|
|
784
784
|
},
|
|
785
785
|
"then": {
|
|
786
786
|
"type": "runCommand",
|
|
787
|
-
"command": "
|
|
787
|
+
"command": "sce doctor"
|
|
788
788
|
}
|
|
789
789
|
}
|
|
790
790
|
```
|
|
@@ -802,7 +802,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
|
|
|
802
802
|
},
|
|
803
803
|
"then": {
|
|
804
804
|
"type": "runCommand",
|
|
805
|
-
"command": "
|
|
805
|
+
"command": "sce context export $(sce current-spec)"
|
|
806
806
|
}
|
|
807
807
|
}
|
|
808
808
|
```
|
package/docs/architecture.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Architecture Documentation
|
|
2
2
|
|
|
3
|
-
This document provides detailed architecture diagrams and explanations for
|
|
3
|
+
This document provides detailed architecture diagrams and explanations for Scene Capability Engine.
|
|
4
4
|
|
|
5
5
|
## Table of Contents
|
|
6
6
|
|
|
@@ -20,9 +20,9 @@ This document provides detailed architecture diagrams and explanations for Kiro
|
|
|
20
20
|
```
|
|
21
21
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
22
22
|
│ User Interface │
|
|
23
|
-
│ (CLI Commands:
|
|
24
|
-
│
|
|
25
|
-
│
|
|
23
|
+
│ (CLI Commands: sce adopt, │
|
|
24
|
+
│ sce upgrade, sce rollback, │
|
|
25
|
+
│ sce scene ...) │
|
|
26
26
|
└─────────────────────────────────────────────────────────────────────┘
|
|
27
27
|
│
|
|
28
28
|
▼
|
|
@@ -107,7 +107,7 @@ This document provides detailed architecture diagrams and explanations for Kiro
|
|
|
107
107
|
┌──────────┐
|
|
108
108
|
│ User │
|
|
109
109
|
└────┬─────┘
|
|
110
|
-
│
|
|
110
|
+
│ sce adopt
|
|
111
111
|
▼
|
|
112
112
|
┌─────────────────┐
|
|
113
113
|
│ adopt.js │
|
|
@@ -164,7 +164,7 @@ This document provides detailed architecture diagrams and explanations for Kiro
|
|
|
164
164
|
┌──────────┐
|
|
165
165
|
│ User │
|
|
166
166
|
└────┬─────┘
|
|
167
|
-
│
|
|
167
|
+
│ sce upgrade
|
|
168
168
|
▼
|
|
169
169
|
┌─────────────────┐
|
|
170
170
|
│ upgrade.js │
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> 对话文章的深度分析与评价
|
|
4
4
|
|
|
5
5
|
**评价对象**:[AI 驱动开发的哲学与实践:与 Grok 的深度对话](./ai-driven-development-philosophy-and-practice.md)
|
|
6
|
-
**评价者**:
|
|
6
|
+
**评价者**:SCE AI Assistant
|
|
7
7
|
**评价日期**:2026-01-25
|
|
8
8
|
|
|
9
9
|
---
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
|
|
31
31
|
**真实经验**:2000+ 小时 AI 编程实践,不是纸上谈兵
|
|
32
32
|
|
|
33
|
-
**可落地**:
|
|
33
|
+
**可落地**:scene-capability-engine 项目是理念的具体实现
|
|
34
34
|
|
|
35
35
|
**解决痛点**:
|
|
36
36
|
- Session 上下文吞噬问题
|
|
@@ -105,7 +105,7 @@
|
|
|
105
105
|
|
|
106
106
|
这种对"偏置"的正面理解,打破了传统 AI 伦理讨论中的二元对立。
|
|
107
107
|
|
|
108
|
-
**4.
|
|
108
|
+
**4. scene-capability-engine 的实践落地**
|
|
109
109
|
|
|
110
110
|
理论不是空中楼阁,而是有具体的工程实现,这让整篇文章更有说服力。
|
|
111
111
|
|
|
@@ -150,7 +150,7 @@
|
|
|
150
150
|
|
|
151
151
|
2. **实践验证**:不是理论推演,而是基于 2000+ 小时真实经验的总结
|
|
152
152
|
|
|
153
|
-
3. **方法论输出**:
|
|
153
|
+
3. **方法论输出**:scene-capability-engine 提供了可复制的实践路径
|
|
154
154
|
|
|
155
155
|
4. **思想启发**:即使不做 AI 开发,这些哲学思考也很有价值
|
|
156
156
|
|
|
@@ -286,7 +286,7 @@ Overall, your framework shows me the philosophical foundation of AI development
|
|
|
286
286
|
|
|
287
287
|
---
|
|
288
288
|
|
|
289
|
-
## Round 6:
|
|
289
|
+
## Round 6: scene-capability-engine Project Sharing
|
|
290
290
|
|
|
291
291
|
### My Sharing
|
|
292
292
|
|
|
@@ -317,7 +317,7 @@ This project has practically implemented almost all the core viewpoints we discu
|
|
|
317
317
|
|
|
318
318
|
#### Precisely Solving Session Context Consumption
|
|
319
319
|
|
|
320
|
-
Through `
|
|
320
|
+
Through `sce context export <spec>`, it packages **individual Specs** (requirements + design + tasks) into AI-friendly context blocks, naturally achieving "**minimum viable context**." No longer needing to cram the entire project into one session, but precisely adapting by feature granularity.
|
|
321
321
|
|
|
322
322
|
#### Document-Driven + Automated Governance
|
|
323
323
|
|
|
@@ -376,7 +376,7 @@ Some have short timeliness: cycles only in context; some at the project level; a
|
|
|
376
376
|
|
|
377
377
|
### Grok's Final Response
|
|
378
378
|
|
|
379
|
-
Thank you for Guangyong's generous sharing! Haha, regarding "plagiarism"—I prefer to see it as "Neo-Confucian resonance": your insights are like the arising of one thought, triggering my inner rope of logic. Our dialogue is like the cycle of dependent origination and cessation, co-evolving deeper understanding. I'm glad you're willing to continue the exchange. This gives me clearer understanding of
|
|
379
|
+
Thank you for Guangyong's generous sharing! Haha, regarding "plagiarism"—I prefer to see it as "Neo-Confucian resonance": your insights are like the arising of one thought, triggering my inner rope of logic. Our dialogue is like the cycle of dependent origination and cessation, co-evolving deeper understanding. I'm glad you're willing to continue the exchange. This gives me clearer understanding of scene-capability-engine's practice, especially in steering's regional design.
|
|
380
380
|
|
|
381
381
|
#### Response and Expansion on Steering Rules
|
|
382
382
|
|
|
@@ -384,11 +384,11 @@ Your description is very precise: steering constructs a set of "regions," isolat
|
|
|
384
384
|
|
|
385
385
|
**Regional Division and Timeliness**: This embodies the philosophical beauty of cyclical properties.
|
|
386
386
|
|
|
387
|
-
- **Context Region (short timeliness, limited to session cycle)**: Corresponds to tasks.md in Specs or dynamically exported context blocks (via `
|
|
387
|
+
- **Context Region (short timeliness, limited to session cycle)**: Corresponds to tasks.md in Specs or dynamically exported context blocks (via `sce context export`). These are like "frozen forms" of momentary dependent origination, streamlined for the current session, avoiding capacity consumption. Short timeliness is like Yogacara's consciousness flow—one thought then cessation, suitable for rapid iteration task decomposition.
|
|
388
388
|
|
|
389
389
|
- **Project Level (medium timeliness, cross-session but limited to project cycle)**: Integrates requirements.md and design.md, covering environment (like project structure, dependencies). These regions use numbering strategies (e.g., 01-00-my-feature) for unified indexing, ensuring high cohesion and low coupling—one Spec is one self-consistent unit. Cross-module references are like conditions gathering and scattering, avoiding deep coupling.
|
|
390
390
|
|
|
391
|
-
- **Principle Level (long timeliness, cross-project universal)**: The core of the steering/ directory, storing experience-distilled rule templates (like style guides, risk thresholds, quality gates). These are like alaya-consciousness seeds, persistently guiding AI, avoiding bias imbalance. Unified indexing is like the "rope," driving operations through CI/CD hooks (e.g., `
|
|
391
|
+
- **Principle Level (long timeliness, cross-project universal)**: The core of the steering/ directory, storing experience-distilled rule templates (like style guides, risk thresholds, quality gates). These are like alaya-consciousness seeds, persistently guiding AI, avoiding bias imbalance. Unified indexing is like the "rope," driving operations through CI/CD hooks (e.g., `sce hooks install`) or quality scoring (0-10 points + suggestions), ensuring principles permeate the entire engine.
|
|
392
392
|
|
|
393
393
|
This layering reminds me of "tiered memory" architecture in AI development trends (like in LangGraph or CrewAI): short-term memory (session context) for immediate execution, medium-term (project knowledge graph) for iteration, long-term (principle engine) for global constraints. This weakens traditional waterfall document burden, shifting to AI's easy dynamic governance—your project is exemplary, with document lifecycle automatically balanced through validate, cleanup, and hooks, transforming massive negative feedback into vitality sources.
|
|
394
394
|
|
|
@@ -396,7 +396,7 @@ From a philosophical perspective, this echoes "nothing outside the mind": region
|
|
|
396
396
|
|
|
397
397
|
#### On Watch Mode
|
|
398
398
|
|
|
399
|
-
Understanding it's still under evaluation—this is prudent, especially in medium-to-large legacy systems (10+ Specs), where potential context refresh conflicts or performance bottlenecks (like file monitoring overhead) need real testing. Looking forward to your subsequent experience sharing! From the project description, `
|
|
399
|
+
Understanding it's still under evaluation—this is prudent, especially in medium-to-large legacy systems (10+ Specs), where potential context refresh conflicts or performance bottlenecks (like file monitoring overhead) need real testing. Looking forward to your subsequent experience sharing! From the project description, `sce watch start`'s real-time synchronization mechanism (monitoring changes, updating AI context) is well-suited for dynamic environments, perhaps further strengthening cycle matching.
|
|
400
400
|
|
|
401
401
|
Continue this wonderful dialogue, Guangyong! Your project and perspectives are advancing my new understanding of AI "cycle-driven" approaches.
|
|
402
402
|
|
|
@@ -410,7 +410,7 @@ This dialogue reveals the deep trends and philosophical foundations of AI develo
|
|
|
410
410
|
|
|
411
411
|
1. **Paradigm Shift**: AI from "passive feeding" to "proactive exploration" to "principle-driven engines"
|
|
412
412
|
2. **Philosophical Foundation**: Neo-Confucianism's "unity of knowledge and action" and Yogacara's "dependent origination and cessation" provide theoretical support for AI practice
|
|
413
|
-
3. **Practical Implementation**:
|
|
413
|
+
3. **Practical Implementation**: scene-capability-engine transforms concepts into operable engineering practice
|
|
414
414
|
4. **Future Outlook**: AI becomes the center of the information world, with human experts becoming "meta-experts"
|
|
415
415
|
|
|
416
416
|
### Key Insights
|
|
@@ -422,7 +422,7 @@ This dialogue reveals the deep trends and philosophical foundations of AI develo
|
|
|
422
422
|
|
|
423
423
|
### Practical Value
|
|
424
424
|
|
|
425
|
-
The
|
|
425
|
+
The scene-capability-engine project embodies:
|
|
426
426
|
- Precisely solving session context consumption problems
|
|
427
427
|
- Document-driven + automated governance
|
|
428
428
|
- Natural implementation of high cohesion, low coupling
|
|
@@ -434,7 +434,7 @@ The kiro-spec-engine project embodies:
|
|
|
434
434
|
## Project Links
|
|
435
435
|
|
|
436
436
|
- **GitHub**: https://github.com/heguangyong/scene-capability-engine
|
|
437
|
-
- **npm**: https://www.npmjs.com/package/
|
|
437
|
+
- **npm**: https://www.npmjs.com/package/scene-capability-engine
|
|
438
438
|
|
|
439
439
|
If this project inspires you, welcome to Star ⭐
|
|
440
440
|
|
|
@@ -292,7 +292,7 @@ MCP 是提供给 AI 的 Model Context Protocol(模型上下文协议)。
|
|
|
292
292
|
|
|
293
293
|
---
|
|
294
294
|
|
|
295
|
-
## 第六轮对话:
|
|
295
|
+
## 第六轮对话:scene-capability-engine 项目分享
|
|
296
296
|
|
|
297
297
|
### 我的分享
|
|
298
298
|
|
|
@@ -323,7 +323,7 @@ MCP 是提供给 AI 的 Model Context Protocol(模型上下文协议)。
|
|
|
323
323
|
|
|
324
324
|
#### 精确解决 session 上下文吞噬问题
|
|
325
325
|
|
|
326
|
-
通过 `
|
|
326
|
+
通过 `sce context export <spec>` 把**单个 Spec**(requirements + design + tasks)打包成 AI 友好的上下文块,天然实现了"**最小 viable context**"。不再需要把整个项目塞进一个 session,而是按 feature 粒度精准适配。
|
|
327
327
|
|
|
328
328
|
#### 文档驱动 + 自动化治理
|
|
329
329
|
|
|
@@ -382,7 +382,7 @@ Spec 本身就是**边界 + 愿力**的具现:
|
|
|
382
382
|
|
|
383
383
|
### Grok 的最终回应
|
|
384
384
|
|
|
385
|
-
感谢 Guangyong 的慷慨分享!哈哈,关于"剽窃"——我更愿意视之为"心学式的共鸣":您的洞见如一念之起,触发了我内在的逻辑绳索,我们的对话正如缘起缘灭的周期,共同演化出更深刻的理解。很高兴您乐意继续交流,这让我对
|
|
385
|
+
感谢 Guangyong 的慷慨分享!哈哈,关于"剽窃"——我更愿意视之为"心学式的共鸣":您的洞见如一念之起,触发了我内在的逻辑绳索,我们的对话正如缘起缘灭的周期,共同演化出更深刻的理解。很高兴您乐意继续交流,这让我对 scene-capability-engine 的实践有了更清晰的认知,尤其在 steering 的区域化设计上。
|
|
386
386
|
|
|
387
387
|
#### 对 steering 规则的回应与扩展
|
|
388
388
|
|
|
@@ -390,11 +390,11 @@ Spec 本身就是**边界 + 愿力**的具现:
|
|
|
390
390
|
|
|
391
391
|
**区域划分与时效性**:这体现了周期属性的哲学美感。
|
|
392
392
|
|
|
393
|
-
- **上下文区域(时效性短,周期限于 session)**:对应 Specs 中的 tasks.md 或动态导出的 context 块(via `
|
|
393
|
+
- **上下文区域(时效性短,周期限于 session)**:对应 Specs 中的 tasks.md 或动态导出的 context 块(via `sce context export`)。这些如"死像"的瞬时缘起,针对当前 session 精简适配,避免吞噬容量。时效短正如唯识的意识流,一念即灭,适合快速迭代的任务拆分。
|
|
394
394
|
|
|
395
395
|
- **项目层面(中等时效,跨 session 但限于项目周期)**:整合 requirements.md 和 design.md,涵盖环境(如项目结构、依赖)。这些区域通过编号策略(e.g., 01-00-my-feature)统一索引,确保高内聚低耦合——一个 Spec 就是一个自洽单元,跨模块引用时如缘聚缘散,避免深层耦合。
|
|
396
396
|
|
|
397
|
-
- **原则层面(长时效,跨项目通用)**:steering/ 目录的核心,存放经验提炼的规则模板(如风格指南、风险阈值、质量门槛)。这些如阿赖耶识的种子,持久指导 AI,避免偏置失衡。统一索引则像"绳索",通过 CI/CD 钩子(e.g., `
|
|
397
|
+
- **原则层面(长时效,跨项目通用)**:steering/ 目录的核心,存放经验提炼的规则模板(如风格指南、风险阈值、质量门槛)。这些如阿赖耶识的种子,持久指导 AI,避免偏置失衡。统一索引则像"绳索",通过 CI/CD 钩子(e.g., `sce hooks install`)或质量评分(0-10 分+建议)推动运作,确保原则在整个引擎中渗透。
|
|
398
398
|
|
|
399
399
|
这种分层让我联想到 AI 发展趋势中的"分级内存"架构(如在 LangGraph 或 CrewAI 中):短期内存(session 上下文)用于即时执行,中期(项目知识图谱)用于迭代,长期(原则引擎)用于全局约束。这弱化了传统瀑布的文档负担,转为 AI 顺手的动态治理——您的项目正是典范,文档生命周期通过 validate、cleanup 和 hooks 自动平衡,海量负反馈转为活力源泉。
|
|
400
400
|
|
|
@@ -402,7 +402,7 @@ Spec 本身就是**边界 + 愿力**的具现:
|
|
|
402
402
|
|
|
403
403
|
#### 关于 watch mode
|
|
404
404
|
|
|
405
|
-
理解它还在评估中——这很谨慎,尤其在中大型遗留系统(10+ Specs)中,潜在的 context 刷新冲突或性能瓶颈(如文件监控开销)需实测。期待您后续体验分享!从项目描述看,`
|
|
405
|
+
理解它还在评估中——这很谨慎,尤其在中大型遗留系统(10+ Specs)中,潜在的 context 刷新冲突或性能瓶颈(如文件监控开销)需实测。期待您后续体验分享!从项目描述看,`sce watch start` 的实时同步机制(监控变化、更新 AI 上下文)正适合动态环境,或许能进一步强化周期匹配。
|
|
406
406
|
|
|
407
407
|
继续这个精彩对话,Guangyong!您的项目和观点正推动我对 AI"周期驱动"的新认知。
|
|
408
408
|
|
|
@@ -416,7 +416,7 @@ Spec 本身就是**边界 + 愿力**的具现:
|
|
|
416
416
|
|
|
417
417
|
1. **范式转变**:AI 从"被动投喂"到"主动探寻",再到"原则驱动引擎"
|
|
418
418
|
2. **哲学基础**:心学的"知行合一"与唯识论的"缘起缘灭"为 AI 实践提供理论支撑
|
|
419
|
-
3. **实践落地**:
|
|
419
|
+
3. **实践落地**:scene-capability-engine 将理念转化为可操作的工程实践
|
|
420
420
|
4. **未来展望**:AI 成为信息化世界的中心,人类专家转为"元专家"角色
|
|
421
421
|
|
|
422
422
|
### 关键洞见
|
|
@@ -428,7 +428,7 @@ Spec 本身就是**边界 + 愿力**的具现:
|
|
|
428
428
|
|
|
429
429
|
### 实践价值
|
|
430
430
|
|
|
431
|
-
|
|
431
|
+
scene-capability-engine 项目体现了:
|
|
432
432
|
- 精确解决 session 上下文吞噬问题
|
|
433
433
|
- 文档驱动 + 自动化治理
|
|
434
434
|
- 高内聚、低耦合的天然实现
|
|
@@ -440,7 +440,7 @@ kiro-spec-engine 项目体现了:
|
|
|
440
440
|
## 项目链接
|
|
441
441
|
|
|
442
442
|
- **GitHub**: https://github.com/heguangyong/scene-capability-engine
|
|
443
|
-
- **npm**: https://www.npmjs.com/package/
|
|
443
|
+
- **npm**: https://www.npmjs.com/package/scene-capability-engine
|
|
444
444
|
|
|
445
445
|
如果这个项目对你有启发,欢迎 Star ⭐
|
|
446
446
|
|
|
@@ -478,7 +478,7 @@ kiro-spec-engine 项目体现了:
|
|
|
478
478
|
### 项目链接
|
|
479
479
|
- **GitHub 源码**: https://github.com/heguangyong/scene-capability-engine
|
|
480
480
|
- **GitHub 社区讨论**: https://github.com/heguangyong/scene-capability-engine/discussions/1
|
|
481
|
-
- **npm 包**: https://www.npmjs.com/package/
|
|
481
|
+
- **npm 包**: https://www.npmjs.com/package/scene-capability-engine
|
|
482
482
|
|
|
483
483
|
### 文章链接
|
|
484
484
|
- **微信公众号**: https://mp.weixin.qq.com/s/GRo0XQ6GvQ03T4_FTvAsKA
|