business-rule-card.md

Business Rule Card

规则 ID

BRC-YYYYMMDD-001

适用代码版本

• 目标项目：
• 目标分支或版本：
• 实际扫描分支或版本：
• 扫描 commit：
• 分支校验结果：一致 / 不一致 / 未知

如果分支校验结果不是“一致”，本规则只能作为历史线索或待重扫材料，不能直接作为任务护栏使用。

规则标题

用一句话描述这条业务规则。

示例：已支付但未发货的订单不能被超时自动取消。

规则内容

清楚描述这条规则要求系统保持什么行为。

尽量写成可验证的行为，而不是抽象解释。

适用场景

• 场景 1：
• 场景 2：
• 场景 3：

例外情况

• 例外 1：
• 例外 2：

如果没有发现例外，写“暂未发现”，不要写“无”。

来源证据

至少填写一种来源。

每条证据应尽量写明来自哪个分支或 commit。不要把其他分支里的历史实现写成当前分支事实。

代码

• path/to/file.ext:line：

测试

• path/to/test.ext:line：

配置

• path/to/config.ext:line：

文档

• path/to/doc.md：

提交历史

• commit-hash：

人工确认

• 确认人：
• 确认时间：
• 确认内容：

相关代码路径

• path/to/file.ext：
• path/to/another.ext：

容易被 AI 漏掉的原因

• 原因 1：
• 原因 2：

破坏后的表现

如果这条规则被破坏，用户或系统会看到什么问题？

• 表现 1：
• 表现 2：

验证方式

自动测试

• 测试命令：
• 相关测试：
• 需要新增的测试：

人工验证

• 验证步骤 1：
• 验证步骤 2：

置信度

选择一个：

• 高：有代码和测试或明确文档支撑。
• 中：有代码支撑，但缺少测试或历史说明。
• 低：主要来自推测或单一线索，需要人工确认。

当前置信度：

未确认问题

• 问题 1：
• 问题 2：