资源与模板

规划与规格草拟

当你需要把工单、PRD 或口头需求变成可评审输入时，使用工单转规格模板、采纳决策树和治理策略。

API 契约评审

在修改公开或内部接口之前，先用兼容清单、schema diff 矩阵、废弃计划和合作伙伴接入套件。

AI 辅助交付

当 AI 参与规格、代码、测试或 SDK 修改时，使用 Prompt 包、质量门禁、风险登记和人工评审记分卡。

数据库与运维

涉及迁移、支付重试、对账异常或发布证据时，使用迁移风险模型、重试矩阵和测试证据门禁。

先选一个评审目标

不要一次下载全部资源再慢慢整理。先确定今天要解决的问题：需求不清、接口不稳、迁移风险、AI 输出漂移，或事故跟踪不到位，再下载对应资源。

改成团队自己的字段

Markdown 资源是起点。使用前应补上团队角色、审批人、系统名称、风险等级和证据格式，让它成为内部流程的一部分，而不是孤立附件。

把下载文件接回工作流

资源应进入 issue、PR、知识库或发布清单。只有它能被评论、更新和追踪，才能在后续评审中持续发挥作用。

可复用的 Markdown 字段

每个下载文件都应该能贴进真实评审入口，再由工作负责人按团队情况修改。

## 本次要做的决策
- 这个 API 变更应归类为兼容、有风险，还是破坏性？

## 必须证据
- 调用方列表
- 旧客户端契约测试
- 迁移说明
- 回滚或废弃计划

## 责任人
- 工程：
- 产品：
- 发布：

怎么判断资源是否该保留

一个资源只有在帮助团队做出、评审或验证某个决策时，才值得保留。如果它只是存放泛泛记录，就应该删减。

保留资源，当它：
- 写明一个决策
- 收集证据
- 指定责任人
- 能阻断不安全发布

修改资源，当它：
- 字段长期空着
- 评审者不会看
- 事故暴露出缺失检查项

Google Docs 版软件规格模板

可复制到 Google Docs 的完整规格模板。

验收标准提示词包

用 AI 工具生成高质量验收标准的提示词模板。

验收标准 Prompt 包

用 AI 从功能描述生成 Given/When/Then 验收标准的提示词模板，兼容 ChatGPT、Claude 和 Copilot。

工单转规格字段模板

将 Jira/Linear 工单字段映射为结构化规格章节的模板——目标、非目标、验收标准和回滚策略。

Spec-First 采纳决策树

帮助团队判断功能何时需要完整规格、轻量规格或可以直接编码的决策流程图。

规格驱动治理策略

组织级策略模板，定义何时需要规格、谁负责评审以及如何融入 Sprint 规划。

PR 标准证据表

将每条验收标准映射到测试证据的 Pull Request 模板——在合并时连接规格与代码。

事故记录模板

结构化事后复盘模板，涵盖时间线、根因、检测缺口、规格缺口分析和后续行动项。

API 向后兼容检查清单

发布前检查 API 变更是否影响现有消费者——字段增删、类型变更和默认值。

API 变更沟通模板

针对破坏性和非破坏性 API 变更的干系人通知模板——迁移时间线、影响范围和所需操作。

API 废弃计划模板

分步模板，用于下线 API 版本——废弃通知、迁移指南、监控和截止执行。

API 错误运维手册

将 API 错误代码映射到根因、分流步骤和升级路径的运维手册。

API 错误分类体系

API 错误分类框架——验证、授权、限流、上游依赖和内部服务器错误的标准载荷。

API Schema Diff 评审矩阵

评估 API Schema 差异的审查清单——将变更分为安全、有风险或破坏性，附带审查人行动项。

API 版本控制决策备忘录

选择 URL、Header 或内容协商版本控制方案的决策文档模板——权衡、团队背景和理由。

OpenAPI 契约 CI 检查

自动化 OpenAPI Schema 验证的 CI 流水线配置模板——Lint、破坏性变更检测和 Mock 服务器测试。

契约评审题库

按 API 生命周期阶段组织的 50+ 评审问题——设计、实现、发布前和部署后的契约验证。

合作伙伴 API 接入套件

外部合作伙伴集成包模板——API Key 配置、沙盒访问、限流、SLA 和升级联系人。

AI Agent API 决策矩阵

评估何时向 AI Agent 开放 API 的框架——风险评估、权限范围和人工复核阈值。

AI 迁移评审清单

AI 辅助代码变更的迁移前检查清单——范围验证、测试覆盖、回滚验证和审批关卡。

AI 质量门禁策略

定义 AI 生成代码质量门禁的组织级策略——评审要求、测试证据和部署限制。

AI 风险登记模板

AI 功能风险评估模板——幻觉风险、数据泄露、偏差检测、模型漂移监控和缓解策略。

产品 Prompt 库入门套件

面向产品团队的生产级 Prompt 集合——功能构思、用户故事生成和验收标准起草。

规格工作流 Prompt 包

规格驱动工作流的端到端 Prompt 模板——从 PRD 分析到验收标准生成再到测试用例创建。

结构化 Prompt 评分标准

评估 Prompt 质量的评分标准——清晰度、约束具体性、输出格式和边界定义。

SDK 人工评审记分卡

评估 AI 生成 SDK 代码的审查记分卡——API 表面正确性、错误处理、文档质量和测试覆盖。

Spec Skills 工作区治理清单

Spec Skills 工作区配置的治理清单——权限控制、规格绑定策略、输出评审流程和审计追踪。

数据库迁移风险模型

数据库迁移的风险评分模型——表大小、锁持续时间、回滚复杂度和数据完整性验证步骤。

支付重试矩阵

支付重试逻辑的决策矩阵——幂等性要求、退避策略和按支付方响应码的失败分类。

对账异常处理手册

对账异常处理的运维手册——不匹配检测、根因分类、解决工作流和升级标准。

测试证据门禁手册

按发布层级定义所需测试证据的质量门禁手册——单元、集成、契约和压测阈值。

工具对比评分模型

评估和比较工程工具的加权评分模型——功能覆盖、集成成本、团队适配度和总拥有成本。

资源如何复查

资源会按“工作产物”复查：每个模板都应该说明它支持什么决策、收集什么证据、由哪个角色负责后续动作。如果某个下载无法帮助团队做出或验证决策，就会被改写、合并或下架。

编辑与纠错

作者与编辑：Daniel Marsh。复查流程：编辑政策。资源缺失或纠错：联系。最近复查：2026 年 4 月 28 日。