docs(conventions): v1.11.0——同步使者回传的四项治理修复

- Session 结束汇总加限定语,不得作为跳过确认卡的通道
- acceptance 格式补 agent_verify/human_verify 分层说明
- 阶段2末尾引用 AGENTS.md 需求对齐协议(Bug Fix/Feature 分类)
- Rust/Tauri 专属章节顶部加 scope 前置提示,避免污染 web 项目
- lefthook.yml.tmpl:API typecheck 注释由警告升级为 REQUIRED 措辞
This commit is contained in:
lanrtop 2026-07-15 12:16:31 +09:00
parent 8c746cf8d5
commit be2f69578a
2 changed files with 15 additions and 5 deletions

View File

@ -1,6 +1,6 @@
--- ---
version: 1.10.0 version: 1.11.0
updated: 2026-07-03 updated: 2026-07-15
source: dev-manager-tauri source: dev-manager-tauri
--- ---
@ -136,6 +136,11 @@ acceptance 是 agent 自验的唯一判断依据,必须是**可执行断言**
最小结构:`[载体] 调用/运行什么(参数) → 断言什么`。 最小结构:`[载体] 调用/运行什么(参数) → 断言什么`。
**含 UI 操作路径时必须分层**
- `agent_verify:` — 机器可断言函数返回值、HTTP 状态码、数据库记录stop hook / CI 只验此段
- `human_verify:` — 需人眼判断视觉效果、拖拽手势、动画30 秒浏览器终验
纯命令行 / API 任务可省略 `human_verify:`UI 拖拽 / 视觉类必须拆,否则 stop hook 无法收敛。
含 Rust 业务逻辑的 M/L 卡acceptance 还须包含(详见 Rust 代码可测试性规范): 含 Rust 业务逻辑的 M/L 卡acceptance 还须包含(详见 Rust 代码可测试性规范):
- `cargo test 通过` + 依赖注入写法确认 - `cargo test 通过` + 依赖注入写法确认
@ -304,6 +309,8 @@ Claude 在每次对话中应遵循以下流程:
| "开始做 XX" | 模块 status → in_progress | | "开始做 XX" | 模块 status → in_progress |
| "为什么选这个方案" | 记录到模块的 `## 决策记录` | | "为什么选这个方案" | 记录到模块的 `## 决策记录` |
> 开始写代码前,先判断改动类型:**Bug Fix**(意外偏差,直接执行)还是 **Feature**(新增能力/主动改变行为,必须先输出确认卡等触发词)。完整触发规则见 AGENTS.md「需求对齐协议」章节。
### 阶段 3实现功能 — 两阶段执行锁 ### 阶段 3实现功能 — 两阶段执行锁
任务卡执行遵循**两阶段提交**开始写第一行代码前加锁信息1全部完成后解锁信息2。只有信息1没有信息2说明任务被中断。 任务卡执行遵循**两阶段提交**开始写第一行代码前加锁信息1全部完成后解锁信息2。只有信息1没有信息2说明任务被中断。
@ -373,7 +380,7 @@ Claude 应关注这些信号来决定是否更新蓝图:
> B) 现在拉清单,走 /architect 重新规划 > B) 现在拉清单,走 /architect 重新规划
> C) 继续执行,我在 session 结束前汇总成任务卡 > C) 继续执行,我在 session 结束前汇总成任务卡
**Session 结束汇总**:任何有代码改动但无预建任务卡的会话,结束前 Claude 应输出 **Session 结束汇总**(仅适用于漂移检测触发后用户主动选择 C 选项的场景,**不得作为跳过确认卡的通道**
> 📋 本次会话实际改动:[文件列表 + 简述] > 📋 本次会话实际改动:[文件列表 + 简述]
> 是否整理为蓝图任务卡? > 是否整理为蓝图任务卡?
@ -638,6 +645,8 @@ cp -r .claude/skills/splitter ~/.claude/skills/
## Rust 代码可测试性规范 ## Rust 代码可测试性规范
> ⚠️ **本节仅适用于 Tauri / Rust 项目**,非 Tauri 项目跳过本节全部内容。
> 本规范仅适用于**新增** Rust 函数,存量代码不强制回填。 > 本规范仅适用于**新增** Rust 函数,存量代码不强制回填。
### 强制规则 ### 强制规则

View File

@ -9,8 +9,9 @@ pre-commit:
typecheck: typecheck:
glob: "*.{ts,tsx}" glob: "*.{ts,tsx}"
run: pnpm typecheck run: pnpm typecheck
# ⚠️ 如果项目有 API / 后端层,必须在此补对应的 typecheck——否则后端类型错误不会被拦截。 # 🚨 【必填项】项目有 API / 后端层时,必须取消注释并按实际路径配置——
# 取消注释并按实际填写(留多余示例行删掉即可): # 否则后端类型错误不会被 pre-commit 拦截(前端 typecheck 只覆盖 src/ 层)。
# 按实际填写一行,其余示例行可删掉:
# api-typecheck: # api-typecheck:
# glob: "api/**/*.{ts,tsx}" # glob: "api/**/*.{ts,tsx}"
# run: pnpm --filter api typecheck # monorepo workspace # run: pnpm --filter api typecheck # monorepo workspace