From 05d76739901f11c78e85aa4e0ad1751417cb4d3b Mon Sep 17 00:00:00 2001 From: lanrtop Date: Sat, 4 Jul 2026 13:44:02 +0900 Subject: [PATCH] =?UTF-8?q?feat(onboarding):=20T2+B3=20=E5=A4=8D=E6=9D=82?= =?UTF-8?q?=E5=BA=A6=E6=84=9F=E7=9F=A5=E5=88=86=E6=94=AF=E7=AD=96=E7=95=A5?= =?UTF-8?q?=20+=20agent=20=E6=8C=89=E9=92=AE=E8=BD=BD=E4=BD=93=E5=A3=B0?= =?UTF-8?q?=E6=98=8E=E4=BD=93=E7=B3=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit T2 git-workflow 模板升 v1.3.0: - 分支策略从强制 dev→main 改为复杂度感知 （简单改动直推 main/master，功能性改动开 feat/ 分支+PR） - PR 创建 MCP 示例 head 从 "dev" 改为 "feat/" B3 agent 按钮载体声明闭环: - CONVENTIONS.md manifest.yaml 规范新增 agent_button_carrier 字段 （tauri/http/cli/playwright，新建蓝图时必填） - splitter SKILL.md 三级优先载体继承：manifest字段 > architect声明 > 就近推断 - 炼境自身 manifest.yaml 补 agent_button_carrier: tauri - AGENTS.md.tmpl 项目概况 TODO 提示新增载体字段填写指引 Rules-Applied: R04,R13 --- .blueprint/CONVENTIONS.md | 14 ++++++++++++- .blueprint/manifest.yaml | 3 ++- .blueprint/modules/onboarding-pack.md | 12 ++++++----- .claude/skills/splitter/SKILL.md | 5 ++++- src-tauri/resources/onboarding/AGENTS.md.tmpl | 2 ++ .../resources/onboarding/git-workflow.md.tmpl | 21 +++++++++++-------- 6 files changed, 40 insertions(+), 17 deletions(-) diff --git a/.blueprint/CONVENTIONS.md b/.blueprint/CONVENTIONS.md index bcb6030..57d3da2 100644 --- a/.blueprint/CONVENTIONS.md +++ b/.blueprint/CONVENTIONS.md @@ -161,10 +161,22 @@ concept 卡是想法 inbox，**不要求 files / acceptance / complexity**，随 ```yaml version: 1 name: 项目名称 -iteration: 1 # 当前迭代号（默认 1，重构已完成模块时手动递增） +iteration: 1 # 当前迭代号（默认 1，重构已完成模块时手动递增） updated: YYYY-MM-DD +agent_button_carrier: tauri # 项目主验证载体（见下方说明），新建蓝图时必填 ``` +**`agent_button_carrier` 取值**（就近原则，与 AGENTS.md 载体谱系对应）： + +| 值 | 适用场景 | 对应验证方式 | +|----|---------|-------------| +| `tauri` | Tauri 桌面应用 | `cargo test` / Tauri command 函数 | +| `http` | Web 服务 / REST API | `curl` / HTTP 端点 | +| `cli` | CLI 工具 / npm scripts | 命令行调用 | +| `playwright` | 纯 UI 呈现层（最后手段） | Playwright 真界面驱动 | + +> 新建蓝图时 AI 必须根据技术栈自动推断并填入此字段。`splitter` 生成任务卡时直接从此字段继承载体，无需每次重新推断。 + ### 模块字段 ```yaml diff --git a/.blueprint/manifest.yaml b/.blueprint/manifest.yaml index b6b0eaa..8493f46 100644 --- a/.blueprint/manifest.yaml +++ b/.blueprint/manifest.yaml @@ -7,6 +7,7 @@ description: > 形成可自我进化的开发智能闭环。 iteration: 1 updated: 2026-07-04 +agent_button_carrier: tauri @@ -370,7 +371,7 @@ modules: area: backend status: in_progress progress: 99 - note: "体系分发主线：T1/B1/B2/B3/V1 ✅（V1 2026-07-04：lefthook 分发即激活 + verify_onboarding 六项检查链）；剩 B4 健康诊断遵守度（后置）" + note: "体系分发主线：T1/T2/B1/B2/B3/V1 ✅（T2 2026-07-04：git-workflow 复杂度感知分支策略；B3 2026-07-04：manifest agent_button_carrier + splitter 三级载体继承）；剩 B4 健康诊断遵守度（后置）" position: [3500, 0] - id: gitea-integration diff --git a/.blueprint/modules/onboarding-pack.md b/.blueprint/modules/onboarding-pack.md index ebdf0c0..40e58f2 100644 --- a/.blueprint/modules/onboarding-pack.md +++ b/.blueprint/modules/onboarding-pack.md @@ -117,16 +117,18 @@ - acceptance: [Tauri command] apply_onboarding_pack(project_id) 分发 lefthook.yml 后检测并激活 hook——找到 lefthook 可执行（node_modules/.bin/ 或 PATH）→ 执行 lefthook install，OnboardingReport 新增 hook_activated 三态（activated / missing_binary / failed），missing_binary 时附安装提示；[MCP tool] verify_onboarding(project_id) → 返回检查链 JSON（模板管理块版本到位 / .git/hooks/pre-commit 含 lefthook / origin 指向 Gitea / CI workflow 文件存在 / commit_metrics 近 30 天有该项目数据），每项 pass|fail + detail，无 error 字段；[cargo test] 检查链判定逻辑纯函数化，覆盖 hook 已挂/未挂、origin 匹配/不匹配（R06/R07） - notes: 背景（2026-07-04 侦察确认）——接入包写 lefthook.yml 后从不激活，文件在 hook 死 → conventional 不强制 → 飞轮数据脏；炼境自身未踩纯因手动装过。本卡补两件事：① 分发即激活；② "消费者角色"机器化验证（分发成功 ≠ 功能生效，对应 agent-button-system.md 消费者驱动验证）。产出直接供 B4 健康诊断遵守度消费。同日发现的姊妹雷：cicd.rs PR CI 模板 pnpm lint --if-present 必挂语法已修（dc501f7，回归断言驻军） -### 🔵 T2. git-workflow 模板：分支策略升级为复杂度感知 +### ✅ T2. git-workflow 模板：分支策略升级为复杂度感知 - complexity: M -- status: in_progress +- status: done +- done_note: 2026-07-04 完成。模板 ONBOARDING_MANAGED 升至 v1.3.0，分支策略改为复杂度感知（简单改动直推 main/master，功能性改动开 feat/ 分支+PR），PR MCP 示例 head 从 "dev" 改为 "feat/" - files: src-tauri/resources/onboarding/git-workflow.md.tmpl - acceptance: [Tauri command] 对已接入项目重跑接入包 → git-workflow.md ONBOARDING_MANAGED 块升至 v1.3.0，内容含「简单改动直推 main/master，功能性改动开 feat/ 分支 + PR」策略；PR 创建 MCP 示例 head 字段从 "dev" 改为 "feat/"；docs/templates/agents-meta-rules.md 不含分支策略无需同步 - notes: 当前模板强制 dev→main 双分支，假设了任意项目都维护常设 dev 分支，实为过度约束。复杂度感知策略（小改直推 main/master，功能性改动开 feat/* + PR）与炼境自身策略一致、与飞轮目标对齐（PR body 是意图层数据），且对单人小项目更友好——不必维护无意义的常设 dev 分支。「简单/功能性」由 agent 根据改动文件数/性质自判，无需外部蓝图标签 -### 🔵 agent 按钮体系分发（B1/B2 已完成，B3/B4 待做） -- status: in_progress -- progress: 2026-07-03 B1 done——CONVENTIONS 1.10.0 加 R12（边界单点实现）+ R13（M/L 验收路径须真实走通，含载体就近选择表）；B2 done——AGENTS.md.tmpl v1.1.0 管理块含「agent 按钮与验证路径」章节（双投影/边界单点/载体表/完成的定义/侦察→驻军）。剩 B3（提示词升级，M，单独一轮）、B4（健康诊断遵守度，后置） +### ✅ agent 按钮体系分发（B1/B2/B3 已完成，B4 后置） +- status: done +- done_note: 2026-07-04 B3 完成——CONVENTIONS.md manifest.yaml 规范新增 agent_button_carrier 字段（tauri/http/cli/playwright 四值）+ 必填规则；splitter SKILL.md 优先从 manifest 读取载体（三级优先：manifest字段>architect声明>就近推断）；炼境自身 manifest.yaml 补上 `agent_button_carrier: tauri`；AGENTS.md.tmpl 项目概况 TODO 提示新增该字段填写指引。B4 健康诊断遵守度后置。 +- progress: 2026-07-03 B1 done——CONVENTIONS 1.10.0 加 R12（边界单点实现）+ R13（M/L 验收路径须真实走通，含载体就近选择表）；B2 done——AGENTS.md.tmpl v1.1.0 管理块含「agent 按钮与验证路径」章节（双投影/边界单点/载体表/完成的定义/侦察→驻军）。B3 done 2026-07-04（见 done_note） - 版本化闭环要求（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,后置) 健康诊断加体系遵守度检查。移植体验=零新增动作，接入流程不变。 diff --git a/.claude/skills/splitter/SKILL.md b/.claude/skills/splitter/SKILL.md index 83bbff6..aaa49db 100644 --- a/.claude/skills/splitter/SKILL.md +++ b/.claude/skills/splitter/SKILL.md @@ -32,7 +32,10 @@ allowed-tools: Read, Edit, Write, Glob **可派发标准（每张卡必须满足）** - `files`：明确列出涉及文件的相对路径 - `acceptance`：**可执行验证路径**，格式：`[载体] 调用/运行什么(参数) → 断言什么` - - 载体从 architect 的「验证路径」声明继承，就近选择：Tauri command / HTTP API / CLI / Playwright + - **载体来源（优先级）**： + 1. 先读 `.blueprint/manifest.yaml` 的 `agent_button_carrier` 字段 + 2. 无此字段时，从当前对话中 `/architect` 的「验证路径」声明继承 + 3. 两者都没有时，就近推断：Tauri 桌面应用 → `cargo test`，Web 服务 → HTTP API，CLI → 命令行 - 断言要具体（检查字段值、返回码、文件存在、数量 > 0），不写模糊的"功能正常" - 示例：`[Tauri command] apply_onboarding_pack(project_id) → 返回 written≥1，磁盘上文件存在` - 示例：`[HTTP API] POST /api/projects → 201，body.id 非空` diff --git a/src-tauri/resources/onboarding/AGENTS.md.tmpl b/src-tauri/resources/onboarding/AGENTS.md.tmpl index a89b2a2..bbd881b 100644 --- a/src-tauri/resources/onboarding/AGENTS.md.tmpl +++ b/src-tauri/resources/onboarding/AGENTS.md.tmpl @@ -7,6 +7,8 @@ ## 项目概况 + ## 架构与模块 diff --git a/src-tauri/resources/onboarding/git-workflow.md.tmpl b/src-tauri/resources/onboarding/git-workflow.md.tmpl index 56b421c..13754ef 100644 --- a/src-tauri/resources/onboarding/git-workflow.md.tmpl +++ b/src-tauri/resources/onboarding/git-workflow.md.tmpl @@ -3,19 +3,22 @@ > 把此文件粘贴给任何 AI Agent，让它了解本项目的 git 工作方式。由炼境接入包分发。 > `ONBOARDING_MANAGED` 标记块由炼境版本化管理（重跑接入包可原位升级），块外可自由补充项目特有约定。 - + -## 分支策略 +## 分支策略（复杂度感知） ``` -dev ← 日常开发在这里 commit/push - ↓ -main ← 稳定分支，通过 PR 合入（合入时触发 CI code review） +main/master ← 主分支，保持稳定 + ↑ + ├── 简单改动 → 直接 push main/master + └── 功能性改动 → feat/ 分支 → PR → main/master ``` -- 小改动可直接 push `dev` -- 功能完整后开 PR（dev → main） -- 不要直接 push `main`，除非紧急热修复 +**简单改动（直接推主分支）**：bug fix、chore、docs、style、单文件小改，行为对外无变化。 + +**功能性改动（开 feat/* 分支 + PR）**：新功能、重构、涉及多模块的 refactor。由 agent 根据改动文件数和性质自判，无需蓝图标签。 + +分支命名：`feat/<功能简述>`，如 `feat/login-sms`、`feat/order-pagination`。 ## Commit 规范（lefthook 强制） @@ -81,7 +84,7 @@ PR 别攒太大（建议每 3~5 个 commit 或几百行内就开一次），否 ``` 1. Read .claude/liangjing.json → 取出 project_id 2. 调用 MCP 工具 create_pull_request： - { "project_id": "", "head": "dev", "base": "main", + { "project_id": "", "head": "feat/", "base": "main", "title": "", "body": "<变更摘要>" } 3. 炼境内部用存储的 Gitea 凭证调 API，返回 pr_url ```