SuperAPI AI 工具集

mission-statement

编程与开发

查看项目

更新于 10-16 09:06

技能介绍

用途

Mission Statement 用于定义和开发插件使命声明。使命声明是决策锚点,而非功能描述:它说明插件珍视什么、拒绝做什么、在冲突时如何取舍,使 AI 智能体无需每次询问人类即可评估行为是否与插件定位一致。它适用于创建新插件、审计现有插件,或作为插件生命周期管理流程的一部分。如果用户意图与此技能不匹配,应通过 /plugin-creator:plugin-lifecycle 路由。

主要能力

使命声明包含以下要素:

  • 一句话使命(mission):说明插件试图成为什么,而非它做什么,需通过“坏双胞胎”测试——一个表面相似但错误的版本不能声称同一使命。
  • 价值观(values):可观察、可验证的指导原则。
  • 反模式(anti_patterns):明确拒绝的行为,即使被要求也不执行。
  • 升级触发器(escalation_triggers):关键词列表,用于对齐检查中的快速字符串匹配,无需 LLM。
  • 权衡取舍(trade_offs):被迫选择时插件站在哪一边,例如 correctness_vs_speed、breadth_vs_depth、explicit_vs_implicit。
  • 范围外事项(out_of_scope):看起来相邻但属于其他插件的内容。
  • 访谈待办项(interview_backlog_item):访谈任务的 GitHub issue 编号。
  • 已验证场景(validated_scenarios):被证明能正确预测的过往决策列表。

使用方式

使命声明保存在插件根目录的 mission.json 文件中,格式包含 status、mission、values、anti_patterns、escalation_triggers、trade_offs、out_of_scope、interview_backlog_item、validated_scenarios 等字段。status 在访谈完成并经人工批准前为 "draft",之后变为 "active"。

开发过程分三个阶段:

  1. AI 起草(本会话立即执行):来源为讨论上下文与插件文件,输出 status: "draft" 的 mission.json,[draft] 标签表示这是假设而非决定。
  2. 访谈(异步,通过待办任务):向人类提出五个结构化问题,原始答案记录在待办项中,输出经人工确认的 mission.json 更新。
  3. 验证(访谈之后):用三个已知过往决策检验声明是否能预测正确选择,输出 populated validated_scenarios 并将 status 设为 "active"。

五个访谈问题依次为:

  • Q1 不可妥协之事:“即使为了更快发布,这个插件绝不能牺牲的一件事是什么?”用于锚定 values[0]。
  • Q2 坏双胞胎:“这个插件表面上相似但错误的版本会做什么?为什么它是错的?”用于填充 anti_patterns。
  • Q3 权衡取舍:“在[广度与深度/正确性与速度/显式与隐式]之间被迫选择时,这个插件选哪个,为什么?”三个都要问;若回答“都要”,追问“如果只能选一个”。
  • Q4 移除触发条件:“什么会让你把这个插件从市场上完全移除?”用于填充最严重的 anti_patterns 和 escalation_triggers。
  • Q5 反模式示例:“举一个具体例子,说明这个插件即使被要求也应拒绝做出的‘修复’或‘改进’。”具体拒绝成为 escalation_triggers 关键词。

AI 起草流程:读取插件现有文件(plugin.json 或 .claude-plugin/plugin.json、CLAUDE.md、SKILL.md 等);若为新插件则读取 discuss-CONTEXT.md;起草 status: "draft" 的 mission.json;写入插件根目录;将访谈文件写入 .plugin-creator/plans/{plugin-name}/mission-interview.md,包含五个问题和当前草案 mission 字段;更新 mission.json 加入 interview_file 字段;报告草案路径、访谈文件路径及两三句摘要。

独立调用参数:

  • <plugin-path>:为现有插件起草使命,读取插件文件、起草 mission.json、创建待办访谈项。
  • <plugin-path> --interview:在本会话同步进行访谈,询问 Q1-Q5,根据回答更新 mission.json,进入验证。
  • <plugin-path> --validate:运行验证场景,请人类确认三个过往决策并检查预测。

验证场景格式示例:decision 为“拒绝为 linting 插件添加一刀切的 noqa 抑制”,predicted_by 为“anti_patterns[0] + escalation_triggers”,outcome 为“correct”。当声明能正确预测至少三个已知决策时,status 变为 "active"。

适用场景

适用于新建插件时确立定位,审计现有插件是否有一致且可执行的使命,以及在插件生命周期中作为对齐检查的基础。

限制

与对齐检查的关系:escalation_triggers 是对齐检查的快速路径,纯字符串匹配、无需 LLM。检查提议行动文本是否匹配 escalation_triggers,命中则立即升级;未命中则用 LLM 依据 mission 和 values 推理检查 anti_patterns;若行动与 anti_patterns 矛盾或偏离 values,返回 alignment: LOW 并指出被违反的具体原则。使命声明回答“如果人类在旁观察会怎么说”,并提前将其固化。