项目经验库要同时解决两个问题：按条件能筛到，遇到相似场景能想起并判断能否照搬。做法是把单条经验拆成三层字段：检索定位、场景召回、复用治理。本文给出一份可直接复制的空白字段表，并配套字段说明、必填划分、填写示例与维护规则；字段表也可在ONES等协作工具中承载和流转。
要点总览（TL;DR）
- 项目经验库条目建议采用三层字段结构：检索定位字段保证按条件筛得到，场景召回字段保证相似情境下被想起并判断能否照搬，复用治理字段保证条目持续有效。
- 必填字段取最小可检索集合：标题、项目类型、业务领域、项目阶段、问题类别、触发情境、适用前提、不适用情形、关键动作、结论与可复用产出、维护人、最近复核时间、状态；标签与复用记录按成熟度逐步补全。
- 标签管筛选、正文管判断：方法/技术标签只放稳定可枚举的分类词，适用条件与判断性内容放在结构化短段中，避免词表膨胀或筛选失效。
- 维护集中在四件事：标签词表建立与归并、条目按影响面设定复核周期与状态流转、复用次数与复用记录随引用更新、新增或合并字段每次只动一个并观察一个复核周期。
- 字段表可在ONES等协作工具中承载：经验条目作为工作项类型存结构化字段，标签与筛选视图组合出常用检索入口，状态流转与复核时间形成可追溯的维护痕迹。
可复制空白模板：项目经验库条目字段表
下表按三层结构排列，可直接复制到文档或表格中使用。填写形式一列说明该字段在表格或工具中适合的承载方式；“必填”列标注该字段在条目首次提交时是否必须完成。
| 层级 | 字段名 | 填写形式 | 是否必填 | 填写内容 |
|---|---|---|---|---|
| 检索定位 | 经验标题 | 单行文本 | 必填 | |
| 检索定位 | 项目类型 | 受控单选 | 必填 | |
| 检索定位 | 业务领域 | 受控多选 | 必填 | |
| 检索定位 | 项目阶段 | 受控单选 | 必填 | |
| 检索定位 | 问题类别 | 受控单选 | 必填 | |
| 检索定位 | 方法/技术标签 | 受控多选标签 | 选填 | |
| 场景召回 | 触发情境 | 短文本（2–4句） | 必填 | |
| 场景召回 | 适用前提 | 短文本（条目式） | 必填 | |
| 场景召回 | 不适用情形 | 短文本（条目式） | 必填 | |
| 场景召回 | 关键动作 | 短文本（编号步骤） | 必填 | |
| 场景召回 | 结论与可复用产出 | 短文本 | 必填 | |
| 复用治理 | 复用次数 | 数字 | 选填 | |
| 复用治理 | 复用记录 | 短文本（逐条追加） | 选填 | |
| 复用治理 | 维护人 | 人员字段 | 必填 | |
| 复用治理 | 最近复核时间 | 日期 | 必填 | |
| 复用治理 | 状态 | 受控单选 | 必填 |
复制时保留表头，逐行填写即可。若在表格工具中使用，受控单选与受控多选建议配合下拉选项或数据验证，避免同一含义出现多种写法。
字段说明：每个字段解决检索还是召回问题
三层字段各承担一种任务。检索定位字段回答“这条经验属于哪类项目、哪个阶段、哪类问题”，用于在库中按条件缩小范围；场景召回字段回答“什么情况下该想起它、能不能照搬”，用于在相似情境下做判断；复用治理字段回答“这条经验还有效吗、谁负责、被用过几次”，用于长期维护。三层缺一层，经验库就会退化成文件夹或失效文档集合。
检索定位字段：把条目放进可筛选的坐标里
项目类型、业务领域、项目阶段、问题类别四个字段构成条目的基本坐标。填写口径以团队已有分类为准，粒度控制在“能区分即可”：项目类型写到“新建系统/系统重构/版本迭代”这一级，不必细到具体合同；项目阶段写到“需求/设计/开发/测试/上线/运维”这一级；问题类别写到“进度延误/质量缺陷/需求变更/协作冲突/技术选型”这一级。方法/技术标签用于补充跨类别的检索入口，例如“灰度发布”“接口联调”“数据迁移”，按需多选。
场景召回字段：让读者判断能否照搬
触发情境用两三句话描述“当时出现了什么信号”，例如“联调阶段接口字段频繁变更，前后端反复返工”。适用前提写清这条经验成立的条件，如团队规模、系统耦合程度、时间窗口；不适用情形写清哪些情况下不应照搬，如“多方外部系统对接且变更方不受本项目控制”。关键动作按顺序写可执行步骤，结论与可复用产出写清结果和留下的资产，如检查清单、脚本、模板名称。读者先看触发情境产生共鸣，再用适用前提与不适用情形做判断，最后按关键动作执行。
复用治理字段：让条目保持有效
维护人对条目内容负责，最近复核时间记录上一次确认有效的时间，状态用于区分“草稿/待评审/已发布/已过期”。复用次数与复用记录在条目被实际引用后更新，记录写明“哪个项目、什么场景、引用了哪部分”。治理字段不参与首次检索，但决定了检索结果是否可信。
标签与正文的分工
标签管筛选，正文管判断。标签只放稳定、可枚举的分类词，便于多选组合筛选；判断性内容，如“什么情况下适用”“为什么这样做”，放在正文短段中。把判断塞进标签会让词表迅速膨胀，把分类写进正文又会让筛选失效。两者边界清楚，条目才既筛得到又读得懂。
必填与选填：先保证可检索，再逐步补全
必填字段取“最小可检索集合”：没有它，条目就无法被条件筛到或被判断能否复用。其余字段按条目成熟度分阶段补全，避免因字段过多导致没人愿意写。
| 字段 | 首次提交 | 评审发布时 | 复用后 |
|---|---|---|---|
| 经验标题、项目类型、业务领域、项目阶段、问题类别 | 必填 | 保持 | 保持 |
| 触发情境、适用前提、不适用情形、关键动作、结论与可复用产出 | 必填（可先写要点） | 补全为完整短段 | 按复用反馈修订 |
| 维护人、状态 | 必填 | 更新状态 | 保持 |
| 方法/技术标签 | 选填 | 补齐 | 按需增补 |
| 复用次数、复用记录 | 可留空 | 可留空 | 每次复用后更新 |
| 最近复核时间 | 必填（填提交日期） | 更新为发布日期 | 复核后更新 |
分阶段补全的做法是：提交时只要求写清坐标和要点，评审时由维护人或评审人把场景召回字段补成完整表述，发布后随复用逐步补充标签与复用记录。这样条目先进入库、再变完整，不会卡在填写环节。
字段留空与填写“无”需要约定：选填字段未涉及时可留空；必填字段确实不存在对应内容时填“无”并说明原因，例如“不适用情形：暂无，待补充”。留空表示尚未填写，“无”表示已确认不存在，两者在复核时区别对待。
填写示例：一条完整经验条目长什么样
以下为演示用示例，展示三层字段如何配合，字段与空白模板一一对应。
| 字段 | 示例内容 |
|---|---|
| 经验标题 | 联调阶段接口字段频繁变更的应对方式 |
| 项目类型 | 版本迭代 |
| 业务领域 | 订单履约 |
| 项目阶段 | 测试 |
| 问题类别 | 需求变更 |
| 方法/技术标签 | 接口联调、契约管理 |
| 触发情境 | 联调第二周起，上游接口字段每周变更一次，前后端各自改代码，回归测试反复返工，进度开始延后。 |
| 适用前提 | 前后端同属一个项目组；接口变更方在本项目控制范围内；联调周期不少于两周。 |
| 不适用情形 | 对接外部第三方系统且变更节奏不受本项目控制；一次性交付、无后续迭代的项目。 |
| 关键动作 | 1. 冻结联调基线字段清单并版本号；2. 变更须提交字段变更单，注明影响范围；3. 每周一次联调对齐会核对差异；4. 变更后由接口负责人更新契约文档并通知测试。 |
| 结论与可复用产出 | 联调返工次数下降，形成《接口字段变更单》模板与联调对齐会议程，可在同类迭代项目复用。 |
| 复用次数 | 3 |
| 复用记录 | 2024-05 会员中心迭代引用变更单模板；2024-07 支付对账项目引用对齐会议程；2024-09 履约二期整体引用。 |
| 维护人 | 示例：项目接口负责人 |
| 最近复核时间 | 2024-09-15 |
| 状态 | 已发布 |
示例中标签只放了“接口联调、契约管理”两个可枚举词，用于筛选同类条目；判断性内容全部放在触发情境、适用前提与不适用情形中。适用前提写的是可核验的条件，不适用情形直接指向“外部系统不受控”这一边界，读者据此决定是否照搬。关键动作按顺序编号，结论落到具体产出物名称，便于后续引用。
调整与维护：让字段表随复用情况演进
字段表的价值取决于词表是否稳定、条目是否被复核。维护工作集中在四件事上。
标签词表的建立与归并
先由维护人整理首批标签，按“方法/技术”一个维度起步，控制在几十个以内。新增标签需说明与现有标签的区别；同义或近义标签定期归并，归并时同步更新已引用条目的标签，保留旧词作为检索别名一段时间。词表变更记录版本与生效日期，避免不同时期条目口径不一致。
条目复核周期与状态流转
建议按条目影响面设定复核周期：高频复用的条目每季度复核一次，低频条目每半年一次。状态按“草稿→待评审→已发布→已过期”流转，复核确认仍有效则更新最近复核时间并保持已发布；内容过时则标记已过期并说明替代条目。过期条目不删除，保留检索线索。
复用次数与复用记录的更新
每次条目被引用后，由引用人补充一条复用记录，写明项目、场景与引用部分；维护人按月汇总复用次数。若工具支持自动统计则优先采用，否则以人工登记为准，并在字段说明中注明统计口径。
新增或合并字段的判断依据
当同一类信息在正文中反复出现、且需要作为筛选条件时，考虑新增字段；当两个字段长期被同时填写且区分度低时，考虑合并。每次调整只动一个字段，观察一个复核周期后再决定下一步，避免字段表频繁变动导致历史条目无法对齐。
把字段表落到协作工具里：条目从提交到复用的流转
字段表设计完成后，需要在日常协作工具中承载，否则仍会散落在个人文档里。落地时重点解决三件事：结构化字段有地方存、标签能组合筛选、条目有状态和责任人。
一种可行做法是把“经验条目”作为一种工作项类型，把项目类型、阶段、问题类别、状态等做成字段，把方法/技术标签做成标签字段，再用筛选视图按“项目阶段+问题类别+标签”组合出常用检索入口。条目从提交、评审到发布走状态流转，评审人确认场景召回字段完整后才置为已发布；复用记录与最近复核时间在条目上持续更新，形成可追溯的维护痕迹。
ONES 的 Wiki 可用于集中沉淀项目经验与复盘记录，并支持搜索与树形结构组织内容，便于按主题查找；它也可与项目、任务等研发管理场景结合，使经验条目与具体项目工作保持关联。将字段表与这类工具结合时，结构化字段、标签筛选与状态流转的具体配置方式，以团队实际使用的工具能力为准；若工具暂不支持某类字段，可先用表格承载，再逐步迁移。
常见问题
条目提交时场景召回字段写不完整，是否可以先入库？
可以。提交阶段只要求写清坐标和要点，触发情境、适用前提、不适用情形、关键动作、结论与可复用产出先写要点即可；评审发布时再由维护人或评审人补成完整短段。这样条目先进入库、再变完整，不会卡在填写环节。需要注意，评审发布前这些字段应达到可判断能否照搬的程度，否则条目虽在库中，召回时仍无法使用。
必填字段确实没有对应内容时，留空和填“无”有什么区别？
留空表示尚未填写，填“无”表示已确认不存在。选填字段未涉及时可留空；必填字段确实不存在对应内容时填“无”并说明原因，例如“不适用情形：暂无，待补充”。复核时两者区别对待：留空项需要补填或确认，填“无”的项只需确认结论是否仍然成立。
标签词表扩充很快，怎么控制？
新增标签需说明与现有标签的区别，同义或近义标签定期归并，归并时同步更新已引用条目的标签，并保留旧词作为检索别名一段时间。词表变更记录版本与生效日期，避免不同时期条目口径不一致。判断性内容不要塞进标签，把“什么情况下适用”“为什么这样做”放在正文短段中，词表就不会因判断需求而膨胀。
复用次数和复用记录由谁更新，统计口径怎么定？
每次条目被引用后，由引用人补充一条复用记录，写明项目、场景与引用部分；维护人按月汇总复用次数。若工具支持自动统计则优先采用，否则以人工登记为准，并在字段说明中注明统计口径，避免不同人按不同方式计数导致数据不可比。
字段表在协作工具中落地时，哪些配置需要先确认？
先确认三件事：结构化字段有地方存、标签能组合筛选、条目有状态和责任人。一种可行做法是把经验条目作为一种工作项类型，把项目类型、阶段、问题类别、状态做成字段，把方法/技术标签做成标签字段，再用筛选视图按“项目阶段+问题类别+标签”组合出常用检索入口。ONES 的 Wiki 可用于集中沉淀项目经验与复盘记录，并支持搜索与树形结构组织内容，便于按主题查找；它也可与项目、任务等研发管理场景结合，使经验条目与具体项目工作保持关联。具体字段、标签筛选与状态流转的配置方式以团队实际使用的工具能力为准；若工具暂不支持某类字段，可先用表格承载，再逐步迁移。
