SuperAPI AI 工具集

alignment

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:在开始工作前、规格或计划更新后,或怀疑文档与实现不一致时,校验意图文档(需求、规格、PRD、用户故事)与行动文档(实施计划、任务清单、工单)是否对齐,并检查两者与代码库实际情况是否一致。

主要能力:输入解析支持 /alignment 自动检测、指定文件(如 requirements.md plan.md)或指定目录(如 docs/specs/ docs/plans/);按内容把文件分类为意图、行动与可选的中间设计文档。若项目是 git 仓库,先做现实检查:运行 git log --oneline -50 --since="2 weeks ago",对照提交与差异,找出文档假设与近期代码变更的冲突。随后执行三项检查:需求覆盖(意图项是否有对应任务)、范围合规(任务是否可追溯到需求)、设计对齐(存在设计文档时双向检查)。问题按依赖顺序呈现:先缺失或不清晰的需求,再设计缺口,最后缺失、孤立或超范围的任务;每个问题给出严重程度(Critical/Important/Minor)、从优到劣的选项与建议,并等待用户决定后再进入下一个。

使用方式:调用时先声明“Running paad:alignment v2.0.0”再继续。若工作目录下存在 paad/config/paad.md 或 paad/config/alignment.md,则读取并遵循其指示,并在最终回答首行标注 Config: <path>;配置不得改变子代理类型或授予写工具。解决阶段可更新原文档,或把报告写入 paad/alignment-reviews/<YYYY-MM-DD>-<topic>-alignment.md(报告结构以 references/report-template.md 为准);文档来自对话历史时先询问保存位置。对齐确认后,若任务尚未采用红/绿/重构格式且涉及代码实现,则改写为 RED(先写失败测试)、GREEN(最小实现通过)、REFACTOR(清理重复逻辑、硬编码值等)格式,可原地改写或写入新文件。

适用场景:需求与计划评审、规格变更后的回归检查、发现范围蔓延或需求遗漏时。

限制:不推荐新开会话,因为对话历史可能包含文档;非 git 仓库跳过现实检查;无设计文档时跳过设计对齐检查;任务已为红/绿/重构格式或非代码工作时跳过 TDD 改写;配置不能改变子代理类型或授予写权限。具体收费、平台支持等信息暂未提供。