@namewta/speculo 0.1.19 → 0.1.20
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/package.json
CHANGED
|
@@ -22,35 +22,14 @@ keywords: [config-prune, config, adr, context, lessons, rules, prune, 清理]
|
|
|
22
22
|
|
|
23
23
|
## 调用的 skills
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
- `../skills/config-prune/SKILL.md` — dry-run 审计 .config 知识资产过期项、生成分组候选清单时读取。
|
|
26
26
|
|
|
27
27
|
## 执行步骤
|
|
28
28
|
|
|
29
|
-
1. 读取
|
|
30
|
-
2.
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
排除 `node_modules/`、`dist/`、`.git/` 等生成或依赖目录。
|
|
35
|
-
3. 生成 dry-run 候选，至少包含：
|
|
36
|
-
- 指向不存在 ADR 的正文引用或索引行。
|
|
37
|
-
- 标记为 superseded 且超过 30 天、无活跃引用的 ADR。
|
|
38
|
-
- 只含 `.gitkeep`、TODO、空占位或模板说明的长期知识文件。
|
|
39
|
-
- CONTEXT 中当前代码、文档和归档均无证据支撑的术语。
|
|
40
|
-
- LESSONS 中重复、过期、只适用单次任务或已被 RULES/ADR 吸收的经验。
|
|
41
|
-
4. 按 `delete | merge | rewrite | keep | needs-confirmation` 分组输出完整清单；每个候选必须包含来源、证据和风险。
|
|
42
|
-
5. 如果用户没有明确确认，停止在 dry-run 报告。
|
|
43
|
-
6. 用户确认后，只执行确认清单中的操作：
|
|
44
|
-
- 删除文件前再次检查路径仍位于 `speculo/.speculo/.config/`。
|
|
45
|
-
- 修改 `RULES.md` 前必须确认具体条目；不能批量隐式改规则。
|
|
46
|
-
- 执行后写入报告，列出实际改动和跳过项。
|
|
47
|
-
|
|
48
|
-
## 边界
|
|
49
|
-
|
|
50
|
-
- 不删除仍被代码、文档、归档或 active change 引用的 ADR / CONTEXT。
|
|
51
|
-
- 不把低信号归档内容写回长期知识资产。
|
|
52
|
-
- 不自动解决领域术语冲突；冲突项交给 `../workflows/dev/M-domain-modeling/M-domain-modeling.md`。
|
|
53
|
-
- 不修改 docs-sync state；由 `../workflows/dev/D-docs-sync/D-docs-sync.md` 推进基线。
|
|
29
|
+
1. 读取 `../skills/config-prune/SKILL.md`，按其执行步骤与边界执行 config-prune 审计。
|
|
30
|
+
2. 创建规范命令产物目录 `speculo/.speculo/commands/<YYYY-MM-DD>-config-prune-<topic>/`。
|
|
31
|
+
3. 把 skill 返回的候选清单、证据、风险、用户确认记录和执行结果写入 `report.md`（使用下方产物模板）。
|
|
32
|
+
4. 返回 `report.md` 路径和 3-5 条摘要。
|
|
54
33
|
|
|
55
34
|
## 产物模板（report.md）
|
|
56
35
|
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: config-prune
|
|
3
|
+
type: skill
|
|
4
|
+
name: Config Prune
|
|
5
|
+
description: dry-run 审计 .config 中可安全删除或合并的过期知识资产，生成分组候选清单；当用户要求清理 .config、prune config、审计知识资产过期项、或通过 command/config-prune 调用时使用。
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Config Prune
|
|
9
|
+
|
|
10
|
+
⚠️ **默认 dry-run。** 本 skill 涉及 `.config` 知识资产删除或合并，必须先列出候选清单并征求用户确认。没有确认时只输出候选清单，不删除、不重命名、不改 RULES。
|
|
11
|
+
|
|
12
|
+
## 何时使用
|
|
13
|
+
|
|
14
|
+
- 用户要求"清理 .config"、"prune 配置"、"审计 ADR/CONTEXT/LESSONS 过期项"
|
|
15
|
+
- 用户要求"看看哪些知识资产可以删"、"检查过期的 ADR"
|
|
16
|
+
- 被 `commands/config-prune.md` 或 `workflows/dev/D-docs-sync` 等调用方委托执行审计
|
|
17
|
+
- 本 skill 只负责分析与生成候选清单，不自行删除文件、不自行写报告；持久化由调用方负责
|
|
18
|
+
|
|
19
|
+
## 输入
|
|
20
|
+
|
|
21
|
+
- `.config` 资产路径：`speculo/.speculo/.config/RULES.md`、`LESSONS.md`、`context/`、`adr/`；缺失路径记录为 `missing`，不自动创建
|
|
22
|
+
- 仓库引用扫描命令：
|
|
23
|
+
```bash
|
|
24
|
+
rg -n "ADR-[0-9]{4}|[0-9]{4}-[a-z0-9-]+\\.md|CONTEXT|LESSONS|RULES" .
|
|
25
|
+
```
|
|
26
|
+
排除 `node_modules/`、`dist/`、`.git/` 等生成或依赖目录
|
|
27
|
+
- 用户确认状态（dry-run 或 confirmed）
|
|
28
|
+
|
|
29
|
+
## 输出
|
|
30
|
+
|
|
31
|
+
- 按 `delete | merge | rewrite | keep | needs-confirmation` 分组的候选清单
|
|
32
|
+
- 每个候选包含：来源、证据、风险
|
|
33
|
+
- 不产生文件型持久化产物；结构化结果返回给调用方写入
|
|
34
|
+
|
|
35
|
+
## 执行步骤
|
|
36
|
+
|
|
37
|
+
1. 读取 `speculo/.speculo/.config/RULES.md`、`LESSONS.md`、`context/`、`adr/`；缺失路径记录为 `missing`，不自动创建。
|
|
38
|
+
2. 扫描当前仓库引用：
|
|
39
|
+
```bash
|
|
40
|
+
rg -n "ADR-[0-9]{4}|[0-9]{4}-[a-z0-9-]+\\.md|CONTEXT|LESSONS|RULES" .
|
|
41
|
+
```
|
|
42
|
+
排除 `node_modules/`、`dist/`、`.git/` 等生成或依赖目录。
|
|
43
|
+
3. 生成 dry-run 候选，至少包含：
|
|
44
|
+
- 指向不存在 ADR 的正文引用或索引行。
|
|
45
|
+
- 标记为 superseded 且超过 30 天、无活跃引用的 ADR。
|
|
46
|
+
- 只含 `.gitkeep`、TODO、空占位或模板说明的长期知识文件。
|
|
47
|
+
- CONTEXT 中当前代码、文档和归档均无证据支撑的术语。
|
|
48
|
+
- LESSONS 中重复、过期、只适用单次任务或已被 RULES/ADR 吸收的经验。
|
|
49
|
+
4. 按 `delete | merge | rewrite | keep | needs-confirmation` 分组输出完整清单；每个候选必须包含来源、证据和风险。
|
|
50
|
+
5. 如果用户没有明确确认，停止在 dry-run 候选清单。
|
|
51
|
+
6. 用户确认后，只执行确认清单中的操作：
|
|
52
|
+
- 删除文件前再次检查路径仍位于 `speculo/.speculo/.config/`。
|
|
53
|
+
- 修改 `RULES.md` 前必须确认具体条目；不能批量隐式改规则。
|
|
54
|
+
- 执行后列出实际改动和跳过项。
|
|
55
|
+
|
|
56
|
+
## 边界
|
|
57
|
+
|
|
58
|
+
- 不删除仍被代码、文档、归档或 active change 引用的 ADR / CONTEXT。
|
|
59
|
+
- 不把低信号归档内容写回长期知识资产。
|
|
60
|
+
- 不自动解决领域术语冲突；冲突项交给 `../workflows/dev/M-domain-modeling/M-domain-modeling.md`。
|
|
61
|
+
- 不修改 docs-sync state；由 `../workflows/dev/D-docs-sync/D-docs-sync.md` 推进基线。
|
|
62
|
+
- 不自行选择持久化位置；文件型产物由调用方写入规范路径。
|
|
63
|
+
|
|
64
|
+
## 渐进披露
|
|
65
|
+
|
|
66
|
+
无 `references/`；本 skill 的完整执行规则已在入口中。
|
|
@@ -62,7 +62,7 @@ ADR 记录难以逆转、缺上下文会令人意外、存在真实权衡的决
|
|
|
62
62
|
|
|
63
63
|
## 删除与 Prune
|
|
64
64
|
|
|
65
|
-
docs-sync 可以直接删除 tracked 文档中的过期段落；对 `.config` 文件级删除默认进入 `../../../
|
|
65
|
+
docs-sync 可以直接删除 tracked 文档中的过期段落；对 `.config` 文件级删除默认进入 `../../../skills/config-prune/SKILL.md` 审计候选。
|
|
66
66
|
|
|
67
67
|
可进入 prune 候选的典型情况：
|
|
68
68
|
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
- 常规同步不整页重写 README 或代理手册；`bootstrap` 模式只在文件缺失时创建完整初始文件，已有文件仍以审计和差量修订为主。
|
|
35
35
|
- 不添加没有对应代码来源的计划中能力。
|
|
36
36
|
- 不把 docs-sync state 放回 skill 或 workflow 目录。
|
|
37
|
-
- 不自动删除 `.config` 文件；删除候选进入 report
|
|
37
|
+
- 不自动删除 `.config` 文件；删除候选进入 report 或交由 `../../../skills/config-prune/SKILL.md` 审计，执行删除需要用户确认。
|
|
38
38
|
- 不把归档产物正文大段复制到长期文档；只沉淀可复用结论，并保留路径引用。
|
|
39
39
|
|
|
40
40
|
## 完成准则
|