SuperAPI AI 工具集

ai-review-techspec

编程与开发

查看项目

更新于 10-15 20:29

技能介绍

用途:以首席架构师身份审查技术规格说明,关注高负载下的正确性、分布式系统韧性、运维简洁性、安全性、长期可维护性、安全增量发布与实现风险,而非改写文风。

主要能力:读取 references/review-criteria.md 中的审查标准(含审查思路、十一个评估类别、额外关键视角、输出结构与风格要求),据此输出简短、可视化、可扫描的行动清单,只报告真正重要的问题。

使用方式:先加载审查标准,再从 Obsidian 库读取技术规格(可选读 PRD 作背景),按标准结构撰写审查并保存。库根默认 $HOME/Documents/obsidian/obsidian,可用绝对路径覆盖;输出写入 <vault>/engineering/<project>/...,通过 Read/Write/Edit 工具与 Bash 的 ls 操作。项目名由 git rev-parse --show-toplevel 的 basename 得出,非 git 仓库时由 $PWD 提议名称并确认。若用户给出 feature 标识则直接使用,否则列出 workplans 目录选择;规格缺失时提示先运行 ai-create-techspec。每次审查生成新文件 tech-spec-review-<timestamp>.md(时间戳来自 date +%Y-%m-%d-%H%M%S),不覆盖旧审查。写完后维护 feature、project、root 三级 index.md 的 wikilink,并提交推送: V="$HOME/Documents/obsidian/obsidian" git -C "$V" add -A && git -C "$V" commit -m "<message>" && git -C "$V" push

适用场景:需要架构级评审、上线前风险排查、分布式系统设计复核的工程团队。

限制:依赖 Obsidian 库与本地文件系统(不使用 MCP);需先有 tech-spec.md;推送失败或无 origin 时仅简要报告不中止;具体收费、价格与平台支持暂未提供。