已开启
[Documentation|文档反馈]: okf.md 治理规范示例引用不存在的知识卡路径(datacopypad_gm_to_ub.md) #35
dihidao创建于 10月5日
lizhe
28 天前 评论:
28 天前 评论:
我来修复该问题。
改动范围:仅修改 governance/specs/okf.md:33 一处示例——把悬空路径 knowledge/ops/ascendc/apis/datacopypad_gm_to_ub.md 换成一个仓内真实存在的知识卡路径,Concept ID 示例同步更新。
核实:master 上 find knowledge -iname "*datacopypad*" 下无 apis/ 路径的卡;该示例引用的 datacopypad_gm_to_ub.md 全仓不存在,而示例意在演示「Bundle 内相对路径 → Concept ID」的推导,按规范示例应指向真实卡片。全仓 grep 后该悬空路径仅此一处。
不做的事:不新建知识卡、不改动任何 knowledge/ 正文内容、不动其他示例。


场景:按 governance/specs/okf.md 规范示例学习 Concept ID 命名规则。
问题(master 2026-10-06 核实):governance/specs/okf.md:33 写"例如 knowledge/ops/ascendc/apis/datacopypad_gm_to_ub.md 的 Concept ID 是 ops/ascendc/apis/datacopypad_gm_to_ub"——该路径全仓不存在(find knowledge -iname "datacopypad" 只有 concepts/、guides/、runbooks/ 等其他路径的卡);同文件其余示例卡(ceil_division.md、ascend_910_95.md)均真实存在,唯此处悬空。
影响:按规范示例找该卡落空;示例与仓内真实卡片路径体系不一致。
问题复现方式:master 上 find knowledge -iname "datacopypad" 零命中。
修复建议:示例改为实际存在的卡路径。已检索本仓历史 issues,未见报告。