scene-capability-engine 3.3.5 → 3.3.10
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 +130 -78
- package/README.md +6 -6
- package/README.zh.md +6 -6
- package/bin/scene-capability-engine.js +129 -7
- package/docs/331-poc-adaptation-roadmap.md +3 -3
- package/docs/331-poc-dual-track-integration-guide.md +8 -8
- package/docs/331-poc-weekly-delivery-checklist.md +6 -6
- package/docs/README.md +4 -0
- package/docs/adopt-migration-guide.md +13 -13
- package/docs/adoption-guide.md +28 -28
- package/docs/agent-hooks-analysis.md +10 -10
- package/docs/architecture.md +13 -13
- package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +3 -3
- package/docs/articles/ai-driven-development-philosophy-and-practice.md +3 -3
- package/docs/autonomous-control-guide.md +35 -35
- package/docs/command-reference.md +192 -153
- package/docs/cross-tool-guide.md +7 -7
- package/docs/developer-guide.md +8 -8
- package/docs/document-governance.md +15 -15
- package/docs/environment-management-guide.md +6 -6
- package/docs/examples/add-export-command/design.md +1 -1
- package/docs/faq.md +13 -13
- package/docs/handoff-profile-integration-guide.md +3 -3
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +7 -7
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +1 -1
- package/docs/integration-modes.md +12 -12
- package/docs/integration-philosophy.md +11 -11
- package/docs/interactive-customization/331-poc-sce-integration-checklist.md +24 -24
- package/docs/interactive-customization/README.md +43 -43
- package/docs/interactive-customization/business-mode-policy-baseline.json +33 -0
- package/docs/interactive-customization/dual-ui-mode-integration-guide.md +1 -1
- package/docs/interactive-customization/moqui-adapter-interface.md +2 -2
- package/docs/interactive-customization/moqui-copilot-integration-guide.md +1 -1
- package/docs/interactive-customization/moqui-interactive-template-playbook.md +4 -4
- package/docs/interactive-customization/phase-acceptance-evidence.md +2 -2
- package/docs/knowledge-management-guide.md +6 -6
- package/docs/manual-workflows-guide.md +4 -4
- package/docs/moqui-capability-matrix.md +3 -3
- package/docs/moqui-standard-rebuild-guide.md +8 -8
- package/docs/moqui-template-core-library-playbook.md +27 -27
- package/docs/multi-agent-coordination-guide.md +19 -19
- package/docs/multi-repo-management-guide.md +17 -17
- package/docs/quick-start-with-ai-tools.md +7 -7
- package/docs/quick-start.md +2 -2
- package/docs/release-checklist.md +4 -4
- package/docs/sce-business-mode-map.md +103 -0
- package/docs/security-governance-default-baseline.md +12 -12
- package/docs/spec-collaboration-guide.md +3 -3
- package/docs/spec-locking-guide.md +2 -2
- package/docs/spec-workflow.md +3 -3
- package/docs/starter-kit/README.md +4 -4
- package/docs/starter-kit/handoff-manifest.starter.json +2 -2
- package/docs/starter-kit/release.workflow.sample.yml +1 -1
- package/docs/steering-strategy-guide.md +15 -15
- package/docs/team-collaboration-guide.md +69 -69
- package/docs/testing-strategy.md +2 -2
- package/docs/tools/claude-guide.md +14 -4
- package/docs/tools/cursor-guide.md +14 -14
- package/docs/tools/generic-guide.md +9 -9
- package/docs/tools/kiro-guide.md +4 -4
- package/docs/tools/vscode-guide.md +13 -13
- package/docs/tools/windsurf-guide.md +6 -6
- package/docs/troubleshooting.md +22 -22
- package/docs/upgrade-guide.md +8 -8
- package/docs/value-observability-guide.md +3 -3
- package/docs/zh/README.md +6 -0
- package/docs/zh/quick-start.md +15 -15
- package/docs/zh/release-checklist.md +3 -3
- package/docs/zh/tools/claude-guide.md +16 -6
- package/docs/zh/tools/cursor-guide.md +11 -11
- package/docs/zh/tools/generic-guide.md +13 -13
- package/docs/zh/tools/kiro-guide.md +2 -2
- package/docs/zh/tools/vscode-guide.md +11 -11
- package/docs/zh/tools/windsurf-guide.md +11 -11
- package/docs/zh/value-observability-guide.md +3 -3
- package/lib/adoption/adoption-logger.js +1 -1
- package/lib/adoption/adoption-strategy.js +28 -28
- package/lib/adoption/backup-manager.js +3 -3
- package/lib/adoption/conflict-resolver.js +2 -2
- package/lib/adoption/detection-engine.js +8 -8
- package/lib/adoption/error-formatter.js +4 -4
- package/lib/adoption/file-classifier.js +6 -6
- package/lib/adoption/progress-reporter.js +1 -1
- package/lib/adoption/smart-orchestrator.js +10 -10
- package/lib/adoption/strategy-selector.js +6 -6
- package/lib/adoption/summary-generator.js +1 -1
- package/lib/adoption/template-sync.js +8 -8
- package/lib/auto/autonomous-engine.js +7 -7
- package/lib/auto/checkpoint-manager.js +1 -1
- package/lib/auto/close-loop-runner.js +12 -12
- package/lib/auto/error-recovery-manager.js +1 -1
- package/lib/auto/goal-decomposer.js +1 -1
- package/lib/auto/moqui-recovery-sequence.js +2 -2
- package/lib/auto/progress-tracker.js +1 -1
- package/lib/auto/state-manager.js +1 -1
- package/lib/backup/backup-system.js +10 -10
- package/lib/backup/selective-backup.js +4 -4
- package/lib/collab/agent-registry.js +2 -2
- package/lib/collab/contract-manager.js +1 -1
- package/lib/collab/coordinator.js +2 -2
- package/lib/collab/dependency-manager.js +1 -1
- package/lib/collab/integration-manager.js +1 -1
- package/lib/collab/metadata-manager.js +1 -1
- package/lib/collab/multi-agent-config.js +2 -2
- package/lib/collab/spec-lifecycle-manager.js +2 -2
- package/lib/collab/visualizer.js +1 -1
- package/lib/commands/adopt.js +6 -6
- package/lib/commands/auto.js +56 -56
- package/lib/commands/collab.js +2 -2
- package/lib/commands/docs.js +3 -3
- package/lib/commands/doctor.js +1 -1
- package/lib/commands/knowledge.js +2 -2
- package/lib/commands/lock.js +1 -1
- package/lib/commands/ops.js +1 -1
- package/lib/commands/orchestrate.js +3 -3
- package/lib/commands/rollback.js +1 -1
- package/lib/commands/scene.js +135 -93
- package/lib/commands/session.js +139 -0
- package/lib/commands/spec-bootstrap.js +1 -1
- package/lib/commands/spec-gate.js +2 -2
- package/lib/commands/spec-pipeline.js +1 -1
- package/lib/commands/status.js +4 -4
- package/lib/commands/steering.js +119 -0
- package/lib/commands/value.js +1 -1
- package/lib/commands/watch.js +9 -9
- package/lib/commands/workspace-multi.js +1 -1
- package/lib/context/context-exporter.js +5 -7
- package/lib/context/prompt-generator.js +2 -2
- package/lib/environment/backup-system.js +1 -1
- package/lib/environment/environment-manager.js +2 -2
- package/lib/gitignore/gitignore-backup.js +3 -3
- package/lib/gitignore/gitignore-detector.js +13 -13
- package/lib/gitignore/gitignore-integration.js +3 -3
- package/lib/gitignore/gitignore-transformer.js +4 -4
- package/lib/gitignore/layered-rules-template.js +16 -16
- package/lib/governance/config-manager.js +1 -1
- package/lib/governance/doc-reference-checker.js +4 -4
- package/lib/governance/execution-logger.js +1 -1
- package/lib/governance/file-scanner.js +3 -3
- package/lib/interactive-customization/moqui-interactive-adapter.js +2 -2
- package/lib/knowledge/knowledge-manager.js +1 -1
- package/lib/lock/lock-manager.js +2 -2
- package/lib/lock/steering-file-lock.js +5 -5
- package/lib/lock/task-lock-manager.js +3 -3
- package/lib/operations/audit-logger.js +1 -1
- package/lib/operations/feedback-manager.js +1 -1
- package/lib/operations/operations-manager.js +3 -3
- package/lib/operations/permission-manager.js +2 -2
- package/lib/operations/template-loader.js +1 -1
- package/lib/orchestrator/agent-spawner.js +27 -2
- package/lib/orchestrator/bootstrap-prompt-builder.js +6 -6
- package/lib/orchestrator/orchestration-engine.js +1 -1
- package/lib/orchestrator/orchestrator-config.js +2 -2
- package/lib/repo/config-manager.js +3 -3
- package/lib/repo/handlers/init-handler.js +1 -1
- package/lib/repo/repo-manager.js +2 -2
- package/lib/runtime/business-mode-resolver.js +240 -0
- package/lib/runtime/session-store.js +207 -0
- package/lib/runtime/steering-contract.js +338 -0
- package/lib/scene-runtime/audit-emitter.js +1 -1
- package/lib/scene-runtime/binding-plugin-loader.js +3 -3
- package/lib/scene-runtime/eval-bridge.js +1 -1
- package/lib/scene-runtime/index.js +1 -1
- package/lib/scene-runtime/moqui-extractor.js +1 -1
- package/lib/scene-runtime/plan-compiler.js +1 -1
- package/lib/scene-runtime/policy-gate.js +1 -1
- package/lib/scene-runtime/runtime-executor.js +1 -1
- package/lib/scene-runtime/scene-loader.js +1 -1
- package/lib/spec/bootstrap/context-collector.js +1 -1
- package/lib/spec/pipeline/stage-adapters.js +3 -3
- package/lib/spec/pipeline/state-store.js +1 -1
- package/lib/spec-gate/policy/policy-loader.js +1 -1
- package/lib/spec-gate/rules/default-rules.js +6 -6
- package/lib/steering/adoption-config.js +1 -1
- package/lib/steering/compliance-error-reporter.js +3 -3
- package/lib/steering/context-sync-manager.js +2 -2
- package/lib/steering/index.js +1 -1
- package/lib/steering/spec-steering.js +2 -2
- package/lib/steering/steering-compliance-checker.js +1 -1
- package/lib/steering/steering-loader.js +4 -5
- package/lib/steering/steering-manager.js +4 -4
- package/lib/task/task-claimer.js +5 -5
- package/lib/task/task-status-store.js +2 -2
- package/lib/templates/content-generalizer.js +1 -1
- package/lib/templates/spec-reader.js +2 -2
- package/lib/templates/template-creator.js +1 -1
- package/lib/templates/template-exporter.js +3 -3
- package/lib/templates/template-manager.js +1 -1
- package/lib/upgrade/migration-engine.js +3 -3
- package/lib/upgrade/migrations/1.0.0-to-1.1.0.js +1 -1
- package/lib/utils/file-diff.js +6 -6
- package/lib/utils/tool-detector.js +10 -10
- package/lib/utils/validation.js +5 -5
- package/lib/value/metric-contract-loader.js +1 -1
- package/lib/version/version-manager.js +1 -1
- package/lib/watch/execution-logger.js +1 -1
- package/lib/watch/presets.js +8 -8
- package/lib/watch/watch-manager.js +2 -2
- package/lib/workspace/legacy-kiro-migrator.js +275 -0
- package/lib/workspace/multi/workspace-context-resolver.js +2 -2
- package/lib/workspace/multi/workspace-registry.js +2 -2
- package/lib/workspace/multi/workspace-state-manager.js +3 -3
- package/lib/workspace/workspace-manager.js +1 -1
- package/lib/workspace/workspace-sync.js +2 -2
- package/locales/en.json +4 -4
- package/locales/zh.json +4 -4
- package/package.json +9 -9
- package/template/{.kiro → .sce}/README.md +15 -15
- package/template/{.kiro → .sce}/hooks/check-spec-on-create.kiro.hook +2 -2
- package/template/{.kiro → .sce}/steering/CORE_PRINCIPLES.md +4 -4
- package/template/{.kiro → .sce}/steering/CURRENT_CONTEXT.md +1 -1
- package/template/{.kiro → .sce}/steering/ENVIRONMENT.md +3 -3
- package/template/{.kiro → .sce}/tools/backup_manager.py +3 -3
- package/template/{.kiro → .sce}/tools/configuration_manager.py +1 -1
- package/template/README.md +12 -12
- /package/template/{.kiro → .sce}/hooks/run-tests-on-save.kiro.hook +0 -0
- /package/template/{.kiro → .sce}/hooks/sync-tasks-on-edit.kiro.hook +0 -0
- /package/template/{.kiro → .sce}/specs/SPEC_WORKFLOW_GUIDE.md +0 -0
- /package/template/{.kiro → .sce}/steering/RULES_GUIDE.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/change-impact.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/deployment.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/feedback-response.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/migration-plan.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/monitoring.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/operations.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/rollback.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/tools.yaml +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/troubleshooting.md +0 -0
- /package/template/{.kiro → .sce}/tools/document_evaluator.py +0 -0
- /package/template/{.kiro → .sce}/tools/enhancement_logger.py +0 -0
- /package/template/{.kiro → .sce}/tools/error_handler.py +0 -0
- /package/template/{.kiro → .sce}/tools/improvement_identifier.py +0 -0
- /package/template/{.kiro → .sce}/tools/modification_applicator.py +0 -0
- /package/template/{.kiro → .sce}/tools/quality_gate_enforcer.py +0 -0
- /package/template/{.kiro → .sce}/tools/quality_scorer.py +0 -0
- /package/template/{.kiro → .sce}/tools/report_generator.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_refactored.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_v2.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_v3.py +0 -0
- /package/template/{.kiro → .sce}/tools/workflow_quality_gate.py +0 -0
|
@@ -77,7 +77,7 @@ Create `.vscode/sce.code-snippets`:
|
|
|
77
77
|
"prefix": "sce-ref",
|
|
78
78
|
"body": [
|
|
79
79
|
"/**",
|
|
80
|
-
" * Spec: .
|
|
80
|
+
" * Spec: .sce/specs/${1:spec-name}/",
|
|
81
81
|
" * Task: ${2:task-id}",
|
|
82
82
|
" * ",
|
|
83
83
|
" * Requirements: ${3:requirement-summary}",
|
|
@@ -101,7 +101,7 @@ Create `.vscode/sce.code-snippets`:
|
|
|
101
101
|
/**
|
|
102
102
|
* AuthController - Handles user authentication
|
|
103
103
|
*
|
|
104
|
-
* Spec: .
|
|
104
|
+
* Spec: .sce/specs/01-00-user-login/
|
|
105
105
|
* Task: 2.1 - Implement AuthController
|
|
106
106
|
*
|
|
107
107
|
* Requirements:
|
|
@@ -110,7 +110,7 @@ Create `.vscode/sce.code-snippets`:
|
|
|
110
110
|
* - Return JWT token on success
|
|
111
111
|
* - Return error on failure
|
|
112
112
|
*
|
|
113
|
-
* Design: See .
|
|
113
|
+
* Design: See .sce/specs/01-00-user-login/design.md#authcontroller
|
|
114
114
|
*/
|
|
115
115
|
class AuthController {
|
|
116
116
|
// Start typing, Copilot will suggest based on comments and Spec files
|
|
@@ -120,7 +120,7 @@ class AuthController {
|
|
|
120
120
|
|
|
121
121
|
**Copilot reads:**
|
|
122
122
|
- Your comments
|
|
123
|
-
- Spec files in `.
|
|
123
|
+
- Spec files in `.sce/specs/`
|
|
124
124
|
- Other project files
|
|
125
125
|
|
|
126
126
|
**Copilot suggests:**
|
|
@@ -156,7 +156,7 @@ Please help me implement the AuthController.
|
|
|
156
156
|
```javascript
|
|
157
157
|
/**
|
|
158
158
|
* @file AuthController.js
|
|
159
|
-
* @spec .
|
|
159
|
+
* @spec .sce/specs/01-00-user-login/
|
|
160
160
|
* @task 2.1
|
|
161
161
|
*
|
|
162
162
|
* Implements user authentication according to Spec.
|
|
@@ -184,7 +184,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
|
184
184
|
/**
|
|
185
185
|
* AuthService.js
|
|
186
186
|
*
|
|
187
|
-
* Spec: .
|
|
187
|
+
* Spec: .sce/specs/01-00-user-login/
|
|
188
188
|
* Task: 2.2 - Implement AuthService
|
|
189
189
|
*
|
|
190
190
|
* Methods to implement:
|
|
@@ -251,7 +251,7 @@ function validateEmail(email) {
|
|
|
251
251
|
### 2. Reference Spec Files
|
|
252
252
|
|
|
253
253
|
```javascript
|
|
254
|
-
// See: .
|
|
254
|
+
// See: .sce/specs/01-00-user-login/design.md#api-design
|
|
255
255
|
```
|
|
256
256
|
|
|
257
257
|
Copilot can read the referenced file.
|
|
@@ -260,7 +260,7 @@ Copilot can read the referenced file.
|
|
|
260
260
|
|
|
261
261
|
```typescript
|
|
262
262
|
/**
|
|
263
|
-
* Spec: .
|
|
263
|
+
* Spec: .sce/specs/01-00-user-login/
|
|
264
264
|
* Task: 2.2
|
|
265
265
|
*/
|
|
266
266
|
interface User {
|
|
@@ -298,7 +298,7 @@ For complex implementations, use Copilot Chat with exported context.
|
|
|
298
298
|
```javascript
|
|
299
299
|
/**
|
|
300
300
|
* AuthService Tests
|
|
301
|
-
* Spec: .
|
|
301
|
+
* Spec: .sce/specs/01-00-user-login/
|
|
302
302
|
*
|
|
303
303
|
* Test cases from acceptance criteria:
|
|
304
304
|
* - AC-1: Valid credentials return user
|
|
@@ -314,7 +314,7 @@ describe('AuthService', () => {
|
|
|
314
314
|
```javascript
|
|
315
315
|
/**
|
|
316
316
|
* Related files:
|
|
317
|
-
* - .
|
|
317
|
+
* - .sce/specs/01-00-user-login/design.md
|
|
318
318
|
* - src/models/User.js
|
|
319
319
|
* - src/services/ValidationService.js
|
|
320
320
|
*/
|
|
@@ -326,7 +326,7 @@ Copilot considers all referenced files.
|
|
|
326
326
|
|
|
327
327
|
```javascript
|
|
328
328
|
// TODO: Implement according to Spec task 2.2.1
|
|
329
|
-
// See: .
|
|
329
|
+
// See: .sce/specs/01-00-user-login/design.md#authservice
|
|
330
330
|
|
|
331
331
|
// Copilot suggests implementation when you start typing
|
|
332
332
|
```
|
|
@@ -371,13 +371,13 @@ Copilot considers all referenced files.
|
|
|
371
371
|
```javascript
|
|
372
372
|
/**
|
|
373
373
|
* Detailed description of what this should do
|
|
374
|
-
* Reference: .
|
|
374
|
+
* Reference: .sce/specs/01-00-user-login/design.md
|
|
375
375
|
*/
|
|
376
376
|
```
|
|
377
377
|
|
|
378
378
|
**Solution 2:** Ensure Spec files are in workspace
|
|
379
379
|
- Copilot only reads files in open workspace
|
|
380
|
-
- Make sure `.
|
|
380
|
+
- Make sure `.sce/specs/` is included
|
|
381
381
|
|
|
382
382
|
### Issue: Suggestions don't match design
|
|
383
383
|
|
|
@@ -47,7 +47,7 @@ You: "Implement the user login feature using sce"
|
|
|
47
47
|
|
|
48
48
|
Windsurf:
|
|
49
49
|
[Executes] sce context export 01-00-user-login
|
|
50
|
-
[Reads] .
|
|
50
|
+
[Reads] .sce/specs/01-00-user-login/context-export.md
|
|
51
51
|
[Implements] Code according to design
|
|
52
52
|
[Updates] tasks.md with completed tasks
|
|
53
53
|
```
|
|
@@ -98,9 +98,9 @@ This project uses sce (Scene Capability Engine) for spec-driven development.
|
|
|
98
98
|
|
|
99
99
|
When user asks to implement a feature:
|
|
100
100
|
1. Run `sce context export <spec-name>`
|
|
101
|
-
2. Read `.
|
|
101
|
+
2. Read `.sce/specs/<spec-name>/context-export.md`
|
|
102
102
|
3. Implement according to design
|
|
103
|
-
4. Update `.
|
|
103
|
+
4. Update `.sce/specs/<spec-name>/tasks.md` (change [ ] to [x])
|
|
104
104
|
|
|
105
105
|
## Example
|
|
106
106
|
|
|
@@ -140,7 +140,7 @@ Windsurf:
|
|
|
140
140
|
[Executes] sce context export 01-00-user-login
|
|
141
141
|
[Output] Context exported to context-export.md
|
|
142
142
|
|
|
143
|
-
[Reads] .
|
|
143
|
+
[Reads] .sce/specs/01-00-user-login/context-export.md
|
|
144
144
|
|
|
145
145
|
[Analyzes] Requirements, Design, Tasks
|
|
146
146
|
|
|
@@ -208,7 +208,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
|
208
208
|
|
|
209
209
|
**2. Tell Windsurf**
|
|
210
210
|
```
|
|
211
|
-
You: "I've created a Spec for user login at .
|
|
211
|
+
You: "I've created a Spec for user login at .sce/specs/01-00-user-login/
|
|
212
212
|
|
|
213
213
|
Please:
|
|
214
214
|
1. Use sce to export the context
|
|
@@ -337,7 +337,7 @@ sce watch start
|
|
|
337
337
|
|
|
338
338
|
**Solution:** Be explicit:
|
|
339
339
|
```
|
|
340
|
-
"After completing task 1.1, edit .
|
|
340
|
+
"After completing task 1.1, edit .sce/specs/01-00-user-login/tasks.md and change:
|
|
341
341
|
- [ ] 1.1 Task name
|
|
342
342
|
to:
|
|
343
343
|
- [x] 1.1 Task name"
|
package/docs/troubleshooting.md
CHANGED
|
@@ -192,11 +192,11 @@ sce upgrade
|
|
|
192
192
|
**If you want to start fresh:**
|
|
193
193
|
```bash
|
|
194
194
|
# Backup existing Specs
|
|
195
|
-
cp -r .
|
|
195
|
+
cp -r .sce .sce.backup
|
|
196
196
|
|
|
197
197
|
# Remove sce
|
|
198
198
|
rm sce.json
|
|
199
|
-
rm -rf .
|
|
199
|
+
rm -rf .sce
|
|
200
200
|
|
|
201
201
|
# Re-adopt
|
|
202
202
|
sce adopt
|
|
@@ -204,12 +204,12 @@ sce adopt
|
|
|
204
204
|
|
|
205
205
|
---
|
|
206
206
|
|
|
207
|
-
### Error: "Permission denied creating .
|
|
207
|
+
### Error: "Permission denied creating .sce directory"
|
|
208
208
|
|
|
209
209
|
**Symptoms:**
|
|
210
210
|
```bash
|
|
211
211
|
$ sce adopt
|
|
212
|
-
Error: EACCES: permission denied, mkdir '.
|
|
212
|
+
Error: EACCES: permission denied, mkdir '.sce'
|
|
213
213
|
```
|
|
214
214
|
|
|
215
215
|
**Cause:** Insufficient permissions in project directory
|
|
@@ -240,7 +240,7 @@ sce adopt
|
|
|
240
240
|
**Symptoms:**
|
|
241
241
|
```bash
|
|
242
242
|
$ sce status
|
|
243
|
-
No Specs found in .
|
|
243
|
+
No Specs found in .sce/specs/
|
|
244
244
|
```
|
|
245
245
|
|
|
246
246
|
**Cause:** No Specs have been created yet
|
|
@@ -254,7 +254,7 @@ sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
|
254
254
|
|
|
255
255
|
**Or check if Specs exist:**
|
|
256
256
|
```bash
|
|
257
|
-
ls -la .
|
|
257
|
+
ls -la .sce/specs/
|
|
258
258
|
```
|
|
259
259
|
|
|
260
260
|
---
|
|
@@ -299,7 +299,7 @@ Error: Failed to export context
|
|
|
299
299
|
**1. Spec doesn't exist:**
|
|
300
300
|
```bash
|
|
301
301
|
# Check Spec exists
|
|
302
|
-
ls .
|
|
302
|
+
ls .sce/specs/01-00-user-login/
|
|
303
303
|
|
|
304
304
|
# If not, create it
|
|
305
305
|
sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
@@ -308,19 +308,19 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
|
308
308
|
**2. Missing Spec files:**
|
|
309
309
|
```bash
|
|
310
310
|
# Spec needs at least requirements.md
|
|
311
|
-
ls .
|
|
311
|
+
ls .sce/specs/01-00-user-login/requirements.md
|
|
312
312
|
|
|
313
313
|
# Create if missing
|
|
314
|
-
touch .
|
|
314
|
+
touch .sce/specs/01-00-user-login/requirements.md
|
|
315
315
|
```
|
|
316
316
|
|
|
317
317
|
**3. File permission issues:**
|
|
318
318
|
```bash
|
|
319
319
|
# Check permissions
|
|
320
|
-
ls -la .
|
|
320
|
+
ls -la .sce/specs/01-00-user-login/
|
|
321
321
|
|
|
322
322
|
# Fix if needed
|
|
323
|
-
chmod 644 .
|
|
323
|
+
chmod 644 .sce/specs/01-00-user-login/*.md
|
|
324
324
|
```
|
|
325
325
|
|
|
326
326
|
---
|
|
@@ -339,7 +339,7 @@ Error: Task 1.1 not found in tasks.md
|
|
|
339
339
|
|
|
340
340
|
**Check tasks.md:**
|
|
341
341
|
```bash
|
|
342
|
-
cat .
|
|
342
|
+
cat .sce/specs/01-00-user-login/tasks.md
|
|
343
343
|
```
|
|
344
344
|
|
|
345
345
|
**Verify task ID format:**
|
|
@@ -377,7 +377,7 @@ attention to the API design and error handling sections."
|
|
|
377
377
|
**2. Verify context was provided:**
|
|
378
378
|
```bash
|
|
379
379
|
# Check context file exists and has content
|
|
380
|
-
cat .
|
|
380
|
+
cat .sce/specs/01-00-user-login/context-export.md
|
|
381
381
|
|
|
382
382
|
# Should contain requirements, design, and tasks
|
|
383
383
|
```
|
|
@@ -740,7 +740,7 @@ $ sce docs validate --spec my-spec
|
|
|
740
740
|
**1. File in wrong location:**
|
|
741
741
|
```bash
|
|
742
742
|
# Check exact path
|
|
743
|
-
ls -la .
|
|
743
|
+
ls -la .sce/specs/my-spec/requirements.md
|
|
744
744
|
|
|
745
745
|
# Should be directly in Spec directory, not in subdirectory
|
|
746
746
|
```
|
|
@@ -748,7 +748,7 @@ ls -la .kiro/specs/my-spec/requirements.md
|
|
|
748
748
|
**2. Wrong Spec name:**
|
|
749
749
|
```bash
|
|
750
750
|
# Check Spec directory name
|
|
751
|
-
ls .
|
|
751
|
+
ls .sce/specs/
|
|
752
752
|
|
|
753
753
|
# Use exact name
|
|
754
754
|
sce docs validate --spec 01-00-my-feature
|
|
@@ -780,7 +780,7 @@ $ sce docs diagnose
|
|
|
780
780
|
**1. Verify configuration was saved:**
|
|
781
781
|
```bash
|
|
782
782
|
# Check config file
|
|
783
|
-
cat .
|
|
783
|
+
cat .sce/config/docs.json
|
|
784
784
|
|
|
785
785
|
# Should show your changes
|
|
786
786
|
```
|
|
@@ -872,7 +872,7 @@ sce docs stats
|
|
|
872
872
|
**Symptoms:**
|
|
873
873
|
```bash
|
|
874
874
|
$ sce docs report
|
|
875
|
-
Error: ENOENT: no such file or directory, open '.
|
|
875
|
+
Error: ENOENT: no such file or directory, open '.sce/reports/...'
|
|
876
876
|
```
|
|
877
877
|
|
|
878
878
|
**Cause:** Reports directory doesn't exist
|
|
@@ -881,7 +881,7 @@ Error: ENOENT: no such file or directory, open '.kiro/reports/...'
|
|
|
881
881
|
|
|
882
882
|
**Create reports directory:**
|
|
883
883
|
```bash
|
|
884
|
-
mkdir -p .
|
|
884
|
+
mkdir -p .sce/reports
|
|
885
885
|
|
|
886
886
|
# Try again
|
|
887
887
|
sce docs report
|
|
@@ -922,10 +922,10 @@ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
|
|
922
922
|
**Solution:**
|
|
923
923
|
```bash
|
|
924
924
|
# ❌ Wrong on Windows
|
|
925
|
-
sce context export .
|
|
925
|
+
sce context export .sce/specs/01-00-user-login
|
|
926
926
|
|
|
927
927
|
# ✅ Correct on Windows
|
|
928
|
-
sce context export .
|
|
928
|
+
sce context export .sce\specs\01-00-user-login
|
|
929
929
|
|
|
930
930
|
# ✅ Or use forward slashes (sce handles both)
|
|
931
931
|
sce context export 01-00-user-login
|
|
@@ -1024,7 +1024,7 @@ uname -a # macOS/Linux
|
|
|
1024
1024
|
ver # Windows
|
|
1025
1025
|
|
|
1026
1026
|
# Current directory structure
|
|
1027
|
-
ls -la .
|
|
1027
|
+
ls -la .sce/
|
|
1028
1028
|
```
|
|
1029
1029
|
|
|
1030
1030
|
### Where to Get Help
|
|
@@ -1114,7 +1114,7 @@ sce watch stop && sce watch start
|
|
|
1114
1114
|
sce --version
|
|
1115
1115
|
|
|
1116
1116
|
# Check Spec structure
|
|
1117
|
-
ls -la .
|
|
1117
|
+
ls -la .sce/specs/
|
|
1118
1118
|
|
|
1119
1119
|
# Test context export
|
|
1120
1120
|
sce context export spec-name
|
package/docs/upgrade-guide.md
CHANGED
|
@@ -350,7 +350,7 @@ module.exports = {
|
|
|
350
350
|
const changes = [];
|
|
351
351
|
|
|
352
352
|
// Example: Create backups directory
|
|
353
|
-
await ensureDirectory(path.join(projectPath, '.
|
|
353
|
+
await ensureDirectory(path.join(projectPath, '.sce/backups'));
|
|
354
354
|
changes.push('Created backups/ directory');
|
|
355
355
|
|
|
356
356
|
return { success: true, changes };
|
|
@@ -456,8 +456,8 @@ sce rollback
|
|
|
456
456
|
df -h
|
|
457
457
|
|
|
458
458
|
# Clean old backups
|
|
459
|
-
ls .
|
|
460
|
-
rm -rf .
|
|
459
|
+
ls .sce/backups/
|
|
460
|
+
rm -rf .sce/backups/old-backup-id
|
|
461
461
|
|
|
462
462
|
# Try upgrade again
|
|
463
463
|
sce upgrade
|
|
@@ -508,7 +508,7 @@ sce status
|
|
|
508
508
|
sce doctor
|
|
509
509
|
|
|
510
510
|
# Test your specs
|
|
511
|
-
sce enhance requirements .
|
|
511
|
+
sce enhance requirements .sce/specs/your-spec/requirements.md
|
|
512
512
|
```
|
|
513
513
|
|
|
514
514
|
### 3. Keep Upgrade History
|
|
@@ -516,7 +516,7 @@ sce enhance requirements .kiro/specs/your-spec/requirements.md
|
|
|
516
516
|
Don't delete backups immediately:
|
|
517
517
|
```bash
|
|
518
518
|
# Keep last 5 backups
|
|
519
|
-
ls -lt .
|
|
519
|
+
ls -lt .sce/backups/ | head -6
|
|
520
520
|
```
|
|
521
521
|
|
|
522
522
|
### 4. Read Release Notes
|
|
@@ -581,8 +581,8 @@ sce rollback
|
|
|
581
581
|
If automatic rollback fails:
|
|
582
582
|
|
|
583
583
|
```bash
|
|
584
|
-
# Backups are in .
|
|
585
|
-
cd .
|
|
584
|
+
# Backups are in .sce/backups/
|
|
585
|
+
cd .sce/backups/
|
|
586
586
|
|
|
587
587
|
# Find the upgrade backup
|
|
588
588
|
ls -lt
|
|
@@ -621,7 +621,7 @@ After successful upgrade:
|
|
|
621
621
|
5. **Clean old backups** (optional):
|
|
622
622
|
```bash
|
|
623
623
|
# Keep last 3 backups
|
|
624
|
-
ls .
|
|
624
|
+
ls .sce/backups/
|
|
625
625
|
```
|
|
626
626
|
|
|
627
627
|
---
|
|
@@ -65,8 +65,8 @@ If you do not use the `sample` command, create `kpi-input.json` manually:
|
|
|
65
65
|
"triggered_metrics": [
|
|
66
66
|
"manual_takeover_rate"
|
|
67
67
|
],
|
|
68
|
-
"snapshot_path": ".
|
|
69
|
-
"gate_summary_path": ".
|
|
68
|
+
"snapshot_path": ".sce/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/2026-W10.json",
|
|
69
|
+
"gate_summary_path": ".sce/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/gate-summary.2026-W10.day-60.json",
|
|
70
70
|
"contract_path": "metric-definition.yaml"
|
|
71
71
|
}
|
|
72
72
|
```
|
|
@@ -96,7 +96,7 @@ If you do not use the `sample` command, create `kpi-input.json` manually:
|
|
|
96
96
|
"target_passed": true
|
|
97
97
|
}
|
|
98
98
|
],
|
|
99
|
-
"trend_path": ".
|
|
99
|
+
"trend_path": ".sce/specs/114-00-kpi-automation-and-observability/custom/weekly-metrics/trend.latest.json"
|
|
100
100
|
}
|
|
101
101
|
```
|
|
102
102
|
|
package/docs/zh/README.md
CHANGED
|
@@ -199,6 +199,12 @@
|
|
|
199
199
|
### [SCE 能力矩阵端到端示例](../sce-capability-matrix-e2e-example.md)
|
|
200
200
|
**端到端流程示例(英文)** - 从策略决策到符号证据、失败修复、能力映射和主从摘要合并阻断
|
|
201
201
|
|
|
202
|
+
### [SCE 业务模式能力地图](../sce-business-mode-map.md)
|
|
203
|
+
**三态执行治理(英文)** - 用户态 / 运维态 / 开发态的默认接管、授权门禁与审计要求
|
|
204
|
+
|
|
205
|
+
### [Business Mode Policy Baseline](../interactive-customization/business-mode-policy-baseline.json)
|
|
206
|
+
**三态策略基线(英文 JSON)** - `user-mode / ops-mode / dev-mode` 的可执行预设映射
|
|
207
|
+
|
|
202
208
|
### [Handoff Profile Integration Guide](../handoff-profile-integration-guide.md)
|
|
203
209
|
**外部项目接入规范(英文)** - `default|moqui|enterprise` 三档 handoff profile 契约
|
|
204
210
|
- profile 默认策略与显式参数覆盖规则
|
package/docs/zh/quick-start.md
CHANGED
|
@@ -96,7 +96,7 @@ sce adopt
|
|
|
96
96
|
**预期输出:**
|
|
97
97
|
```
|
|
98
98
|
✓ 检测到项目类型:Node.js
|
|
99
|
-
✓ 创建 .
|
|
99
|
+
✓ 创建 .sce/ 目录
|
|
100
100
|
✓ 创建 specs/ 目录
|
|
101
101
|
✓ 创建 steering/ 目录
|
|
102
102
|
✓ 生成 CORE_PRINCIPLES.md
|
|
@@ -107,13 +107,13 @@ sce adopt
|
|
|
107
107
|
|
|
108
108
|
下一步:
|
|
109
109
|
1. 创建你的第一个 Spec:sce spec bootstrap --name 01-00-my-feature --non-interactive
|
|
110
|
-
2. 阅读指南:.
|
|
110
|
+
2. 阅读指南:.sce/README.md
|
|
111
111
|
```
|
|
112
112
|
|
|
113
113
|
**创建的内容:**
|
|
114
114
|
```
|
|
115
115
|
your-project/
|
|
116
|
-
├── .
|
|
116
|
+
├── .sce/
|
|
117
117
|
│ ├── specs/ # 你的 Spec 将存放在这里
|
|
118
118
|
│ ├── steering/ # AI 行为规则
|
|
119
119
|
│ │ ├── CORE_PRINCIPLES.md
|
|
@@ -198,7 +198,7 @@ sce value metrics snapshot --input ./kpi-input.json --json
|
|
|
198
198
|
|
|
199
199
|
### 3.1 编写需求
|
|
200
200
|
|
|
201
|
-
打开 `.
|
|
201
|
+
打开 `.sce/specs/01-00-user-login/requirements.md` 并编写:
|
|
202
202
|
|
|
203
203
|
```markdown
|
|
204
204
|
# 用户登录功能
|
|
@@ -271,7 +271,7 @@ sce value metrics snapshot --input ./kpi-input.json --json
|
|
|
271
271
|
|
|
272
272
|
### 3.2 编写设计
|
|
273
273
|
|
|
274
|
-
打开 `.
|
|
274
|
+
打开 `.sce/specs/01-00-user-login/design.md` 并编写:
|
|
275
275
|
|
|
276
276
|
```markdown
|
|
277
277
|
# 用户登录 - 设计文档
|
|
@@ -430,7 +430,7 @@ graph TD
|
|
|
430
430
|
|
|
431
431
|
### 3.3 编写任务
|
|
432
432
|
|
|
433
|
-
打开 `.
|
|
433
|
+
打开 `.sce/specs/01-00-user-login/tasks.md` 并编写:
|
|
434
434
|
|
|
435
435
|
```markdown
|
|
436
436
|
# 用户登录 - 实现任务
|
|
@@ -535,13 +535,13 @@ sce context export 01-00-user-login
|
|
|
535
535
|
|
|
536
536
|
**预期输出:**
|
|
537
537
|
```
|
|
538
|
-
✓ 上下文已导出到 .
|
|
538
|
+
✓ 上下文已导出到 .sce/specs/01-00-user-login/context-export.md
|
|
539
539
|
✓ 上下文大小:3.2 KB
|
|
540
540
|
✓ 准备好与 AI 工具一起使用
|
|
541
541
|
```
|
|
542
542
|
|
|
543
543
|
**创建的内容:**
|
|
544
|
-
位于 `.
|
|
544
|
+
位于 `.sce/specs/01-00-user-login/context-export.md` 的文件,包含:
|
|
545
545
|
- 所有需求
|
|
546
546
|
- 完整设计
|
|
547
547
|
- 任务列表
|
|
@@ -559,13 +559,13 @@ sce context export 01-00-user-login
|
|
|
559
559
|
1. **打开上下文文件:**
|
|
560
560
|
```bash
|
|
561
561
|
# macOS
|
|
562
|
-
cat .
|
|
562
|
+
cat .sce/specs/01-00-user-login/context-export.md | pbcopy
|
|
563
563
|
|
|
564
564
|
# Windows
|
|
565
|
-
type .
|
|
565
|
+
type .sce\specs\01-00-user-login\context-export.md | clip
|
|
566
566
|
|
|
567
567
|
# Linux
|
|
568
|
-
cat .
|
|
568
|
+
cat .sce/specs/01-00-user-login/context-export.md | xclip -selection clipboard
|
|
569
569
|
```
|
|
570
570
|
|
|
571
571
|
2. **开始新对话** 与 Claude 或 ChatGPT
|
|
@@ -617,7 +617,7 @@ sce context export 01-00-user-login
|
|
|
617
617
|
2. **添加引用你的 Spec 的注释:**
|
|
618
618
|
```javascript
|
|
619
619
|
// 任务 1.1:设置项目依赖
|
|
620
|
-
// 参见:.
|
|
620
|
+
// 参见:.sce/specs/01-00-user-login/design.md
|
|
621
621
|
//
|
|
622
622
|
// 安装:express、bcrypt、jsonwebtoken、validator、express-rate-limit
|
|
623
623
|
```
|
|
@@ -633,7 +633,7 @@ sce context export 01-00-user-login
|
|
|
633
633
|
|
|
634
634
|
完成任务后,更新任务状态:
|
|
635
635
|
|
|
636
|
-
**编辑** `.
|
|
636
|
+
**编辑** `.sce/specs/01-00-user-login/tasks.md`:
|
|
637
637
|
|
|
638
638
|
```markdown
|
|
639
639
|
- [x] 1.1 设置项目依赖 ← 从 [ ] 改为 [x]
|
|
@@ -724,9 +724,9 @@ sce prompt generate 01-00-user-login 1.1
|
|
|
724
724
|
### 问题:找不到我的 Spec 文件
|
|
725
725
|
|
|
726
726
|
**解决方案:**
|
|
727
|
-
所有 Spec 都在 `.
|
|
727
|
+
所有 Spec 都在 `.sce/specs/` 中:
|
|
728
728
|
```bash
|
|
729
|
-
ls .
|
|
729
|
+
ls .sce/specs/
|
|
730
730
|
```
|
|
731
731
|
|
|
732
732
|
### 更多帮助
|
|
@@ -118,10 +118,10 @@ git log --oneline -n 15
|
|
|
118
118
|
- 可选:发布资产 0 字节防护(workflow 默认开启)
|
|
119
119
|
- `scripts/release-asset-nonempty-normalize.js` 会在上传 GitHub Release 资产前,为可选 `.lines` / `.jsonl` 资产自动补齐占位内容,避免 422。
|
|
120
120
|
- 本地 dry-run 示例:
|
|
121
|
-
- `node scripts/release-asset-nonempty-normalize.js --file .
|
|
121
|
+
- `node scripts/release-asset-nonempty-normalize.js --file .sce/reports/release-evidence/matrix-remediation-vX.Y.Z.lines --kind lines --note "no matrix remediation items for this release" --dry-run --json`
|
|
122
122
|
- 本地规范化示例:
|
|
123
|
-
- `node scripts/release-asset-nonempty-normalize.js --file .
|
|
123
|
+
- `node scripts/release-asset-nonempty-normalize.js --file .sce/reports/release-evidence/interactive-matrix-signals-vX.Y.Z.jsonl --kind jsonl --event interactive-matrix-signals --note "No interactive matrix signals collected for this release." --json`
|
|
124
124
|
- 可选本地预演 release gate 历史索引产物:
|
|
125
|
-
- `sce auto handoff gate-index --dir .
|
|
125
|
+
- `sce auto handoff gate-index --dir .sce/reports/release-evidence --out .sce/reports/release-evidence/release-gate-history.json --json`
|
|
126
126
|
|
|
127
127
|
然后再执行你的正式发布流程(打 tag、push、npm publish、GitHub Release)。
|
|
@@ -49,6 +49,16 @@
|
|
|
49
49
|
- 已全局安装 **sce**(`npm install -g scene-capability-engine`)
|
|
50
50
|
- 项目已被 sce **采用**(`sce adopt`)
|
|
51
51
|
|
|
52
|
+
### 推荐 Claude 启动模式
|
|
53
|
+
|
|
54
|
+
当 Claude 与 sce 的自治流程配合使用时,建议使用全权限启动模式:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
claude --dangerously-skip-permission
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
这可与 sce 编排子 agent 的默认权限策略保持一致(`danger-full-access` + 无审批拦截)。
|
|
61
|
+
|
|
52
62
|
### 无需特殊设置
|
|
53
63
|
|
|
54
64
|
Claude 通过 Web 界面工作,无需特殊配置。只需导出上下文并粘贴!
|
|
@@ -71,13 +81,13 @@ Claude 通过 Web 界面工作,无需特殊配置。只需导出上下文并
|
|
|
71
81
|
2. **复制上下文到剪贴板:**
|
|
72
82
|
```bash
|
|
73
83
|
# macOS
|
|
74
|
-
cat .
|
|
84
|
+
cat .sce/specs/01-00-user-login/context-export.md | pbcopy
|
|
75
85
|
|
|
76
86
|
# Windows
|
|
77
|
-
type .
|
|
87
|
+
type .sce\specs\01-00-user-login\context-export.md | clip
|
|
78
88
|
|
|
79
89
|
# Linux
|
|
80
|
-
cat .
|
|
90
|
+
cat .sce/specs/01-00-user-login/context-export.md | xclip -selection clipboard
|
|
81
91
|
```
|
|
82
92
|
|
|
83
93
|
3. **开始新的 Claude 对话**
|
|
@@ -135,7 +145,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
|
135
145
|
|
|
136
146
|
# 3. 导出并复制上下文
|
|
137
147
|
sce context export 01-00-user-login
|
|
138
|
-
cat .
|
|
148
|
+
cat .sce/specs/01-00-user-login/context-export.md | pbcopy
|
|
139
149
|
|
|
140
150
|
# 4. 在 Claude 中:
|
|
141
151
|
# - 粘贴上下文
|
|
@@ -230,7 +240,7 @@ Claude 擅长解释。询问:
|
|
|
230
240
|
### 调试问题
|
|
231
241
|
|
|
232
242
|
```
|
|
233
|
-
我正在实现 .
|
|
243
|
+
我正在实现 .sce/specs/01-00-user-login/ 中的用户登录功能。
|
|
234
244
|
|
|
235
245
|
任务 2.1(ValidationService)已完成,但测试失败并出现此错误:
|
|
236
246
|
[粘贴错误消息]
|
|
@@ -244,7 +254,7 @@ Claude 擅长解释。询问:
|
|
|
244
254
|
### 代码审查
|
|
245
255
|
|
|
246
256
|
```
|
|
247
|
-
我已实现 .
|
|
257
|
+
我已实现 .sce/specs/01-00-user-login/ 中的任务 1.1-1.3。
|
|
248
258
|
|
|
249
259
|
这是我的代码:
|
|
250
260
|
[粘贴代码]
|
|
@@ -58,10 +58,10 @@
|
|
|
58
58
|
此项目使用 sce (Scene Capability Engine) 进行规范驱动开发。
|
|
59
59
|
|
|
60
60
|
## Spec 位置
|
|
61
|
-
所有 Spec 都在 `.
|
|
61
|
+
所有 Spec 都在 `.sce/specs/` 目录中。
|
|
62
62
|
|
|
63
63
|
## 实现功能前
|
|
64
|
-
1. 检查 `.
|
|
64
|
+
1. 检查 `.sce/specs/` 中是否存在 Spec
|
|
65
65
|
2. 阅读 requirements.md、design.md 和 tasks.md
|
|
66
66
|
3. 严格遵循设计架构
|
|
67
67
|
4. 完成任务时更新 tasks.md
|
|
@@ -73,9 +73,9 @@
|
|
|
73
73
|
|
|
74
74
|
## 示例
|
|
75
75
|
对于用户登录功能:
|
|
76
|
-
- Spec:`.
|
|
77
|
-
- 设计:`.
|
|
78
|
-
- 任务:`.
|
|
76
|
+
- Spec:`.sce/specs/01-00-user-login/`
|
|
77
|
+
- 设计:`.sce/specs/01-00-user-login/design.md`
|
|
78
|
+
- 任务:`.sce/specs/01-00-user-login/tasks.md`
|
|
79
79
|
|
|
80
80
|
## 代码标准
|
|
81
81
|
[在此添加项目特定的编码标准]
|
|
@@ -102,7 +102,7 @@
|
|
|
102
102
|
|
|
103
103
|
3. **提供上下文:**
|
|
104
104
|
```
|
|
105
|
-
我已在 .
|
|
105
|
+
我已在 .sce/specs/01-00-user-login/ 中创建了用户登录功能的完整 Spec。
|
|
106
106
|
|
|
107
107
|
请阅读:
|
|
108
108
|
- requirements.md(需求)
|
|
@@ -155,7 +155,7 @@
|
|
|
155
155
|
1. **在文件顶部添加上下文注释:**
|
|
156
156
|
```javascript
|
|
157
157
|
// 任务 1.1:设置项目依赖
|
|
158
|
-
// Spec:.
|
|
158
|
+
// Spec:.sce/specs/01-00-user-login/
|
|
159
159
|
// 设计:参见 design.md 中的 AuthController
|
|
160
160
|
|
|
161
161
|
// 实现 AuthController 类...
|
|
@@ -181,7 +181,7 @@ sce spec bootstrap --name 01-00-user-login --non-interactive
|
|
|
181
181
|
sce context export 01-00-user-login
|
|
182
182
|
|
|
183
183
|
# 4. 在 Cursor Composer 中(Cmd+K):
|
|
184
|
-
"请实现 .
|
|
184
|
+
"请实现 .sce/specs/01-00-user-login/ 中的任务 1.1"
|
|
185
185
|
|
|
186
186
|
# 5. 审查并接受更改
|
|
187
187
|
|
|
@@ -226,7 +226,7 @@ sce prompt generate 01-00-user-login 1.1
|
|
|
226
226
|
|
|
227
227
|
在 Composer 中,使用 `@` 引用特定文件:
|
|
228
228
|
```
|
|
229
|
-
@.
|
|
229
|
+
@.sce/specs/01-00-user-login/design.md
|
|
230
230
|
请实现 AuthController,如设计文档中所述
|
|
231
231
|
```
|
|
232
232
|
|
|
@@ -253,9 +253,9 @@ sce prompt generate 01-00-user-login 1.1
|
|
|
253
253
|
### 问题:Cursor 看不到我的 Spec 文件
|
|
254
254
|
|
|
255
255
|
**解决方案:**
|
|
256
|
-
1. 确保文件在 `.
|
|
256
|
+
1. 确保文件在 `.sce/specs/` 中
|
|
257
257
|
2. 在 Composer 中使用 @-mentions
|
|
258
|
-
3. 检查 `.cursorignore` 是否排除了 `.
|
|
258
|
+
3. 检查 `.cursorignore` 是否排除了 `.sce/`
|
|
259
259
|
|
|
260
260
|
---
|
|
261
261
|
|