muse-agent-example/.agent/规范/去AI味道工程规范.md

去 AI 味道工程规范

文档与指令杜绝形式主义空话，直陈事实、动作与后果。

1. 人读文档规范

1.1 清嗓子套话与宏大叙事禁用清单

文档一律禁止以下表达：

• 引导性空话：“旨在……”、“值得注意的是……”、“不难发现……”、“显而易见……”
• 总结性套话：“综上所述……”、“总而言之……”、“由此可见……”
• 抽象赋能词：“全面赋能”、“深度赋能”、“多维度发力”、“全方位打通”
• 空转缓冲词：“其实……”、“往往……”、“在某种程度上……”
• 虚假对照：“不是 A 而是 B”（直接陈述 B，不立虚假靶子）
• 段末升华：禁止在段落末尾添加无业务实质的价值升华或空洞展望。

1.2 表达准则

1. 直陈命令：直接给出操作指令、输入参数与执行动词。
2. 默认值明确：给出参数默认值，不使用“视情况而定”。
3. 后果明确：直接写明违规或失败后果（如“退出码 1，抛出校验异常”），不使用“可能导致不良影响”。
4. 具体压倒抽象：名词给物理实体，动词给实际动作。

2. 智能体指令规范（Stop Ladder 决策阶梯）

2.1 决策阶梯原则

智能体指令禁止空洞说教，严格恪守：“做被要求的工作，保留必要后果，其余全部停下。”

2.2 决策阶梯标准层级

1. 输入完整性校验：
   • 检查必需字段与前置上下文。
   • 若缺失关键事实或细纲，立即停止，输出缺失清单；严禁主观脑补。
2. 权限与范围校验：
   • 检查任务声明的只读范围与操作权限。
   • 若超出授权边界，立即停止；严禁越权探测未来章节或越权写库。
3. 确定性执行：
   • 严格按四要素契约顺序执行对应动作。
   • 产生指定格式输出，不添加任何元数据说明或客套修饰。
4. 异常阻断：
   • 遇到冲突、异常或不可调和的校验失败，保留现场证据并终止，不得静默降级或伪造成功。