SuperAPI AI 工具集

pushback

写作与研究

查看项目

更新于 10-16 03:14

技能介绍

用途:在动手实现之前,对规格说明、PRD、需求文档或设计计划做批判性审查,帮助尽早发现范围、可行性与安全等问题。

主要能力:先做输入解析,按 $ARGUMENTS 文件路径、对话历史中的规格、常见位置(docs/plans/、docs/specs/、requirements.md、PRD.md、spec.md、CLAUDE.md、AGENTS.md、.cursorrules 等)依次定位待审文档。若项目是 git 仓库,先执行 git log --oneline -50 做现实检查,找出规格假设与近期提交冲突之处并优先呈现。随后进入范围形态检查:识别是否捆绑了不相关功能、规格是否过大,并建议拆分。最后按矛盾、可行性、范围失衡、遗漏、歧义、安全等类别逐条审查,每条问题给出问题、从优到劣的选项与建议,等待用户回应后再继续。

使用方式:调用时先声明“Running paad:pushback v2.0.0”,然后立即执行流程。若存在 paad/config/paad.md 或 paad/config/pushback.md,则读取并遵循其配置,最终答案首行标注 Config: <path>。安全类发现只写入 paad/security/ 下按技能命名的文件,写入前需确保 paad/security/.gitignore 仅含一行 * 且 git 未跟踪该目录,否则不写入并询问用户。普通报告写入 paad/pushback-reviews/<date>-<spec>-pushback.md。

适用场景:规格评审、PRD 评审、需求文档评审、设计计划评审,尤其是文档过大、捆绑不相关功能或实现前需要把关时。

限制:不适用于用户希望直接实现而非批评的场景;非 git 仓库跳过现实检查;配置不能改变子代理类型或授予写工具;安全发现写入受 .gitignore 与 git 跟踪状态约束。具体配置细节可参考 https://github.com/Ovid/paad/blob/main/CONFIG.md。