简言简语

推荐写法与禁止写法

语言规则，便于按需加载和稳定抽取。

推荐命名参数

  • 命名参数优先，不要过度依赖位置参数。
  • 参数名必须来自真实参数表，不能自造近义词。
  • 信息不足时，宁可少写可选参数，也不要猜默认值。

推荐中文动作名与参数名

  • 正式脚本优先用中文动作名和中文参数名。
  • 英文 canonical id 可作为兼容入口，不作为普通教程主写法。
  • .txt 脚本首个非空行写 # 简言简语 v1。

不要依赖旧布尔写法

  • 稳定布尔值使用 true / false、是 / 否、真 / 假。
  • 不要把 yes / no / 对 当成稳定布尔值依赖。

不要把结束当终止动作流

  • 结束 只负责关闭判断或循环控制块。
  • 结束 必须单独一行，不能带参数。
  • 不要写 结束 原因=done 这类终止动作流写法。

不要把动作实现细节写成语言规则

  • 语言规则只定义脚本结构、变量、表达式、控制流、字面量和入口规则。
  • 某个动作支持什么参数、返回什么字段，应放到 FengshenBot 动作索引页。
  • 不要把某个动作库的临时实现细节写成简言简语本体规则。