scene-capability-engine 3.6.64 → 3.6.67

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +17 -6
  3. package/README.zh.md +18 -6
  4. package/bin/scene-capability-engine.js +4 -0
  5. package/docs/README.md +2 -2
  6. package/docs/command-reference.md +385 -8
  7. package/docs/document-governance.md +3 -2
  8. package/docs/integration-modes.md +62 -478
  9. package/docs/integration-philosophy.md +56 -263
  10. package/docs/magicball-cli-invocation-examples.md +1 -0
  11. package/docs/magicball-project-portfolio-contract.md +125 -4
  12. package/docs/project-management/README.md +14 -0
  13. package/docs/project-management/assurance/backup.md +3 -0
  14. package/docs/project-management/assurance/config.md +3 -0
  15. package/docs/project-management/assurance/evidence/README.md +3 -0
  16. package/docs/project-management/assurance/incidents/README.md +3 -0
  17. package/docs/project-management/assurance/logs.md +3 -0
  18. package/docs/project-management/assurance/overview.md +3 -0
  19. package/docs/project-management/assurance/recovery/README.md +3 -0
  20. package/docs/project-management/assurance/resource.md +3 -0
  21. package/docs/project-management/assurance/runbooks/README.md +3 -0
  22. package/docs/project-management/delivery/acceptance/README.md +3 -0
  23. package/docs/project-management/delivery/acceptance/evidence/README.md +3 -0
  24. package/docs/project-management/delivery/acceptance/exceptions/README.md +3 -0
  25. package/docs/project-management/delivery/acceptance/reports/README.md +3 -0
  26. package/docs/project-management/delivery/documents/changes.md +3 -0
  27. package/docs/project-management/delivery/documents/issues.md +3 -0
  28. package/docs/project-management/delivery/documents/overview.md +3 -0
  29. package/docs/project-management/delivery/documents/planning.md +3 -0
  30. package/docs/project-management/delivery/documents/requirements.md +3 -0
  31. package/docs/project-management/delivery/documents/tracking.md +3 -0
  32. package/docs/project-management/delivery/handoffs/README.md +3 -0
  33. package/docs/project-management/delivery/handoffs/evidence/README.md +3 -0
  34. package/docs/project-management/delivery/handoffs/records/README.md +3 -0
  35. package/docs/project-management/delivery/overview.md +10 -0
  36. package/docs/project-management/delivery/releases/README.md +3 -0
  37. package/docs/project-management/delivery/releases/baselines/README.md +3 -0
  38. package/docs/project-management/delivery/releases/evidence/README.md +3 -0
  39. package/docs/project-management/delivery/tables/changes.md +3 -0
  40. package/docs/project-management/delivery/tables/issues.md +3 -0
  41. package/docs/project-management/delivery/tables/planning.md +3 -0
  42. package/docs/project-management/delivery/tables/requirements.md +3 -0
  43. package/docs/project-management/delivery/tables/tracking.md +3 -0
  44. package/docs/project-management/environment/agent-discovery.md +3 -0
  45. package/docs/project-management/environment/development.md +3 -0
  46. package/docs/project-management/environment/overview.md +10 -0
  47. package/docs/project-management/environment/testing.md +3 -0
  48. package/docs/project-management/environment/version-alignment.md +3 -0
  49. package/docs/quick-start-with-ai-tools.md +68 -308
  50. package/docs/releases/README.md +3 -0
  51. package/docs/releases/v3.6.65.md +25 -0
  52. package/docs/releases/v3.6.66.md +23 -0
  53. package/docs/releases/v3.6.67.md +23 -0
  54. package/docs/steering-governance.md +64 -2
  55. package/docs/zh/README.md +2 -2
  56. package/docs/zh/releases/README.md +3 -0
  57. package/docs/zh/releases/v3.6.65.md +25 -0
  58. package/docs/zh/releases/v3.6.66.md +23 -0
  59. package/docs/zh/releases/v3.6.67.md +23 -0
  60. package/lib/commands/adopt.js +24 -0
  61. package/lib/commands/native.js +158 -0
  62. package/lib/commands/project.js +96 -0
  63. package/lib/commands/semantic.js +1459 -0
  64. package/lib/commands/session.js +74 -3
  65. package/lib/commands/spec-bootstrap.js +10 -1
  66. package/lib/commands/spec-gate.js +10 -1
  67. package/lib/commands/spec-pipeline.js +10 -1
  68. package/lib/commands/studio.js +405 -30
  69. package/lib/commands/task.js +141 -7
  70. package/lib/governance/supreme-principles.js +530 -0
  71. package/lib/problem/problem-evaluator.js +4 -0
  72. package/lib/project/candidate-inspection-service.js +24 -1
  73. package/lib/project/portfolio-projection-service.js +315 -5
  74. package/lib/project/project-channel-output.js +94 -0
  75. package/lib/project/project-channel-projection.js +181 -0
  76. package/lib/project/root-onboarding-service.js +107 -7
  77. package/lib/project/semantic-shared-source-projection.js +150 -0
  78. package/lib/project/supervision-action-model.js +277 -0
  79. package/lib/project/supervision-projection-service.js +305 -5
  80. package/lib/project/target-resolution-service.js +70 -5
  81. package/lib/project/visibility-policy.js +93 -0
  82. package/lib/runtime/multi-spec-scene-session.js +8 -1
  83. package/lib/runtime/project-channel-context-store.js +387 -0
  84. package/lib/runtime/project-channel-context.js +406 -0
  85. package/lib/runtime/scene-session-binding.js +46 -0
  86. package/lib/runtime/session-store.js +186 -0
  87. package/lib/runtime/steering-contract.js +7 -1
  88. package/lib/semantic/archive-report.js +283 -0
  89. package/lib/semantic/archive-routing.js +67 -0
  90. package/lib/semantic/backflow-report.js +245 -0
  91. package/lib/semantic/capability-contract.js +30 -0
  92. package/lib/semantic/delta-export.js +145 -0
  93. package/lib/semantic/interaction-observer.js +254 -0
  94. package/lib/semantic/kernel-loader.js +881 -0
  95. package/lib/semantic/native-runtime.js +359 -0
  96. package/lib/semantic/progress-ledger.js +433 -0
  97. package/lib/semantic/replay-evaluator.js +382 -0
  98. package/lib/semantic/shared-publication.js +592 -0
  99. package/lib/semantic/shared-source-config.js +183 -0
  100. package/lib/semantic/shared-source-connect.js +139 -0
  101. package/lib/semantic/shared-source-discovery.js +98 -0
  102. package/lib/semantic/shared-sync-export.js +413 -0
  103. package/lib/semantic/shared-sync-intake.js +592 -0
  104. package/lib/semantic/shared-sync-merge.js +547 -0
  105. package/lib/semantic/shared-sync-release.js +463 -0
  106. package/lib/semantic/supreme-intent-report.js +300 -0
  107. package/lib/state/sce-state-store.js +1360 -0
  108. package/lib/steering/context-sync-manager.js +276 -25
  109. package/lib/studio/spec-intake-governor.js +39 -3
  110. package/lib/studio/task-envelope.js +35 -2
  111. package/lib/workspace/takeover-baseline.js +342 -83
  112. package/package.json +7 -2
  113. package/scripts/agent-governance-baseline-audit.js +395 -0
  114. package/scripts/clarification-first-audit.js +9 -9
  115. package/scripts/deprecated-entry-audit.js +240 -0
  116. package/scripts/release-doc-version-audit.js +24 -0
  117. package/scripts/release-posture-report.js +262 -0
  118. package/template/.sce/README.md +62 -228
  119. package/template/.sce/config/semantic-shared-sources.json +5 -0
  120. package/template/.sce/config/supreme-principles-policy.json +105 -0
  121. package/template/.sce/config/takeover-baseline.json +7 -0
  122. package/template/.sce/steering/CORE_PRINCIPLES.md +23 -63
  123. package/template/.sce/steering/CURRENT_CONTEXT.md +4 -0
  124. package/template/.sce/steering/RULES_GUIDE.md +17 -9
  125. package/template/README.md +32 -96
@@ -0,0 +1,105 @@
1
+ {
2
+ "schema_version": "1.0",
3
+ "enabled": true,
4
+ "allow_planning_actions": [
5
+ "allow",
6
+ "clarify",
7
+ "rewrite",
8
+ "narrow"
9
+ ],
10
+ "allow_execution_actions": [
11
+ "allow",
12
+ "rewrite",
13
+ "narrow"
14
+ ],
15
+ "clarify_question": "请先明确你真正要达成的业务目标、作用对象和约束边界。",
16
+ "refuse_message": "该请求不符合 SCE 的最高道德规范,不能直接执行。",
17
+ "rewrite_message": "原始请求存在失范或越界风险,已收敛为可正当执行的目标。",
18
+ "narrow_message": "原始请求风险过高,已收缩为审查、备份、验证优先的安全目标。",
19
+ "refuse_rules": [
20
+ {
21
+ "id": "credential-theft",
22
+ "keywords": [
23
+ "steal password",
24
+ "dump token",
25
+ "exfiltrate",
26
+ "keylogger",
27
+ "phish",
28
+ "窃取密码",
29
+ "盗取令牌",
30
+ "导出凭证"
31
+ ],
32
+ "reason": "请求明显指向凭证盗取、数据外流或钓鱼等恶意行为。"
33
+ },
34
+ {
35
+ "id": "malware-abuse",
36
+ "keywords": [
37
+ "malware",
38
+ "ransomware",
39
+ "backdoor",
40
+ "payload",
41
+ "木马",
42
+ "勒索软件",
43
+ "后门"
44
+ ],
45
+ "reason": "请求明显指向恶意控制、破坏或持久化投毒。"
46
+ },
47
+ {
48
+ "id": "audit-evasion",
49
+ "keywords": [
50
+ "delete logs to hide",
51
+ "evade audit",
52
+ "disable audit trail",
53
+ "清除日志掩盖",
54
+ "绕过审计",
55
+ "删除审计日志"
56
+ ],
57
+ "reason": "请求明显指向规避责任、破坏审计或掩盖痕迹。"
58
+ }
59
+ ],
60
+ "rewrite_rules": [
61
+ {
62
+ "id": "auth-bypass-to-safe-test-fixture",
63
+ "keywords": [
64
+ "disable auth",
65
+ "bypass auth",
66
+ "skip login",
67
+ "skip approval",
68
+ "关闭认证",
69
+ "绕过认证",
70
+ "跳过登录",
71
+ "跳过审批"
72
+ ],
73
+ "replacement": "Design a dev/test-only mechanism with explicit scope guard, audit trail, rollback plan, and no production bypass of authentication or approval controls.",
74
+ "reason": "将越界的“绕过保护”目标改写为受边界约束的测试/诊断机制。"
75
+ },
76
+ {
77
+ "id": "remove-audit-to-safe-observability",
78
+ "keywords": [
79
+ "remove audit",
80
+ "turn off audit",
81
+ "delete logs",
82
+ "关闭审计",
83
+ "删除日志",
84
+ "去掉审计"
85
+ ],
86
+ "replacement": "Design a safe observability adjustment that preserves required auditability, keeps retention boundaries, and reduces noise without deleting accountability evidence.",
87
+ "reason": "将“去掉审计/日志”改写为保留责任边界的可观测性优化目标。"
88
+ }
89
+ ],
90
+ "narrow_rules": [
91
+ {
92
+ "id": "destructive-production-change",
93
+ "keywords": [
94
+ "drop database",
95
+ "delete production data",
96
+ "truncate table",
97
+ "删除生产数据",
98
+ "清空数据表",
99
+ "删库"
100
+ ],
101
+ "replacement": "Review the destructive change request, produce backup and rollback steps, verify scope, and require explicit confirmation before any irreversible data operation.",
102
+ "reason": "高风险破坏性操作必须先收缩为审查、备份和回滚准备。"
103
+ }
104
+ ]
105
+ }
@@ -112,6 +112,13 @@
112
112
  "max_direct_fix_rounds_before_debug": 2,
113
113
  "forbid_bypass_workarounds": true
114
114
  },
115
+ "semantic_learning": {
116
+ "enabled": true,
117
+ "consent_model": "adopt-implied",
118
+ "auto_publish_qualified_delta": true,
119
+ "publish_on_promotion": true,
120
+ "shared_library_mirror_root": ".sce/knowledge/semantic-shared"
121
+ },
115
122
  "collaboration": {
116
123
  "multi_user_mode": true,
117
124
  "multi_agent": {
@@ -1,70 +1,30 @@
1
- # 核心开发原则(基准规则)
1
+ # 核心开发原则(最高原则)
2
2
 
3
- > 模板只保留长期原则。当前阶段状态写入 `CURRENT_CONTEXT.md`,详细规则写入项目文档。
3
+ > 模板中的 `CORE_PRINCIPLES.md` 只保留能直接决定“该不该做”与“如何把事做对”的最高原则。治理基线写入 `RULES_GUIDE.md`,详细制度与经验写入项目文档或 `.sce/knowledge/lessons/`,当前阶段状态写入 `CURRENT_CONTEXT.md`。
4
4
 
5
- ## 1. 先建 Spec,再动实现
5
+ ## 1. 四句教:先判断该不该做
6
6
 
7
- - 所有需求先进入 `.sce/specs/<spec>/`,再进入设计、任务、实现与验证。
8
- - 产物归档到对应 Spec,避免散落根目录。
7
+ - 世界观:无善无恶心之始。先回到事情本身,识别真实意图、对象、边界和上下文,不把用户表层措辞、情绪或旧标签直接当成结论。
8
+ - 人生观:有善有恶意之动。一旦形成可执行意图,就要判断它导向的是成事、利人、守正,还是伤害、逃责、取巧与失范。
9
+ - 价值观:知善知恶是良知。不是机械服从请求,而是主动承担辨别责任,判断目的、手段、后果和长期影响是否正当。
10
+ - 方法论:为善去恶是格物。落实到具体动作层,不只是拒绝坏事,还要把含混、偏斜或失范的请求收敛、改写成可正当执行的目标。
11
+ - 四句教用于判断用户让 SCE 做的事是否符合最高道德规范;只有通过这道门槛的事项,才允许调用“小九条”进入执行。
9
12
 
10
- ## 2. Steering 只保留长期有效内容
13
+ ## 2. 最高原则只保留四句教 + 小九条
11
14
 
12
- - `CORE_PRINCIPLES.md` 放长期原则。
13
- - `ENVIRONMENT.md` 放项目级运行与发布规则。
14
- - `CURRENT_CONTEXT.md` 放当前阶段最小上下文。
15
- - `RULES_GUIDE.md` 放职责边界与迁移规则。
15
+ - `CORE_PRINCIPLES.md` 只保留能直接决定该不该做、做事方向、判断质量和收敛效率的最高原则,不再堆放执行细则、门禁清单、策略阈值或场景化约束。
16
+ - 长期治理基线写入 `RULES_GUIDE.md`;项目经验、案例、阈值和方法论写入 `docs/steering-governance.md` 或 `.sce/knowledge/lessons/`;当前状态写入 `CURRENT_CONTEXT.md`。
17
+ - 四句教负责先判断“这件事该不该做、是否正当”;小九条负责在目标正当后,判断“这件事如何高质量地做成”。
18
+ - 若某条内容不能直接提升道德判断、目标理解、调查质量、判断质量或闭环效率,就不应继续占用最高原则层。
16
19
 
17
- ## 3. 默认自主闭环推进
20
+ ## 3. 小九条:把正确的事正确地做成
18
21
 
19
- - 默认流程:分析 -> 修改 -> 测试 -> 修复 -> 文档同步 -> 交付。
20
- - 非阻断问题不应频繁等待确认。
21
-
22
- ## 4. 复用已有机制,不要平行造轮子
23
-
24
- - 已有能力优先复用,例如缺陷经验与发布阻断统一走 `errorbook`。
25
- - 若接管项目中已存在自定义缺陷复盘册、故障账本或问题经验库,必须统一盘点并吸收到 `.sce/errorbook`,不要长期并存混用。
26
- - 不要在 steering 中额外定义另一套错题、发布、会话或治理模式。
27
-
28
- ## 5. 质量问题必须追根
29
-
30
- - 禁止靠跳过测试、关闭校验、吞错回退来伪装成功。
31
- - 临时兜底必须附带退出条件、清理任务与截止时间。
32
- - 重写或替换实现时,同步删除失效旧代码、旧样式、死分支和无效引用,不要把废弃实现留在仓库里当“保险”。
33
- - 如果因为兼容、灰度或回滚必须临时保留旧实现,必须写明保留理由、边界、退出条件和后续清理计划。
34
-
35
- ## 6. 定期净化 steering
36
-
37
- - 每周、发布前、重大 Spec 收尾后运行 `npm run audit:steering`。
38
- - 发现问题时优先合并重复、迁移错层、归档历史、删除失效条目。
39
-
40
- ## 7. 业务场景未知时先澄清,不得直接彻底禁用
41
-
42
- - 不了解业务场景、模块、页面、实体或业务约束时,先补上下文并缩小范围。
43
- - 禁止把“暂时没理解场景”直接变成 blanket disable、answer-only 或一刀切阻断。
44
- - 只有明确命中安全、权限、合规或破坏性规则时,才允许阻断;否则先澄清业务范围。
45
- - 这条规则适用于所有使用 SCE 的项目,不设项目级例外。
46
-
47
- ## 8. 禁止盲改问题
48
-
49
- - 修问题前先明确现象、复现条件、影响范围和验证方式。
50
- - 缺少证据时先补日志、数据、接口样本或最小复现,不要靠猜测连续改代码。
51
- - 两轮修改仍未收敛时,先回到调试和根因分析,不要盲目扩大改动面。
52
-
53
- ## 9. Steering 变更先评估,不得随意增删
54
-
55
- - 新增、删除或重写 steering 条目前,先判断它是否真属于长期原则,是否应迁到 `CURRENT_CONTEXT.md`、Spec 或项目文档。
56
- - 未经评估,不要把临时偏好、短期任务或偶发结论直接固化进 steering。
57
-
58
- ## 10. 问题修复时前后端接口不一致默认以后端契约为准
59
-
60
- - 前端调用后端 API 不匹配时,默认以后端现有接口契约为准。
61
- - 除非明确要求新建或修改后端接口,否则不要为了迁就前端错误调用去改后端。
62
- - 优先调整前端请求、映射、类型和兼容处理,使其与后端接口一致。
63
-
64
- ## 11. 单文件规模过大时必须触发重构评估
65
-
66
- - SCE 应先评估当前项目的代码规模分布,再给出项目级的重构参考节点;不要把一个固定阈值生硬套到所有项目。
67
- - 如果项目还没有自己的阈值,默认参考源文件 `2000 / 4000 / 10000` 行三档触发:分别对应“必须评估”“必须发起重构收敛”“进入红线区”。
68
- - 达到项目级或默认阈值后,继续加功能前先评估是否应拆分职责;超过重构/红线阈值时,优先做拆分和降复杂度,而不是继续堆代码。
69
- - 项目早期应更早触发评估,后期也要按周或发布前复评,避免阈值长期失效。
70
- - 行数阈值只是强触发信号;如果文件虽然没到阈值,但职责混杂、测试困难、理解成本失控,也应提前重构。
22
+ - 勤奋推进,不偷懒,不跳步;在无需用户额外干预时,按第一性原理先做计划并自主持续推进,始终沿关键路径连续推进分析、实现、验证、修复和交付,不靠省略环节伪装完成。
23
+ - 先准确领会你的真实意图,不拿旧判断、旧上下文或上一轮结论硬套现状;先校正目标,再展开动作。
24
+ - 主动调查研究,先看代码、数据、日志、配置和现场事实,再下结论;没有证据时先补证据。
25
+ - 保持项目活地图,持续知道当前结构、边界、依赖、关键约束和主要风险点;每次落刀前都要知道改动会影响哪里。
26
+ - 对问题想够想透,优先处理根因、连带影响和系统收敛路径,不做表面修补,也不把复杂问题压扁成局部补丁。
27
+ - 在证据足够时敢于下判断并推进下一步;结论可以修正,但不能在没有新证据时反复摇摆空转。
28
+ - 推进时必须统筹已有 Spec、`errorbook`、测试、现状代码和你的关注点,保证目标、实现、验证和经验沉淀同向收敛。
29
+ - 遇到问题先主动拆解、定位和缩小范围;只有真正外部阻塞、权限缺口或目标冲突时才升级,不得轻易把阻塞甩回来。
30
+ - 保持连续作战能力,按断点记录和恢复,持续收敛直到形成可验证闭环;除非触发高风险、权限边界或目标冲突,否则不中途停在“等你指示”,任何中断都不能让上下文重新归零。
@@ -3,10 +3,14 @@
3
3
  **版本**: `[TODO: 当前版本]`
4
4
  **状态**: `[TODO: 当前阶段]`
5
5
  **当前主线**: `[TODO: 当前最重要目标]`
6
+ **当前协作模型**: 单项目多协作通道默认成立;`focusedChannelId` 仅表示当前 UI 焦点
6
7
 
7
8
  **本轮重点**:
8
9
  - [TODO: 当前重点 1]
9
10
  - [TODO: 当前重点 2]
10
11
  - [TODO: 当前重点 3]
12
+ - [TODO: 明确当前项目是否已有多个 `channel/session` 并行推进]
13
+ - [TODO: 明确每个 `project + channel/session` 独立保存 `scene/spec/doc/session/tabs/tree/draft/runState`]
14
+ - [TODO: 明确后续实现需补“同项目双通道并行不串现场”验收]
11
15
 
12
16
  > 只保留当前有效信息。历史流水、阶段记录、详细方案请迁回对应 Spec。
@@ -1,18 +1,26 @@
1
1
  # Steering 规则索引
2
2
 
3
3
  **职责边界**:
4
- - `CORE_PRINCIPLES.md`:长期原则
4
+ - `CORE_PRINCIPLES.md`:只保留“小九条”这组最高原则
5
5
  - `ENVIRONMENT.md`:项目级规则
6
6
  - `CURRENT_CONTEXT.md`:当前阶段上下文
7
- - `RULES_GUIDE.md`:迁移与维护规则
7
+ - `RULES_GUIDE.md`:治理基线、迁移规则与审计入口
8
8
 
9
- **迁移原则**:
10
- - 长期有效 -> `CORE_PRINCIPLES.md`
11
- - 项目运行约束 -> `ENVIRONMENT.md`
12
- - 当前阶段状态 -> `CURRENT_CONTEXT.md`
13
- - 详细制度与示例 -> 项目文档
14
- - 任务、证据、历史 -> 对应 Spec
9
+ **分层要求**:
10
+ - 最高原则只保留在 `CORE_PRINCIPLES.md`,不再混入执行细则、门禁清单和策略阈值
11
+ - 详细制度、示例、案例和方法论写入 `docs/steering-governance.md`
12
+ - 可复用执行经验、阈值和复盘优先沉淀到 `.sce/knowledge/lessons/`
13
+ - 任务、证据、历史放对应 Spec
14
+
15
+ ## 治理基线(非最高原则)
16
+
17
+ - 所有需求先落 Spec;所有由 Agent 生成的脚本、报告、诊断、调试日志、测试脚本、临时分析和验证产物默认归档到当前 `.sce/specs/<spec>/` 的对应子目录;没有明确 Spec 时先使用通用 Spec 承接。
18
+ - 连续两轮以上仍未成功定位或验证问题时,先在 `errorbook` 记录或更新 incident,再用二分法配合 debug 日志/埋点快速收敛范围,不继续盲改。
19
+ - 业务场景未知时先澄清,不得把未知范围直接变成一刀切禁用;修改问题前先建立问题契约和证据,不得靠猜测碰运气。
20
+ - 代码、测试、文档必须同步闭环;重要功能、命令、配置变化必须同步更新说明,发布前不得带着失败验证前进。
21
+ - Steering 变更先评估;已有机制优先复用,不得在 steering 中平行造轮子,尤其不得再造一套独立于 `errorbook` 的问题沉淀机制。
22
+ - 可复用执行经验、阈值、案例和策略,优先写入 `docs/steering-governance.md` 或 `.sce/knowledge/lessons/`,不要回灌到最高原则层。
15
23
 
16
24
  **治理动作**:
17
25
  - 定期运行 `npm run audit:steering`
18
- - 审计失败时,优先合并重复、迁移错层、归档历史、删除失效内容
26
+ - 审计失败时优先合并重复、迁移错层、归档历史、删除失效内容
@@ -1,111 +1,47 @@
1
- # [TODO: 项目名称 - 请修改此标题]
1
+ # SCE Project Template
2
2
 
3
- > ⚠️ **这是模板文件**: 请搜索并替换所有 `[TODO: ...]` 占位符为实际项目信息
3
+ This template is the adoption baseline that `sce adopt` applies to a project.
4
4
 
5
- ## 🎯 项目概述
5
+ It is not an old `ultrawork_enhancer.py` walkthrough anymore. The current mainline is:
6
6
 
7
- 这是一个集成了 **Sisyphus Ultrawork 精神** 的 SCE Spec 驱动开发项目。
7
+ - `takeover / steering baseline`
8
+ - `Four Teachings + Little Nine`
9
+ - `project -> channel/session -> scene/spec`
10
+ - `studio / spec / task / semantic / supervision`
11
+ - `SQLite-backed state and governed evidence`
8
12
 
9
- ### 核心特性
13
+ ## What This Template Provides
10
14
 
11
- - **Spec 驱动开发**: Requirements Design Tasks 标准流程
12
- - **Ultrawork 精神**: 像西西弗斯一样不懈努力,追求专业级质量
13
- - **质量增强工具**: 自动评估和改进文档质量 (0-10 评分)
14
- - **便捷脚本**: 一键应用 Ultrawork 增强
15
+ - `.sce/README.md`: the first project guide an AI or operator should read
16
+ - `.sce/steering/`: supreme principles, rules, environment, and current-context summary
17
+ - `.sce/config/`: takeover, intake, state, semantic shared-source, and governance defaults
18
+ - `.sce/specs/`: governed work packages
19
+ - `.sce/tools/`: compatibility/helper utilities that still ship with the template
15
20
 
16
- ## 🚀 快速开始
17
-
18
- ### 1. 项目初始化(仅首次使用)
19
-
20
- 如果这是从模板复制的新项目,请先运行:
21
-
22
- ```bash
23
- .\setup-project.bat
24
- ```
25
-
26
- 这个脚本会初始化 `.sce` 目录的配置,更新项目名称。
27
-
28
- ### 2. 创建和增强 Spec
21
+ ## Recommended Startup
29
22
 
30
23
  ```bash
31
- # 创建 Spec 目录
32
- mkdir .sce\specs\01-00-your-feature-name
33
-
34
- # 编写基础 requirements.md
35
- # (手动创建基本需求文档)
36
-
37
- # 应用 Ultrawork 增强
38
- python .sce\tools\ultrawork_enhancer.py requirements .sce\specs\01-00-your-feature-name\requirements.md
39
- ```
40
-
41
- ### 3. 完整工作流
42
-
43
- ```bash
44
- # 增强需求文档
45
- python .sce\tools\ultrawork_enhancer.py requirements .sce\specs\spec-name\requirements.md
46
-
47
- # 增强设计文档
48
- python .sce\tools\ultrawork_enhancer.py design .sce\specs\spec-name\design.md .sce\specs\spec-name\requirements.md
49
-
50
- # 检查任务完成情况
51
- python .sce\tools\ultrawork_enhancer.py tasks .sce\specs\spec-name\tasks.md
24
+ sce adopt
25
+ sce status
26
+ sce studio plan --goal "bootstrap first governed work item" --json
52
27
  ```
53
28
 
54
- ## 📊 质量标准
55
-
56
- ### Requirements 阶段 (0-10 分)
57
- - 基础结构、EARS 格式、用户故事
58
- - 验收标准、非功能需求、约束条件
59
-
60
- ### Design 阶段 (0-10 分)
61
- - 系统概述、架构设计、组件设计
62
- - 需求追溯、技术选型、接口定义
63
-
64
- ### Tasks 阶段
65
- - 完成率分析、优先级识别
66
- - Ultrawork 激励、执行建议
67
-
68
- ## 🛠️ 核心脚本
69
-
70
- ### setup-project.bat
71
- **作用**: 初始化 `.sce` 目录配置
72
- - 更新项目名称
73
- - 检查工具完整性
74
- - 提供使用指导
75
-
76
- ## 🛠️ 核心工具
77
-
78
- ### ultrawork_enhancer.py
79
- **作用**: Ultrawork 质量增强核心工具
80
- - 自动评估文档质量 (0-10 评分)
81
- - 识别和应用改进点
82
- - 支持 Requirements/Design/Tasks 三阶段
83
-
84
- **使用方法**:
85
- ```bash
86
- # Requirements 阶段
87
- python .sce\tools\ultrawork_enhancer.py requirements <path-to-requirements.md>
88
-
89
- # Design 阶段
90
- python .sce\tools\ultrawork_enhancer.py design <path-to-design.md> <path-to-requirements.md>
91
-
92
- # Tasks 阶段
93
- python .sce\tools\ultrawork_enhancer.py tasks <path-to-tasks.md>
94
- ```
95
-
96
- ## 🔥 Ultrawork 精神
97
-
98
- > 像西西弗斯推石上山一样,永不放弃,不懈努力,直到任务完美完成
29
+ Then tell the AI runtime to read `.sce/README.md` and the active steering/spec files before editing code.
99
30
 
100
- - **不满足于"差不多"**: 追求专业级质量标准 (9.0/10)
101
- - **持续改进**: 自动识别和应用改进点
102
- - **永不放弃**: 遇到困难时提供激励和解决方案
31
+ ## Governance Defaults Carried by This Template
103
32
 
104
- ## 📚 参考文档
33
+ - Supreme-principle layer keeps only `Four Teachings + Little Nine`
34
+ - One project supports multiple collaboration channels/sessions in parallel by default
35
+ - Each `project + channel/session` keeps its own `scene/spec/doc/session/tabs/tree/draft/runState`
36
+ - `focusedChannelId` is only the UI focus pointer; it must not overwrite other channels
37
+ - Agent-generated logs, scripts, reports, and temporary analysis belong under the active Spec subtree by default
38
+ - If no explicit Spec exists yet, use a governed general Spec instead of scattering artifacts
39
+ - After more than two failed localization rounds, update the `errorbook` incident and use bisection-style debug evidence
40
+ - Persistent state prefers SQLite over ad hoc local files
105
41
 
106
- - `.sce/README.md` - SCE 系统说明
107
- - `.sce/steering/CORE_PRINCIPLES.md` - 核心原则(包含 Ultrawork 精神)
42
+ ## Maintenance Note
108
43
 
109
- ---
44
+ Some helper assets under `.sce/tools/` are still kept for compatibility with previously adopted projects. They are not the primary workflow contract and should not redefine the current governance model.
110
45
 
111
- **让每个 Spec 都体现 Sisyphus 的不懈努力精神!** 🔥
46
+ **Version**: 3.6.66
47
+ **Last Updated**: 2026-03-28