SuperAPI AI 工具集

alignment

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:在实现开始前,把准备遵循的每个模式与形成的设计意见都显式列出,附证据与理由,供人类校正。研究产出事实,对齐负责形成并暴露意见,避免悄悄采用某个模式。

主要能力与流程:需要输入brief(先查对话上下文,再查design-docs/NN-name.brief.md,缺失则询问是否运行discovery)、research(同理,回退NN-name.research.md)、glossary(docs/glossary.md,首轮缺失时在第三阶段末创建)。第一阶段综合:从研究提取代码库模式及普遍度、集成点与边界;从brief提取动机、目标终态、约束、非目标、被标记的术语歧义、尚未明确项;从术语表提取规范词汇与约束模式的词义。第二阶段暴露模式,给出Pattern、Found in、Intend to follow、Reason,并询问是否拒绝或修改,获确认前不进入下一阶段。第三阶段呈现当前状态、期望终态与开放问题,迭代至清晰。第四阶段按条件写ADR:需同时满足难以逆转、脱离上下文会令人意外、源于真实取舍三点;ADR为独立文件design-docs/adr/{N.M}-slug.md,编号前缀对应发起该决策的倡议号,不嵌入alignment.md;写入后更新design-docs/ADR.md索引并在alignment.md中引用。第五阶段写出design-docs/NN-name.alignment.md。

适用场景:需求进入实现前的设计对齐、模式选择与决策留痕。限制:always持久化到磁盘,无跳过文件选项;每次倡议仅一个对齐文档;ADR仅在满足触发门槛时创建;术语表维护归属本技能;若用户难以回答,应提示拆分或简化范围。资料未提供具体平台、收费或效果信息。