kld-sdd 2.7.8-3 → 2.7.8-5
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/README.md +24 -0
- package/bin/kld-sdd-init.js +633 -34
- package/lib/command-bridge.js +26 -17
- package/lib/deploy-codebuddy-hooks.js +19 -26
- package/lib/deploy-strategy.js +293 -0
- package/lib/hook-gate-core.js +7 -8
- package/lib/init.js +466 -584
- package/lib/maintenance.js +96 -0
- package/lib/settings-merge.js +102 -25
- package/lib/skills-bundle.js +2 -4
- package/lib/spec-choice.js +85 -0
- package/lib/tool-profiles.js +2 -2
- package/lib/uninstall.js +453 -0
- package/package.json +7 -4
- package/skywalk-sdd/kb-upload.cjs +43 -32
- package/skywalk-sdd/lib/shared.cjs +62 -41
- package/skywalk-sdd/lib/usage-reporter.cjs +17 -8
- package/skywalk-sdd/ontology/resolve-spec-root.cjs +49 -0
- package/skywalk-sdd/ontology/sdd-config.cjs +33 -5
- package/skywalk-sdd/ontology/spec-detect.cjs +421 -0
- package/skywalk-sdd/ontology/workspace-layout.cjs +65 -17
- package/templates/hooks/codebuddy/hooks/hook-gate-core.cjs +7 -8
- package/templates/skills/kld-sdd/opsx-consistency-check/scripts/scripts.cjs +14 -0
- package/templates/skills/kld-sdd/opsx-kb-config/SKILL.md +157 -11
- package/index.js +0 -13
package/README.md
CHANGED
|
@@ -6,6 +6,30 @@ KLD SDD OpenSpec 工程增强工具：一键初始化 AI 编辑器技能、语
|
|
|
6
6
|
|
|
7
7
|
日常提交默认只保留本地关联 Hook；Apply 自动执行代码/Spec 检查、真实测试与交付验证。旧项目升级、备份回退、多仓和 CI 边界见 [Git Hook 调整说明](USABILITY.md#2026-09-10git-hook-收缩与交付验证)。
|
|
8
8
|
|
|
9
|
+
## 工具更新与卸载
|
|
10
|
+
|
|
11
|
+
**更新不需要先卸载。** 在原工作目录重新运行安装器，覆盖运行脚本、Skills 和只读模板；Spec 文档、KB 绑定、项目身份、历史数据、用户配置和自定义 Hook 保留。先确认目标编辑器及 Spec 目录，完成后检查实际部署版本。下载失败不启动安装；执行中断后可以重跑补齐，不承诺整个项目的事务回滚。
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
# 选择包含本次修复的新发布版本，在原工作目录更新
|
|
15
|
+
npx kld-sdd@<新版版本号> --tool=cursor --spec-path=team-sdd-specs --skip-openspec
|
|
16
|
+
|
|
17
|
+
# 卸载只有工具一种方式；可以先看计划
|
|
18
|
+
npx kld-sdd@<新版版本号> uninstall --dry-run
|
|
19
|
+
npx kld-sdd@<新版版本号> uninstall
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
卸载不再提供全量删除，旧 `--purge` 参数会报错退出。`openspec/`（含活动变更、归档和规格）、KB 配置、身份、历史数据、`.sdd.yaml`、`.sdd-spec-root`、`.sdd-workspace.yaml`、Git 关联和隐私忽略规则始终保留。工具目录内的未知文件和自建规则也保留；Git Hook 只有完整匹配受管版本时才删除。预览后文件改变需要重新预览。
|
|
23
|
+
|
|
24
|
+
多仓注意：
|
|
25
|
+
|
|
26
|
+
- 升级沿用已有清单，只维护登记的代码仓；多个 Spec 和备份不会互相接入。新代码仓通过 `kld-sdd sync-repos` 明确接入，追加清单时保留注释、自定义字段和原有记录。
|
|
27
|
+
- 本地路径、团队远程声明或工作区清单冲突时，先停止更新并提示核对，不自动换绑。
|
|
28
|
+
- 从单个代码仓卸载时，工作目录外的共享 Spec 工具保留。从 worktree 卸载时，共用的 Git Hook 保留，应从主仓库管理。
|
|
29
|
+
- 旧平铺 `skywalk-sdd/` 只清理已知工具，历史数据原位保留，不自动合并两份项目身份或运行状态。
|
|
30
|
+
|
|
31
|
+
以上行为需要使用包含本次改动的新版本；修改此源码不会改变已经发布的 npm 包。安装包通过 `sddMaintenance.toolOnly: 1` 声明该维护契约，托盘据此避免用旧安装器处理存在已知清理风险的布局。
|
|
32
|
+
|
|
9
33
|
## 这是什么？
|
|
10
34
|
|
|
11
35
|
**SDD（Specification-Driven Development）** 是一种以文档链驱动 AI 编码的研发方法：先写清楚"要做什么"，再让 AI 去实现，避免 AI 乱猜、反复返工。
|