diff --git a/src-tauri/resources/onboarding/git-workflow.md.tmpl b/src-tauri/resources/onboarding/git-workflow.md.tmpl
index ce6dade..f707e4a 100644
--- a/src-tauri/resources/onboarding/git-workflow.md.tmpl
+++ b/src-tauri/resources/onboarding/git-workflow.md.tmpl
@@ -40,6 +40,21 @@ git commit -m "fix(api/user): 修正分页 off-by-one"
 > 炼境会解析这些 commit 的 type/scope 作为飞轮数据：`fix` 计入返工率、`scope` 归到模块。
 > **commit 写得越规范，飞轮数据越准。**
 
+## Rules-Applied trailer（规则命中回传）
+
+若本次任务中触发过 CONVENTIONS 自动推荐规则（R01-R11，见 `.blueprint/CONVENTIONS.md` 规则列表），
+在 commit message 末尾追加一行 trailer（与正文空行分隔）：
+
+```
+feat(auth/login): 新增手机号登录
+
+Rules-Applied: R01,R05
+```
+
+- 只记录**真实触发**（主动检查或执行）的规则，未触发则整行省略
+- 炼境自动解析此 trailer 做「规则命中 × 返工」交叉统计，是 CONVENTIONS 置信度进化的数据来源
+- 凭空罗列会污染数据——宁缺毋滥
+
 ## 一个 commit = 一件独立的事
 
 不要 `git add -A` 一次提交所有。按功能分批：