Land minimum KB bootstrap

Author: Li-Sanze

.sopify-skills/plan/20260313_sopify_runtime_blueprint/README.md

@@ -119,14 +119,21 @@ R0 需要补齐：
 - 将高价值 skills 脚本化，例如 `workflow-learning` 和 `templates`
 - 继续保持核心流程与外围产品层解耦
 
+当前已落地：
+
+- `runtime/kb.py` 已接入 runtime 主链，用于首次运行时 bootstrap 最小 KB 骨架
+- 当前最小 KB 文件集包括 `project.md`、`wiki/overview.md`、`user/preferences.md`、`history/index.md`
+- 当前只生成基于根配置、manifest、顶层目录的轻量快照，不做源码级扫描
+- 该能力当前只负责“建立长期资产入口”，尚未进入选择性历史回收与 history archive
+
 ## 当前明确不做
 
 - 不做深 `core / adapter / provider / plugin` 拆分
 - 不扩张面向用户的配置面
 - 不做全量自动加载 KB
 - R0 不发布 `~go exec` 的最小 develop bridge
 - R0 不发布 `workflow-learning` / `templates` 的 runtime 脚本化
-- R0 不发布 history / task state / KB bootstrap
+- R0 不发布 history / task state
 - P0 不做完整 develop 自动执行器
 - P0 / P1 不优先做安装器、更新器、通知、hooks 等外围产品层
 - 不做 marketplace 式 skill 平台

.sopify-skills/plan/20260313_sopify_runtime_blueprint/design.md

@@ -353,12 +353,13 @@ P0 只允许读取：
 
 1. 加载 config
 2. 加载 state
-3. 发现 skills
-4. 分类 route
-5. 回收最小上下文
-6. 持久化 route 状态
-7. 分支进入 scaffold / replay / runtime skill / plain Q&A
-8. 按需写 replay 事件
+3. 初始化最小 KB 骨架
+4. 发现 skills
+5. 分类 route
+6. 回收最小上下文
+7. 持久化 route 状态
+8. 分支进入 scaffold / replay / runtime skill / plain Q&A
+9. 按需写 replay 事件
 
 不负责：
 
@@ -416,12 +417,15 @@ P0 只允许读取：
 - 最小知识库初始化
 - 最小偏好持久化
 - 轻量项目上下文文件
-- 先读根配置文件，再按需扩展到目录结构和源码扫描
+- 当前先读取根配置、manifest、顶层目录；后续再按需扩展到源码扫描
+- 当前最小落地范围是首次运行时创建 `project.md`、`wiki/overview.md`、`user/preferences.md`、`history/index.md`
 
 不负责：
 
 - 智能全量文档同步
 - 全量自动加载知识库
+- history archive
+- 选择性历史回收策略
 
 ### `runtime/history.py`
 

.sopify-skills/plan/20260313_sopify_runtime_blueprint/tasks.md

@@ -345,16 +345,23 @@ P1 实现原则：
 
 ### 1. 最小 KB 支持
 
-- [ ] 实现 KB bootstrap
-- [ ] 初始化最小 wiki 与 user 文件
-- [ ] 只持久化明确的长期偏好
+- [x] 实现 KB bootstrap
+- [x] 初始化最小 wiki 与 user 文件
+- [x] 只持久化明确的长期偏好
 - [ ] 优先扫描根配置文件，再按需扫描目录结构和源码
 
 验收条件：
 
 - KB 可以按需初始化
 - 偏好写入保持保守和结构化
 
+当前收口说明：
+
+- 已在 `runtime/kb.py` 中落地首次运行的最小 KB bootstrap
+- 当前最小文件集为 `project.md`、`wiki/overview.md`、`user/preferences.md`、`history/index.md`
+- 当前 `project.md` 只基于根配置、manifest、顶层目录生成快照，源码级扫描仍待后续补齐
+- 本轮不包含选择性历史回收与 history archive
+
 ### 2. 选择性历史回收
 
 - [ ] 定义 P1 可参与回收的历史文件范围
@@ -414,7 +421,7 @@ P1 实现原则：
 
 ### 7. P1 行为测试
 
-- [ ] 测试 KB bootstrap
+- [x] 测试 KB bootstrap
 - [ ] 测试选择性历史回收
 - [ ] 测试 history archive
 - [ ] 测试 task state 更新

CHANGELOG.md

@@ -16,6 +16,7 @@ This changelog is maintained manually (not auto-generated).
 
 ### Added
 
+- Minimal KB bootstrap in `runtime/kb.py`, creating `project.md`, `wiki/overview.md`, `user/preferences.md`, and `history/index.md` on first runtime execution.
 - New sub-skill `model-compare` (CN/EN) for configuration-driven multi-model parallel comparison with manual user selection.
 - New compare trigger contract:
   - Command: `~compare <question>`
@@ -60,6 +61,9 @@ This changelog is maintained manually (not auto-generated).
 - Clarified release boundary across README, blueprint, and changelog:
   - current minimal published slice = `runtime-backed ~go plan`
   - `~compare` generic-entry bridge / `~go exec` develop bridge / `workflow-learning` runtime helper remain out of scope for this slice
+- Clarified the next-stage boundary across runtime/docs/tests:
+  - P1-A now lands only the minimum KB bootstrap
+  - selective history recovery / history archive / task-state runtime remain for later P1 slices
 
 ## [2026-02-13] - 2026-02-13
 

Claude/Skills/CN/skills/sopify/kb/SKILL.md

@@ -61,13 +61,14 @@ description: 知识库管理技能；知识库操作时读取；包含初始化
 ```yaml
 首次初始化:
   - .sopify-skills/project.md (必须)
+  - .sopify-skills/wiki/overview.md
+  - .sopify-skills/user/preferences.md (允许先创建空文件，只有明确长期偏好时才写入内容)
+  - .sopify-skills/history/index.md
 
 首个方案时:
   - .sopify-skills/plan/ 目录
-  - .sopify-skills/history/index.md
 
 首次涉及模块文档时:
-  - .sopify-skills/wiki/overview.md
   - .sopify-skills/wiki/modules/{module}.md
 
 首次涉及 API 时:
@@ -77,10 +78,13 @@ description: 知识库管理技能；知识库操作时读取；包含初始化
   - .sopify-skills/wiki/data.md
 
 首次出现"明确长期偏好"时:
-  - .sopify-skills/user/preferences.md
   - .sopify-skills/user/feedback.jsonl
 ```
 
+说明：
+- 当前 runtime 的最小 KB bootstrap 已落地，上述 `project.md / overview.md / preferences.md / history/index.md` 会在首次运行时创建
+- `preferences.md` 可提前创建为空骨架，但只有用户明确声明长期偏好时才应写入真实偏好内容
+
 ---
 
 ## 项目上下文获取

Claude/Skills/EN/skills/sopify/kb/SKILL.md

@@ -61,13 +61,14 @@ Create files as needed:
 ```yaml
 Initial setup:
   - .sopify-skills/project.md (required)
+  - .sopify-skills/wiki/overview.md
+  - .sopify-skills/user/preferences.md (an empty file may exist first; real preferences are written only after explicit long-term statements)
+  - .sopify-skills/history/index.md
 
 First plan:
   - .sopify-skills/plan/ directory
-  - .sopify-skills/history/index.md
 
 First module documentation:
-  - .sopify-skills/wiki/overview.md
   - .sopify-skills/wiki/modules/{module}.md
 
 First API documentation:
@@ -77,10 +78,13 @@ First data model documentation:
   - .sopify-skills/wiki/data.md
 
 First explicit "long-term preference" statement:
-  - .sopify-skills/user/preferences.md
   - .sopify-skills/user/feedback.jsonl
 ```
 
+Notes:
+- The current runtime already lands a minimum KB bootstrap, so `project.md / overview.md / preferences.md / history/index.md` are created on the first run
+- `preferences.md` may be created as an empty skeleton first, but actual preferences should still be written only for explicit long-term statements
+
 ---
 
 ## Project Context Acquisition

Codex/Skills/CN/skills/sopify/kb/SKILL.md

@@ -61,13 +61,14 @@ description: 知识库管理技能；知识库操作时读取；包含初始化
 ```yaml
 首次初始化:
   - .sopify-skills/project.md (必须)
+  - .sopify-skills/wiki/overview.md
+  - .sopify-skills/user/preferences.md (允许先创建空文件，只有明确长期偏好时才写入内容)
+  - .sopify-skills/history/index.md
 
 首个方案时:
   - .sopify-skills/plan/ 目录
-  - .sopify-skills/history/index.md
 
 首次涉及模块文档时:
-  - .sopify-skills/wiki/overview.md
   - .sopify-skills/wiki/modules/{module}.md
 
 首次涉及 API 时:
@@ -77,10 +78,13 @@ description: 知识库管理技能；知识库操作时读取；包含初始化
   - .sopify-skills/wiki/data.md
 
 首次出现"明确长期偏好"时:
-  - .sopify-skills/user/preferences.md
   - .sopify-skills/user/feedback.jsonl
 ```
 
+说明：
+- 当前 runtime 的最小 KB bootstrap 已落地，上述 `project.md / overview.md / preferences.md / history/index.md` 会在首次运行时创建
+- `preferences.md` 可提前创建为空骨架，但只有用户明确声明长期偏好时才应写入真实偏好内容
+
 ---
 
 ## 项目上下文获取

Codex/Skills/EN/skills/sopify/kb/SKILL.md

@@ -61,13 +61,14 @@ Create files as needed:
 ```yaml
 Initial setup:
   - .sopify-skills/project.md (required)
+  - .sopify-skills/wiki/overview.md
+  - .sopify-skills/user/preferences.md (an empty file may exist first; real preferences are written only after explicit long-term statements)
+  - .sopify-skills/history/index.md
 
 First plan:
   - .sopify-skills/plan/ directory
-  - .sopify-skills/history/index.md
 
 First module documentation:
-  - .sopify-skills/wiki/overview.md
   - .sopify-skills/wiki/modules/{module}.md
 
 First API documentation:
@@ -77,10 +78,13 @@ First data model documentation:
   - .sopify-skills/wiki/data.md
 
 First explicit "long-term preference" statement:
-  - .sopify-skills/user/preferences.md
   - .sopify-skills/user/feedback.jsonl
 ```
 
+Notes:
+- The current runtime already lands a minimum KB bootstrap, so `project.md / overview.md / preferences.md / history/index.md` are created on the first run
+- `preferences.md` may be created as an empty skeleton first, but actual preferences should still be written only for explicit long-term statements
+
 ---
 
 ## Project Context Acquisition

README.md

@@ -155,6 +155,11 @@ bash scripts/check-runtime-smoke.sh
 
 预期结果：
 
+- 首次运行会初始化最小 KB 骨架：
+  - `.sopify-skills/project.md`
+  - `.sopify-skills/wiki/overview.md`
+  - `.sopify-skills/user/preferences.md`
+  - `.sopify-skills/history/index.md`
 - 生成 `.sopify-skills/plan/`
 - 更新 `.sopify-skills/state/`
 - 写入 `.sopify-skills/replay/`
@@ -168,6 +173,8 @@ bash scripts/check-runtime-smoke.sh
   - `scripts/go_plan_runtime.py`：plan-only helper
 - 已提供 `scripts/sync-runtime-assets.sh`，用于把 runtime bundle 同步到目标仓库的 `.sopify-runtime/`
 - `.sopify-runtime/` bundle 内已包含便携 `tests/test_runtime.py` 与 `scripts/check-runtime-smoke.sh`
+- 当前 `P1-A` 已落地：首次运行会 bootstrap 最小 KB 骨架，但还不包含选择性历史回收或 history 归档
+- 当前 KB 快照只读取根配置、manifest 与顶层目录，不做源码级扫描
 - 不属于本轮发布切片：`~compare` 的通用入口自动桥接、`workflow-learning` 的独立 runtime helper、`~go exec` develop bridge
 - 因此当前已经适合“自用 + 二次接入”，但仍不是完整宿主安装器形态
 

README_EN.md

@@ -155,6 +155,11 @@ bash scripts/check-runtime-smoke.sh
 
 Expected result:
 
+- first run bootstraps the minimum KB skeleton:
+  - `.sopify-skills/project.md`
+  - `.sopify-skills/wiki/overview.md`
+  - `.sopify-skills/user/preferences.md`
+  - `.sopify-skills/history/index.md`
 - generate `.sopify-skills/plan/`
 - update `.sopify-skills/state/`
 - write `.sopify-skills/replay/`
@@ -168,6 +173,7 @@ Current boundary:
   - `scripts/go_plan_runtime.py`: plan-only helper
 - `scripts/sync-runtime-assets.sh` can now sync the runtime bundle into `.sopify-runtime/` in another repository
 - the `.sopify-runtime/` bundle already includes portable `tests/test_runtime.py` and `scripts/check-runtime-smoke.sh`
+- `P1-A` is now landed: the first runtime execution bootstraps the minimum KB skeleton, but this still does not include selective history recovery or history archive
 - not part of this release slice: generic-entry auto-bridge for `~compare`, a standalone `workflow-learning` runtime helper, and the `~go exec` develop bridge
 - the current shape now fits self-use and secondary integration, but it is still not a full host-side installer flow