提示资产目录是什么
提示资产目录用一份可检索的元数据清单登记全部提示:用途、变量、输出契约、依赖、评测状态、负责人与最近验证时间。找模板、评估改动影响、应对审计都能从同一个入口出发,不必在仓库里靠关键词撞运气。
基本信息
| 登记字段 | 用途、变量、输出契约、依赖、负责人、最近验证时间 |
|---|---|
| 检索维度 | 按领域、任务、状态、负责人过滤 |
| 新鲜度 | 每次发布更新验证时间,过期条目重点标记 |
| 与仓库关系 | 目录是索引,权威内容仍在仓库,两者需一致 |
| 用途 | 选型、影响面评估、审计与清理 |
典型使用场景
- 选型:按领域与任务找现成模板,避免重复投入
- 影响面评估:改公共依赖前按依赖字段查引用方
- 审计:说明每个资产由谁负责、什么时候验证过
- 清理:筛出长期未验证与零引用的条目集中处理
- 交付与说明:把目录整理成清单交给客户或合规方
目录条目示例
目录条目示例
- id: extract.invoice.v2
用途: 发票字段抽取
变量: [ocr_text, schema_version]
输出契约: JSON(schema v3)
依赖: 规则包 fields-v5
评测: eval-invoice 通过率 96.4%(2026-09-30)
负责人: finance-ai
状态: stable元数据字段与用途
| 字段 | 用途 | 缺失后果 |
|---|---|---|
| 用途 | 检索与选型 | 找不到已有资产,重复建设 |
| 变量与契约 | 调用约定与渲染校验 | 接口对不齐,线上才报错 |
| 依赖 | 评估改动影响面 | 改一处坏三处 |
| 验证时间 | 判断新鲜度 | 长期未验证的资产被继续信任 |
| 负责人 | 问题承接 | 出问题没人认领 |
目录的价值取决于它是否与真实资产一致:只要有过一次“目录里有、实际已删”,团队就会重新退回到翻文件夹的方式。
评测状态要写具体口径:通过率配用例集名称与时间。只写“已评测”的条目,在需要判断能否复用时提供不了任何依据。
目录条目不要记录密钥、内部地址等敏感值,它是给多人查阅的索引,越公开的信息越适合放进去。