smart
1.9 KiB
1.9 KiB
项目约束验收清单
基础完整性
- 已列出目标项目路径和输出路径。
- 已说明是否发现显式规则文件。
- 已记录缺失证据，没有因为缺失 README / CLAUDE.md / AGENTS.md 而停止。
- 已区分
硬约束、观察性约束、待确认约束。 - 每条硬约束都有明确来源路径。
- 每条观察性约束至少有一个代表性源码样例。
- 每条待确认约束都写明需要谁确认。
规则质量
- 规则包含适用场景。
- 规则包含必须做什么。
- 规则包含禁止做什么，或说明没有禁止项。
- 规则包含验收方式。
- 规则包含迁移说明，说明换项目时能否复用。
- 规则没有把通用最佳实践冒充为项目事实。
- 规则没有把某个单一代码样例冒充为全项目硬约束。
覆盖范围
- global 约束覆盖项目理解、证据引用、事实/推断区分。
- frontend 约束覆盖包管理器、框架、路径别名、API 层、路由和状态管理。
- backend 约束覆盖语言版本、框架、分层、响应结构、异常和数据访问。
- security 约束覆盖认证、权限、敏感信息、数据范围和接口防护。
- testing 约束覆盖已有测试工具、运行命令和缺失测试时的处理。
- delivery 约束覆盖计划、Review、验收记录、发布或交付要求。
可复用性
- 某个项目特有规则没有写进通用规则。
- 每条规则都标注了“可直接复用 / 需重新扫描 / 不可迁移”。
- 换项目时必须重新扫描的内容已经列出。
- 可以从本清单反推出生成步骤。
交付检查
- 生成文件中没有未完成占位符、示例假名或空标题。
- Markdown 链接或路径经过抽样检查。
- 规则文件标题不为空。
- 交付说明列出已读来源、未读来源和仍需确认的问题。