用途:为编写或审查自然语言编程工件(Claude Code、Codex CLI、Antigravity)提供最佳实践与反模式清单,用于编写 skill、agent、command、rule、hook。每个模式含理由与具体示例,且与工具无关。
推荐模式:P1 用 3 个以上具体触发短语写描述;P2 agent 描述含 2 个以上 example 块;P3 规则写“做 X 因为 Y”而非禁止;P4 分层提示按角色/上下文/任务/约束/输出格式排序;P5 按任务复杂度选模型层级(haiku 解析、sonnet 分析、opus 复杂综合);P6 技能限定在 500 行内并附 Scope Note;P7 工具最小权限;P8 显式输出格式;P9 覆盖空输入、缺文件、数据格式错误三类失败;P10 对“更简单”等主观原则加数值锚点;P11 成对 CAN/CANNOT 契约;P12 自主指令加理由与回退阶梯;P13 结尾用生动用例收束。
反模式:A1 模糊量词(如“适当”“相关”“按需”);A2 禁止但无替代方案;A3 超大技能;A4 只读 agent 声明 Write/Edit;A5 单体提示;A6 规则重复 linter 检查;A7 无示例 agent;A8 机械任务用 opus;A9 硬编码路径(应用 ${CLAUDE_PLUGIN_ROOT})。
范围限制:不涵盖具体 schema 字段与语法(见 nlpm:conventions)、评分细则(见 nlpm:scoring),也不涵盖 NL 工件之外的通用软件工程模式。