SuperAPI AI 工具集

escrever-trd

办公与效率

查看项目

更新于 10-15 21:40

技能介绍

用途:创建并维护项目级技术需求文档 TRD(docs/trd.md),覆盖技术栈、架构、非功能需求、外部依赖、规范与全局决策;单特性需求归 PRD,单点决策归 ADR。

主要能力:自动检测模式——docs/trd.md 不存在则创建,存在则编辑;用户说“registra a decisão”“cria um ADR”等触发 Decision 模式。创建时分析 package.json、tsconfig.json、pyproject.toml、go.mod、Cargo.toml、Makefile、lint/测试配置、目录结构、.env.example、docker-compose、terraform/k8s 等推断技术栈、架构、依赖与部分非功能需求;对识别出的外部依赖(如 Stripe、Redis、SendGrid、Auth0、S3、Firebase)用可用的搜索或 MCP 工具查询公开约束(限流、超时、配额等),标注来源作为待确认建议。仅对无法推断的缺口做不超过 5 题(最多 8 题)的迷你访谈,随后按 references/template-trd.md 生成 6 个章节,预览确认后写入。编辑模式重新分析并与现有 TRD 比对,只就差异(新增、失效、歧义、缺失章节)询问更新/保留/忽略,取消则不写入。Decision 模式按 references/template-adr.md 生成 docs/adrs/NNN-slug.md,编号取现有最大号加一,支持 supersedes/superseded_by 与状态置为 obsoleto,并更新 TRD 的“Decisões Globais”表;已接受的 ADR 不可修改。

适用场景:项目初期或架构演进时保持技术文档同步,登记数据库、认证、架构模式等难以回退的全局决策。

限制:不创建 PRD、SPEC、PLAN、TASKS;非 Decision 模式不新建 ADR;不做业务决策;用户取消预览则不落盘。具体安装与调用命令资料未提供。