chore: pre-launch consolidation — diagrams, docs, CI fixes

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,13 @@
+---
+name: Bug Report
+about: Report a bug
+labels: bug
+---
+
+**Describe the bug**
+
+**Steps to reproduce**
+
+**Expected behavior**
+
+**Environment** (host, OS, Sopify version)

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,11 @@
+---
+name: Feature Request
+about: Suggest an idea
+labels: enhancement
+---
+
+**Is your feature request related to a problem?**
+
+**Describe the solution you'd like**
+
+**Additional context**

.sopify-skills/blueprint/README.md

@@ -14,6 +14,7 @@
 
 <!-- sopify:auto:focus:start -->
 - 当前活动 plan：`../plan/20260529_pre_launch_consolidation/`（推广前大收口整合，7 方向 4 波次）。
+- 进度：Wave A（首次触达）✅ 完成；Wave B（文档/仓库）进行中（4.8 SVG 重画待做）；Wave C/D 待开始。
 - history 归档：已可用；最近归档为 `../history/2026-05/20260528_output_contract_enforcement`。
 <!-- sopify:auto:focus:end -->
 

.sopify-skills/history/2026-03/20260320_kb_layout_v2/tasks.md

@@ -164,10 +164,10 @@ knowledge_sync:
   - 明确 `project.md` 的职责边界，不与 `background/design` 重复
   - `blueprint/README.md` 最多保留轻量入口表：`Entry | Meaning | Status`
   - `blueprint/design.md` 以消费契约表固定 profile：`Context Profile | Reads | Fail-open Rule | Notes`
-- [x] 6.3 更新 `/Users/weixin.li/.codex/skills/sopify/kb/SKILL.md`
-- [x] 6.4 更新 `/Users/weixin.li/.codex/skills/sopify/templates/SKILL.md`
-- [x] 6.5 更新 `/Users/weixin.li/.codex/skills/sopify/develop/references/develop-rules.md`
-- [x] 6.6 更新 `/Users/weixin.li/.codex/skills/sopify/develop/assets/output-success.md`
+- [x] 6.3 更新 `skills/zh/skills/sopify/kb/SKILL.md`
+- [x] 6.4 更新 `skills/zh/skills/sopify/templates/SKILL.md`
+- [x] 6.5 更新 `skills/zh/skills/sopify/develop/references/develop-rules.md`
+- [x] 6.6 更新 `skills/zh/skills/sopify/develop/assets/output-success.md`
 - [x] 6.7 若需要，同步 `Codex/Skills/*` 与 `Claude/Skills/*` 中对 KB 结构的描述
 - [x] 6.8 把“方案评分”固定纳入方案包输出模板或生成约定
 

.sopify-skills/history/2026-03/20260320_preferences-preload-v1/background.md

@@ -2,7 +2,7 @@
 
 ## 需求背景
 
-当前仓库已经有 [`preferences.md`](/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/.sopify-skills/user/preferences.md) 作为长期偏好落点，但它还没有成为稳定的 LLM 输入源。
+当前仓库已经有 [`preferences.md`](.sopify-skills/user/preferences.md) 作为长期偏好落点，但它还没有成为稳定的 LLM 输入源。
 
 这意味着：
 
@@ -94,7 +94,7 @@
 2. 当 `preferences.md` 缺失或异常时，Sopify 主链路仍可继续
 3. 当 `preferences.md` 可读时，LLM 收到稳定、可复用的偏好注入块
 4. 当前显式任务能覆盖长期偏好，长期偏好能覆盖默认规则
-5. 文档口径在 blueprint、[`README.md`](/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/README.md) 与 [`README_EN.md`](/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/README_EN.md) 中保持一致
+5. 文档口径在 blueprint、[`README.md`](README.md) 与 [`README_EN.md`](README_EN.md) 中保持一致
 
 ## 风险评估
 

.sopify-skills/history/2026-03/20260320_preferences-preload-v1/tasks.md

@@ -59,8 +59,8 @@ archive_ready: true
 ## 3. 文档对齐
 
 - [x] 3.1 blueprint 已补齐 `preferences-preload-v1` 的背景、设计与任务口径
-- [x] 3.2 [`README.md`](/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/README.md) 已补齐中文宿主接入口径
-- [x] 3.3 [`README_EN.md`](/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/README_EN.md) 已同步英文宿主接入口径
+- [x] 3.2 [`README.md`](README.md) 已补齐中文宿主接入口径
+- [x] 3.3 [`README_EN.md`](README_EN.md) 已同步英文宿主接入口径
 - [x] 3.4 实现阶段补充对应测试说明与必要代码注释，确保机器契约可维护
 
 验收标准：

.sopify-skills/history/2026-03/20260321_go-plan/pilot_sample_matrix.md

@@ -15,14 +15,14 @@ This is a candidate pool for the first round, not the final scored pilot report.
 
 ## Environment Mapping
 
-- `runtime/infra`: `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills`
-- `business`: `/Users/weixin.li/NIO_Project/EQUITY/freyr-h5pages`
-- `sdk/tool + quick-fix/control`: `/Users/weixin.li/NIO_Project/rs-sdk`
+- `runtime/infra`: `<project-root>`
+- `business`: `<external-project>`
+- `sdk/tool + quick-fix/control`: `<external-project>`
 
 Backup pools, not counted in the first 45:
 
-- `/Users/weixin.li/NIO_Project/EQUITY/equity-front-ai-demo/equity-front`
-- `/Users/weixin.li/NIO_Project/EQUITY/freyr-cards`
+- `<external-project>`
+- `<external-project>`
 
 ## Allocation Summary
 

.sopify-skills/history/2026-03/20260321_go-plan/tasks.md

@@ -21,14 +21,14 @@ decision_checkpoint:
 目录: `.sopify-skills/plan/20260321_go-plan/`
 
 ## 1. workspace pilot
-- [x] 1.1 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/.sopify-skills/user/preferences.md` 中补充“第一性原理 + 两段式输出”作为当前 workspace 长期偏好试运行版。
+- [x] 1.1 在 `.sopify-skills/user/preferences.md` 中补充“第一性原理 + 两段式输出”作为当前 workspace 长期偏好试运行版。
 - [x] 1.2 校验该偏好只通过 preload 注入，不改变 `project.md`、blueprint 或 runtime machine contract。
 - [x] 1.3 把“深度交互只在明显信号命中时触发”写成可执行文案，并与 `preferences.md` 的风格规则解耦。
 - [x] 1.4 明确一条回滚规则：若发现对 quick-fix 或 consult 过重，可直接回退 preference 文本而不影响底层能力。
 
 ## 2. analyze 提炼通用子集
-- [x] 2.1 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/Codex/Skills/CN/skills/sopify/analyze/references/analyze-rules.md` 中加入 4 个稳定能力：目标/路径分离、目标模糊先澄清、次优路径给替代、SMART 成功标准收口。
-- [x] 2.2 同步 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/Codex/Skills/EN/skills/sopify/analyze/references/analyze-rules.md`，保证中英文规则语义一致。
+- [x] 2.1 在 `Codex/Skills/CN/skills/sopify/analyze/references/analyze-rules.md` 中加入 4 个稳定能力：目标/路径分离、目标模糊先澄清、次优路径给替代、SMART 成功标准收口。
+- [x] 2.2 同步 `Codex/Skills/EN/skills/sopify/analyze/references/analyze-rules.md`，保证中英文规则语义一致。
 - [x] 2.3 运行 `bash scripts/sync-skills.sh` 与 `bash scripts/check-skills-sync.sh`，把改动同步到 `Claude/Skills/{CN,EN}` 镜像并检查无漂移。
 
 ## 3. promotion gate
@@ -44,29 +44,29 @@ decision_checkpoint:
 - [x] 4.3 用至少 3 类仓库或等价样本跑 pilot，输出一轮可审计评估结果（`45` 样本 / `3` 类环境已完成，聚合结果写入 `external_archive://pilot_round1/round1_aggregation.md`；Batch 2/3 先按 post-v1 校准执行，随后已被吸收进独立 decision pass，不再以半完成状态挂在本轮 plan 上）。
 
 ## 5. 文档
-- [x] 5.1 更新 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/README.md` 与 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/README_EN.md`，补充“分层矩阵”和“何时提升到底层”的说明。
+- [x] 5.1 更新 `README.md` 与 `README_EN.md`，补充“分层矩阵”和“何时提升到底层”的说明。
 - [x] 5.2 如最终采纳 analyze 子集，补充 blueprint 或 changelog，记录这是“从 workspace preference 提炼出的稳定默认能力”，而不是一次性风格指令。
 
 ## 6. 独立 Issue: 元评审不应生成新 plan
-- [x] 6.1 以 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/.sopify-skills/plan/20260321_go-plan/issue_meta_review_no_new_plan.md` 作为独立 issue 文档，记录现象、根因假设、范围与验收标准。
-- [x] 6.2 单独评估 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/router.py` 中 runtime-first guard 与 consultation 判定的顺序和关键词边界。
+- [x] 6.1 以 `.sopify-skills/plan/20260321_go-plan/issue_meta_review_no_new_plan.md` 作为独立 issue 文档，记录现象、根因假设、范围与验收标准。
+- [x] 6.2 单独评估 `runtime/router.py` 中 runtime-first guard 与 consultation 判定的顺序和关键词边界。
 - [x] 6.3 设计至少 3 个回归样本：plan 评分、plan 追问、plan 风险复核，确保这类元评审不再生成新的 scaffold plan。
 
 ## 7. 独立 Issue: 严格单 active plan + topic_key 元数据
-- [x] 7.1 以 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/.sopify-skills/plan/20260321_go-plan/issue_single_active_plan_reuse_with_topic_key.md` 作为独立 issue 文档，固定 canonical active plan、复用优先级、topic_key 元数据边界和验收标准。
-- [x] 7.2 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/engine.py` 中实现严格单 active plan 规则：默认复用当前 active plan，只有显式新建或显式切换时才允许新 scaffold。
-- [x] 7.3 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/plan_scaffold.py` 与 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/models.py` 中补充 `topic_key` 元数据和现有 plan 读取能力；当前版本不启用 no-active-plan 自动匹配。
-- [x] 7.4 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/router.py` 中为 active-plan 元评审增加 consultation 旁路，避免 process-semantic review 再次误触发 workflow scaffold。
-- [x] 7.5 补充 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/tests/test_runtime.py` 回归样本，覆盖 active plan 复用、显式切换、无 active plan 不自动复用、meta-review 不新建 plan。
+- [x] 7.1 以 `.sopify-skills/plan/20260321_go-plan/issue_single_active_plan_reuse_with_topic_key.md` 作为独立 issue 文档，固定 canonical active plan、复用优先级、topic_key 元数据边界和验收标准。
+- [x] 7.2 在 `runtime/engine.py` 中实现严格单 active plan 规则：默认复用当前 active plan，只有显式新建或显式切换时才允许新 scaffold。
+- [x] 7.3 在 `runtime/plan_scaffold.py` 与 `runtime/models.py` 中补充 `topic_key` 元数据和现有 plan 读取能力；当前版本不启用 no-active-plan 自动匹配。
+- [x] 7.4 在 `runtime/router.py` 中为 active-plan 元评审增加 consultation 旁路，避免 process-semantic review 再次误触发 workflow scaffold。
+- [x] 7.5 补充 `tests/test_runtime.py` 回归样本，覆盖 active plan 复用、显式切换、无 active plan 不自动复用、meta-review 不新建 plan。
 - [x] 7.6 将 `.sopify-skills/state/current_plan.json`、`.sopify-skills/state/current_run.json` 与 `.sopify-skills/state/current_handoff.json` 重新绑定到 canonical plan `20260321_go-plan`，并把重复 plan 视为 superseded 待合并目录。
 - [x] 7.7 将 `20260321_v1-preferences-md-analyze`、`20260321_task-ba2454`、`20260321_task-a93812` 的有效语义回收进 canonical plan，并在 issue 文档中记录 merged provenance。
 - [x] 7.8 删除已完成语义回收的重复 plan 目录，不把它们写入正式 `history/index.md`。
 
 ## 8. 独立 Issue: 从 7/10 提升到 8.5+ 的最小补丁
-- [x] 8.1 以 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/.sopify-skills/plan/20260321_go-plan/issue_raise_plan_reuse_fix_to_8_5.md` 作为独立 issue 文档，固定残留问题、最小修补边界、验收标准与验证顺序。
-- [x] 8.2 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/engine.py` 中为 planning clarification 引入与 decision 分支一致的 active-plan preserve / rebind 逻辑，避免 clarification 期间无条件丢失 `current_plan`。
-- [x] 8.3 在 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/runtime/plan_scaffold.py` 中收紧 `explicit new plan` 文案边界，去掉 `其他 plan` 这类高歧义模式，保留真正的新建强信号。
-- [x] 8.4 补充 `/Users/weixin.li/Desktop/vs-code-extension/sopify-skills/tests/test_runtime.py` 回归样本，至少覆盖：clarification 后复用 active plan、显式新建仍生效、包含“其他 plan”的评审语句不误触发新 scaffold。
+- [x] 8.1 以 `.sopify-skills/plan/20260321_go-plan/issue_raise_plan_reuse_fix_to_8_5.md` 作为独立 issue 文档，固定残留问题、最小修补边界、验收标准与验证顺序。
+- [x] 8.2 在 `runtime/engine.py` 中为 planning clarification 引入与 decision 分支一致的 active-plan preserve / rebind 逻辑，避免 clarification 期间无条件丢失 `current_plan`。
+- [x] 8.3 在 `runtime/plan_scaffold.py` 中收紧 `explicit new plan` 文案边界，去掉 `其他 plan` 这类高歧义模式，保留真正的新建强信号。
+- [x] 8.4 补充 `tests/test_runtime.py` 回归样本，至少覆盖：clarification 后复用 active plan、显式新建仍生效、包含“其他 plan”的评审语句不误触发新 scaffold。
 - [x] 8.5 继续使用 `python3 -m unittest` 跑相关子集，覆盖 `PlanReuseRuntimeTests`、`RouterTests`、`EngineIntegrationTests` 的新增样本。
 - [x] 8.6 允许安装 `pytest` 并补跑 `python3 -m pytest -q tests/test_runtime.py`，确保测试入口不再只依赖 `unittest`。