diff --git a/.blueprint/manifest.yaml b/.blueprint/manifest.yaml index f28a131..a3642d8 100644 --- a/.blueprint/manifest.yaml +++ b/.blueprint/manifest.yaml @@ -368,8 +368,9 @@ modules: - id: onboarding-pack name: 接入包 area: backend - status: done - progress: 100 + status: in_progress + progress: 90 + note: "新增体系分发主线(2026-07-03):T1 模板版本化(前置)→ B1-B4 agent 按钮体系四资产" position: [3500, 0] - id: gitea-integration diff --git a/.blueprint/modules/onboarding-pack.md b/.blueprint/modules/onboarding-pack.md index 1ad208a..22932b1 100644 --- a/.blueprint/modules/onboarding-pack.md +++ b/.blueprint/modules/onboarding-pack.md @@ -98,12 +98,16 @@ - files: src-tauri/src/commands/onboarding.rs, src-tauri/src/commands/commit_metrics.rs - acceptance: OnboardingReport 与飞轮展示标注该项目 commit 规范化比例(conventional / 总数);比例低时提示"种 lefthook 后数据才准",避免脏数据被误读为可信(CI 过滤 / 非规范单列已在 C1 落实) -### 💭 接入包模板演进分发(MANAGED 块化) -- status: concept -- notes: 现状「文件存在即跳过、绝不覆盖」保护了用户定制,但代价是模板演进(如 2026-07-02 git-workflow 新增 Rules-Applied trailer 章节)无法触达存量项目,只能手工补(enterprise-system 已手工补过一次)。方案方向:给 git-workflow.md 引入 ONBOARDING_MANAGED 块(同 CLAUDE.md 的 BLUEPRINT_MANAGED 机制)——炼境管理区可原位升级、块外用户自由区永不触碰;lefthook.yml 因用户深度定制(monorepo filter 等)不适用块机制,改为版本注释+差异提示。 +### 📋 T1. 接入包模板版本化(ONBOARDED_MANAGED 块机制)【体系分发前置】 +- status: todo +- complexity: M +- files: src-tauri/src/commands/onboarding.rs, src-tauri/resources/onboarding/git-workflow.md.tmpl, src-tauri/resources/onboarding/AGENTS.md.tmpl +- acceptance: git-workflow 与 AGENTS.md 模板的炼境管理内容包进 ONBOARDING_MANAGED 标记块(带 version);分发逻辑三态:文件不存在→写全新;存在且有标记→原位更新块(复用 blueprint.rs 的 upsert_managed_block 模式,可提取公共函数);存在无标记→末尾追加块;块外用户内容永不触碰;lefthook.yml 保持"存在即跳过"(用户深度定制不适用块机制);单元测试覆盖三态 + 用户区保护;对 enterprise-system 重跑接入包实测存量升级 -### 💭 agent 按钮体系分发(让子项目出厂即带双投影范式) -- status: concept +> 背景:模板演进无法触达存量项目是版本化闭环的最大缺口(trailer 章节曾手工补)。 + +### 📋 agent 按钮体系分发(B1/B2 可派发,B3/B4 待拆) +- status: planned - 版本化闭环要求(2026-07-03 用户澄清,体系分发的灵魂): 分发不是"发了就不管"——每类资产带版本分发 → 子项目按该版本实践产生经验(成功/失败)→ 经验自吸反哺炼境(trailer/failure_cases/复盘/返工率)→ 按版本分组对比效果 → 修订出新版 → 再分发。CONVENTIONS 是模范生(version+队列对比+梦核+同步,1.8→1.9 已跑通一整圈);B 系列每类资产按此标准建闭环。**前置依赖提升**:「接入包模板演进分发(MANAGED 块化)」concept 卡——模板无版本机制是当前最大缺口,没有它体系 v2 到不了存量项目 - notes: 2026-07-03 概念探讨收束后的分发需求(体系详见 memory concept_dual_projection 与 mcp-server 模块 concept 卡)。用户全 agent 开发形态下,"给开发者立规范"="给 agent 注入规范",可完全机器化。四条现成管道分发四类资产:① B1(S) CONVENTIONS 1.10.0 加 R12 边界单点实现 + R13 验收须真实走通验证路径 + 载体选择原则;② B2(S) 接入包 AGENTS.md 模板加 agent 按钮章节(三要素/载体谱系/侦察驻军);③ B3(M) init/sync 提示词升级——建蓝图时声明项目按钮载体、acceptance 生成为可执行验证路径格式;④ B4(S,后置) 健康诊断加体系遵守度检查。移植体验=零新增动作,接入流程不变。