SuperAPI AI 工具集

decision

通用与其它

查看项目

更新于 10-16 04:59

技能介绍

用途:把项目中的实际建筑决策像软件团队记录ADR那样留存下来。每条决策一个文件,编号后放在项目根目录的 decisions/ 下,避免决策依据随邮件、会议和人员更替而丢失。

主要能力与必要用法:

  • /decision:就尚未落定的决策进行询问,然后记录。
  • /decision we're going with X:直接记录,仅追问缺失信息。
  • /decision supersede 0003:把 0003 标记为被取代,并记录替代决策。
  • /decision list:显示带状态的索引。

记录流程:先 Glob decisions/*.md,取最大编号加一,补零为4位;优先从对话中收集信息,只针对缺口提一个合并问题(决定了什么、考虑过哪些方案、原因、由谁拍板);按模板写入 decisions/NNNN-{kebab-slug}.md;更新 PROJECT.md 中的 Decisions 索引;以文件路径和一句话复述确认。若项目无档案,需先用 /project-dossier init 创建。

硬性规则:一条记录只记一个决策;“方案B和2022版规范”属于两条记录。不得重编号、不得删除,编号是永久引用,错误决策用取代而非移除。要如实记录备选方案,只有一个选项的不算决策而是通知,需追问还考虑过什么。每次创建或取代都要同步 PROJECT.md 的 Decisions 表。保持简短:背景2–4句,选项各一行,后果用项目符号。

模板字段:标题为 NNNN — 以所作选择陈述的决策标题;状态(proposed / decided / superseded by NNNN)、日期 YYYY-MM-DD、决策者;Context 2–4句并链接相关分析;Options considered 逐条一行;Decision 选择及核心原因1–3句;Consequences 列出促成、代价或约束及后续必须发生的事。

取代时:读取旧记录,只把状态改为 superseded by NNNN,其他不动;正常记录新决策,其 Context 说明取代对象与反转原因;更新档案索引两行。若分析类技能提出决策点并建议运行 /decision,可把该分析作为 Context,引用其数字及来源而非重新推导。

限制:记录为项目文件夹内的纯文件,通过项目原有方式(git、Drive、Dropbox)共享,评审在版本控制或对话中进行,本技能不附加额外工作流。官方资料未提供其他收费、平台或效果信息。