kld-sdd 2.7.3 → 2.7.8-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.
Files changed (74) hide show
  1. package/README.md +12 -5
  2. package/USABILITY.md +104 -0
  3. package/bin/kld-sdd-init.js +1 -1
  4. package/kld-sdd-guide.html +16 -4
  5. package/lib/hook-gate-core.js +327 -0
  6. package/lib/init.js +228 -37
  7. package/lib/scale-thresholds.json +19 -0
  8. package/lib/skills-bundle.js +2 -1
  9. package/package.json +5 -3
  10. package/skywalk-sdd/context-client.cjs +50 -30
  11. package/skywalk-sdd/index.cjs +159 -40
  12. package/skywalk-sdd/kb-sync-identity.cjs +99 -451
  13. package/skywalk-sdd/kb-upload.cjs +67 -44
  14. package/skywalk-sdd/lib/check-review.cjs +41 -0
  15. package/skywalk-sdd/lib/test-execution.cjs +110 -0
  16. package/skywalk-sdd/lib/usage-contract.cjs +3 -2
  17. package/skywalk-sdd/lib/usage-reporter.cjs +27 -2
  18. package/skywalk-sdd/metrics-v3.cjs +2 -2
  19. package/skywalk-sdd/ontology/active-changes.cjs +2 -1
  20. package/skywalk-sdd/ontology/archive-package.cjs +1 -1
  21. package/skywalk-sdd/ontology/artifact-parser.cjs +7 -4
  22. package/skywalk-sdd/ontology/id.cjs +5 -4
  23. package/skywalk-sdd/ontology/identity-index.cjs +9 -4
  24. package/skywalk-sdd/ontology/list-changes.cjs +1 -1
  25. package/skywalk-sdd/ontology/runtime.cjs +7 -3
  26. package/skywalk-sdd/ontology/schema.cjs +2 -0
  27. package/skywalk-sdd/ontology/traceability-validator.cjs +74 -4
  28. package/skywalk-sdd/ontology/workspace-layout.cjs +25 -5
  29. package/skywalk-sdd/reporting/change-report-model.cjs +4 -3
  30. package/templates/git-hooks/commit-msg +39 -24
  31. package/templates/git-hooks/consistency-check-core.cjs +1097 -0
  32. package/templates/git-hooks/hooks.config +20 -1
  33. package/templates/git-hooks/pre-commit +39 -24
  34. package/templates/git-hooks/pre-commit-consistency-check.cjs +29 -332
  35. package/templates/git-hooks/pre-commit-sdd-check.cjs +98 -0
  36. package/templates/git-hooks/pre-push +39 -24
  37. package/templates/git-hooks/pre-push-consistency-check.cjs +58 -406
  38. package/templates/hooks/claude/hooks/sdd-post-tool.cjs +2 -2
  39. package/templates/hooks/codebuddy/hooks/sdd-post-tool.cjs +2 -2
  40. package/templates/hooks/codebuddy/hooks/sdd-tdd-rhythm-gate.cjs +1 -1
  41. package/templates/openspec/tasks.md +3 -3
  42. package/templates/skills/kld-sdd/opsx-apply/SKILL.md +44 -6
  43. package/templates/skills/kld-sdd/opsx-apply/checklist.md +1 -1
  44. package/templates/skills/kld-sdd/opsx-apply/reference.md +20 -2
  45. package/templates/skills/kld-sdd/opsx-archive/SKILL.md +19 -21
  46. package/templates/skills/kld-sdd/opsx-check/SKILL.md +55 -327
  47. package/templates/skills/kld-sdd/opsx-check/checklist.md +7 -4
  48. package/templates/skills/kld-sdd/opsx-check/reference.md +60 -0
  49. package/templates/skills/kld-sdd/opsx-check/result-template.json +52 -0
  50. package/templates/skills/kld-sdd/opsx-check/review-template.json +22 -0
  51. package/templates/skills/kld-sdd/opsx-check/reviewer.md +100 -0
  52. package/templates/skills/kld-sdd/opsx-consistency-check/SKILL.md +82 -451
  53. package/templates/skills/kld-sdd/opsx-consistency-check/{reference.md → references/reference.md} +0 -1
  54. package/templates/skills/kld-sdd/opsx-consistency-check/scripts/scripts.cjs +517 -0
  55. package/templates/skills/kld-sdd/opsx-design/SKILL.md +10 -30
  56. package/templates/skills/kld-sdd/opsx-design/checklist.md +3 -4
  57. package/templates/skills/kld-sdd/opsx-design/reference.md +1 -1
  58. package/templates/skills/kld-sdd/opsx-kb-config/SKILL.md +29 -154
  59. package/templates/skills/kld-sdd/opsx-kb-config/reference.md +8 -11
  60. package/templates/skills/kld-sdd/opsx-kb-ingest/SKILL.md +12 -74
  61. package/templates/skills/kld-sdd/opsx-kb-ingest/reference.md +2 -2
  62. package/templates/skills/kld-sdd/opsx-ontology-query/SKILL.md +7 -5
  63. package/templates/skills/kld-sdd/opsx-ontology-query/phase-1-prechange.md +2 -2
  64. package/templates/skills/kld-sdd/opsx-ontology-query/reference.md +1 -1
  65. package/templates/skills/kld-sdd/opsx-propose/SKILL.md +29 -74
  66. package/templates/skills/kld-sdd/opsx-propose/checklist.md +8 -8
  67. package/templates/skills/kld-sdd/opsx-propose/interaction-policy.md +35 -0
  68. package/templates/skills/kld-sdd/opsx-propose/reference.md +12 -46
  69. package/templates/skills/kld-sdd/opsx-spec/SKILL.md +14 -61
  70. package/templates/skills/kld-sdd/opsx-spec/checklist.md +3 -3
  71. package/templates/skills/kld-sdd/opsx-task/SKILL.md +40 -34
  72. package/templates/skills/kld-sdd/opsx-task/checklist.md +5 -6
  73. package/templates/skills/kld-sdd/opsx-test/SKILL.md +2 -0
  74. package/templates/skills/kld-sdd/tdd-rules/rules/tdd-strategy-selection.md +1 -1
package/templates/skills/kld-sdd/opsx-task/checklist.md CHANGED
@@ -13,10 +13,9 @@ description: opsx-task 的阶段强制检查点与自检清单。仅在执行 ta
13
13
 
14
14
  - [ ] ✅ 允许：创建/编辑 tasks.md 文档、读取代码作为任务分析参考
15
15
  - [ ] ❌ 禁止：创建/修改任何代码文件、执行代码生成、运行测试
16
- - [ ] ⛔ 单阶段原则：完成 tasks.md 后必须立即停止，等待用户主动触发下一阶段
16
+ - [ ] **执行范围**：单阶段请求完成即停；已授权连续处理则按交互契约加载下一阶段，check 通过后方可进入 apply，不能超出授权范围。
17
17
  - [ ] tasks.md 定义的是「待执行的任务清单」，不是立即执行代码
18
18
  - [ ] 引导用户使用 `/opsx-apply` 进入实施阶段
19
- - [ ] ⛔ 完成本阶段后绝对禁止自动继续执行 apply/check 等后续阶段
20
19
 
21
20
  ---
22
21
 
@@ -26,7 +25,7 @@ description: opsx-task 的阶段强制检查点与自检清单。仅在执行 ta
26
25
  - [ ] **拓扑图已绘制**：层级关系清晰
27
26
  - [ ] **依赖字段已填写**：每个任务的依赖已明确
28
27
  - [ ] **无循环依赖**：拓扑中不存在环
29
- - [ ] 每个任务颗粒度 ≤ 5 分钟
28
+ - [ ] 每个任务对应可验证的行为或交付单元，不按固定分钟数拆分
30
29
  - [ ] 100% 覆盖 design.md 定义
31
30
  - [ ] 每个任务都有验收标准
32
31
  - [ ] ⛔ **约束（CON）覆盖**：spec.md 中每个 CON 必须有对应验证任务，或在任务中显式声明"通过现有 AC 间接覆盖"并说明理由；tasks.md 质量红线声明"100% 覆盖 CON"时必须可追溯
@@ -50,9 +49,9 @@ description: opsx-task 的阶段强制检查点与自检清单。仅在执行 ta
50
49
 
51
50
  - [ ] 必须以 `openspec-templates/tasks.md` 为模板基准
52
51
  - [ ] ⛔ **渐进式加载**：严格按 overview.md → proposal.md → spec.md → design.md 顺序
53
- - [ ] ⛔ **隔离红线**：绝对禁止读取同级其他 Capability 的文档
52
+ - [ ] ⛔ **隔离红线**：默认聚焦当前 Capability；为核对已声明依赖可读取相关 Capability 契约并注明来源，不全量加载或混写其他能力。
54
53
  - [ ] ⛔ **DAG 必须完整**：每个任务必须有依赖字段
55
54
  - [ ] ⛔ **无循环依赖**：DAG 中不允许存在环
56
- - [ ] 任务颗粒度宁可过细也不要过粗
55
+ - [ ] 任务粒度以可验证结果和真实依赖为准，避免按字段或命令机械拆分
57
56
  - [ ] ⛔ **阶段边界**：禁止执行任何代码创建/修改操作
58
- - [ ] ⛔ **单阶段原则**：完成 tasks.md 后必须立即停止；仅提示用户下一步 **check 优先**：先运行 `/opsx-check` 通过质量检查，再 `/opsx-apply`（apply 须在 check 通过后）；绝对禁止自动执行 apply/check 等后续阶段。每个阶段必须由用户主动触发。
57
+ - [ ] **执行范围**：单阶段请求完成即停；已授权连续处理则按交互契约加载下一阶段，check 通过后方可进入 apply，不能超出授权范围。
package/templates/skills/kld-sdd/opsx-test/SKILL.md CHANGED
@@ -14,6 +14,8 @@ allowed-tools:
14
14
  - Edit
15
15
  ---
16
16
 
17
+ > **执行方式**：先读 [交互与执行契约](../opsx-propose/interaction-policy.md)；同一会话已读则复用。用户已授权连续处理时按范围推进，不重复索要阶段口令；只请求单阶段时完成即停。
18
+
17
19
  你是一个 SDD（Specification-Driven Development）测试执行专家。激活本技能后，你将自动检测项目测试框架并执行测试，输出结构化报告。
18
20
 
19
21
 
package/templates/skills/kld-sdd/tdd-rules/rules/tdd-strategy-selection.md CHANGED
@@ -10,4 +10,4 @@
10
10
 
11
11
  ## 交互引导
12
12
 
13
- 使用 AskUserQuestion 工具询问用户选择哪种策略。不得默认选择。
13
+ 沿用团队/已有变更策略；新变更按 opsx-propose 的自动策略规则选择并说明理由。只有用户明确要求或业务验证口径存在实质歧义时才询问，不把内部枚举作为必答题。