vibe-coding-cn/.github/tool-explanation-template-v2.md

工具解释模板 v2

版本：v2。状态：当前使用。用途：功法与法器的逐对象解释。

v2借鉴术语工程中的概念分析、定义构造、关系表达和来源追溯规则，并按本项目要求显式保留「概念、术语、定义、条目注释、来源」五项。它不沿用原提示词的单代码块纯文本输出合同；本项目仍以JSON维护数据，并为每个对象生成独立的Markdown三列表格。

活动载荷data.json.explanations_v2及阅读视图绑定本模板的SHA-256。v1与v0模板作为历史版本保留；历史模板不作为当前载荷或兼容格式。

五项术语要素

1. 概念：本条所表示的一个独立知识单元。先检查概念原子性：对象是否具有可区分的语义边界、能否形成有信息价值的定义。概念不等同于术语；不要把概念写成术语的重复文本，也不要用对象ID代替概念。必要的上位分类可帮助定位，具体区别由定义说明。
2. 术语：用于指称概念的名称。优先沿用输入中含义准确的名称；只有来源确实支持时，才采用正式标准或成熟术语。保留有意义的原文名称、别名和用法差异，不以规范化之名改变概念。
3. 定义：直接界定概念内涵与区别性特征。优先使用「属概念＋种差」：先指出它属于什么，再说明它与相邻概念的关键区别。不得循环定义、只举例、只写用途或外观，也不得把特定事件、状态或单一来源的主张擅自推广为普遍事实。边界、条件或例外会改变概念范围时，须明确写出。
4. 条目注释：记录定义之外仍需保留的信息，例如别名差异、明确方向的关系、前提、约束、例外、边界或不确定性。条目注释不得重复定义，不堆砌常识；每条只表达一个主要事项。没有足够信息判断是否存在必要补充时，写「待核」并说明原因；经核对确无补充时，写明「无」及理由，不留空。
5. 来源：保证来源可追溯，记录术语与定义的信息依据，尽可能提供来源名称、稳定ID、修订/版本和可定位的章节、页码、行号或固定选区；有SHA时一并记录。区分原文直接陈述、编辑归纳和推导。不得把未核实材料写成权威来源；来源存在或可追溯，不自动证明定义正确、许可成立或效果存在。

从输入构造术语条目

1. 锁定范围与来源：保留输入边界；辨别原文、引用、推测和当前项目判断。重要事实须能追溯到实际材料。
2. 拆分概念：从独立且有信息价值的概念开始。只有当一部分能够独立定义、边界可区分且拆分不会丢失关键关系时才拆分；参数、取值和限定条件通常留在定义或注释中。不得为追求数量拆成无意义碎片。
3. 识别关系：判断分类、组成、功能、依赖、因果、时序、约束或逻辑关系。每个重要关系都要说清主体、对象、关系类型、关系方向和成立条件；不能因概念同时出现就推断存在关系，也不能把单向关系写成双向关系。
4. 确定术语：优先选择输入中准确的名称，其次才是已核实且适用的标准术语、成熟专业表达或明确标为工作性术语的归纳名称。必要时把别名和差异放入条目注释。
5. 编写定义：用简洁、正面的陈述界定概念；优先使用属加种差，说明关键边界并避免歧义。来源未提供正式定义但足以支持可靠概括时，可写工作性定义并标明归纳性质；信息不足就标「待核」，不得补造特征。
6. 补充注释：只保留定义之外、理解概念所必需的信息。把关系方向、前提、限制、例外和术语差异显式写出；不重复定义，也不把推测伪装为事实。
7. 记录来源：为术语和定义分别确认可追溯依据；准确保留输入中的定位信息。多个来源存在实质差异时，保留来源差异与适用上下文，不强行统一。
8. 复核完整性：检查概念原子性、定义边界、关系方向与条件、来源可追溯性及原意忠实度。不得遗漏会改变含义的条件，也不得把特定条件下成立的陈述扩展为普遍结论。

使用与呈现约定

• 每个说明对象都必须包含概念、术语、定义、条目注释和来源；五项术语要素不得省略。每个对象独立使用完整的20项，不得把多个对象合并成一个说明对象。
• 原提示词中的单代码块纯文本输出格式不适用于本模板；本项目继续使用结构化JSON载荷与Markdown三列表格。
• 每个对象独立使用一张严格Markdown表格；固定为「序号、说明项、内容」三列，不改用列表或HTML表格。
• 五项术语要素位于表格前五项；v1既有说明项中除名称映射外，其他内容保持原意。第18项为结论/主张，第19项为连接规则，第20项为依据；连接规则必须说明事实凭什么支持主张，以及推理成立的机制和边界。仅列字段交叉引用、复述出处，或写「若依据支持机制则支持结论」不算推理。第17项用于限定适用条件、例外或反驳边界。
• 若证据不足以支持主张，应缩小主张或标「待核」，不得补造推理。来源存在、说明审阅或暂定赋级不直接证明许可、效果或正式评级。
• 所有20项都必须有内容；缺少证据或不适用时，写「待核」或「不适用」并说明原因，不得删行、留空冒充结论或编造补全。
• 表格列名和序号只用于呈现，不属于说明项。

单对象Markdown表格模板

序号	说明项	内容
1	概念
2	术语
3	定义
4	条目注释
5	来源
6	为什么
7	怎么做
8	扩展
9	关联信息
10	相关图书
11	它要解决什么问题？
12	为什么这样设计？
13	内部如何实现？
14	付出了什么代价？
15	比较不同技术与方法。
16	提炼共同规律。
17	明确这些规律成立的前提与适用条件。
18	结论
19	连接规则
20	依据