查找、阅读与复用 Spec 资产
产品文档 · 简体中文
Spec 资产帮助团队查阅已有规格、来源和关联信息。使用前要确认资产对应的工作空间与业务范围,再判断其中哪些内容适合本次需求。
找到目标资产
进入 “Spec 资产” 后,先选择有权访问的工作空间,再使用搜索、领域筛选和列表定位内容。也可以从工作空间的 Spec 区域查看相关资产。
没有找到结果时,先核对工作空间、筛选条件和权限;没有资产与加载失败是两种不同情况。
按问题阅读详情
资产详情把内容和辅助判断信息分开展示,可以按下面的顺序阅读:
报告、来源或引用信息不可用时,页面可能显示空态或“—”。这表示没有可用结果,不能当作零风险或检查通过。
正确理解 Readiness
Readiness 和覆盖率可以帮助发现信息缺口,但不能单独证明资产适合所有项目。先看报告依据,再检查本次需要的业务规则、工程条件和验证方式。
例如,已有会员筛选规格可能按订单数统计,本次需求却要求按会员去重计数。即使资产评分较高,也必须先修改口径并补充验收示例。
复用前核对差异
- 业务含义:用户、对象、规则和非目标是否一致。
- 工程条件:接口、依赖、数据与当前工作空间是否兼容。
- 来源与时间:内容从何而来,是否仍符合当前仓库和运行情况。
- 需要修改的部分:列出采用的规则、明确差异,以及待确认事项。
- 验证方式:为本次使用准备具体验收标准和必要测试。
把资产名称、编号及需要采用的内容带入需求或设计讨论,并记录差异。实际可执行的引用、编辑或构建操作以当前页面入口和权限为准。
不要把阅读或引用资产理解为已经复制代码、生成实现或完成交付。
更新资产时检查什么
从工作空间的 Spec 构建入口查看本次构建对应的分支、提交和变更,审阅后再发布。操作步骤见从已有工程构建 Spec。
发布前核对内容与当前工程的关系,特别关注会影响已有需求的规则变化。历史资产和报告用于追溯,执行新任务时仍需独立检查当前 Sandbox / Git 中的实际情况。
将资产内容转成可验收要求的方法,见如何写清业务规则和验收标准。