Files
vibe-coding-cn/.github/tool-explanation-template-v1.md
T
tradecatlabsandGitHub 0c647c96c3 refactor: context - flatten support files under .github (#205)
* refactor: context - flatten support files under .github

* fix: context - preserve filenames when flattening

* refactor: extensions - retire Skill Seekers and move maintenance entrypoints

* refactor: extensions - retire Claude Skills Gitlink
2026-10-22 12:35:58 +08:00

2.2 KiB

工具解释模板 v1

版本:v1。状态:当前使用。用途:法器与功法的解释和说明。

本版保留v0的15项原名原序,并在末尾增加三个论证要素。当前功法与法器说明载荷data.json.explanations_v1和阅读视图均绑定本版SHA;v0仅保留为历史模板,不作为活动载荷或兼容格式。

使用与呈现约定

  • 每个解释对象都使用完整的18项;不得把多个对象合并成一个说明对象。
  • 使用 Markdown 呈现时,每个对象独立使用一张严格 Markdown 表格;不得改用列表、HTML 表格或把多个对象放进同一张表。
  • 表格固定为“序号、说明项、内容”三列,18行说明项按下表原名、原序填写。
  • 第16至18项按图尔敏论证的核心关系填写:第16项是主张(Claim),第18项列出可定位的事实依据(Grounds/Data),第17项是连接规则(Warrant),必须明确说明这些事实凭什么能推出该主张。连接规则要写出具体的推理原则/机制及其前提;仅列字段交叉引用、复述出处,或写“若依据支持机制则支持结论”不算连接规则。第15项用于限定适用条件、例外或反驳边界。若证据不足以跨到主张,应缩小主张或标“待核”,不得补造推理;来源存在、说明审阅或暂定赋级不直接证明许可、效果或正式评级。
  • 缺少证据或不适用时,在对应单元格说明“待核”或“不适用”及原因;不得删行、留空冒充结论或编造补全。
  • 表格的列名和序号用于呈现,不属于新增说明项;模板共18项。

单对象 Markdown 表格模板

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