企业官网建设流程全解析

cannbot-knowledge回答可追溯技术问题：7步答案框架与零命中处理终极方法

【免费下载链接】cannbot-knowledgecannbot算子开发知识库插件依赖的知识库本体仓，给cannbot提供统一的知识底座。项目地址: https://gitcode.com/cann/cannbot-knowledge

cannbot-knowledge 是 CANN 算子开发 Agent（CANNBot）的知识底座仓库，提供统一的知识检索货架。本文介绍如何用它的7 步可追溯答案框架回答 CANN 算子、API、调试与性能优化类技术问题，并给出检索零命中（零结果）时的标准处理方法，让每一个回答都能追溯到具体知识卡和原始来源，新手也能照着做。

为什么 CANN 技术回答要"可追溯"？

CANN 工程知识有很强的边界性：同一个 API 在 Ascend 910B 和 950 上行为可能不同，同一个优化经验可能只适用于特定 CANN 版本。如果回答只有结论、没有依据，你就无法判断它是否适用于你的平台和版本。

cannbot-knowledge 把知识整理成带 Frontmatter 元数据的Markdown 知识卡，每张卡都记录适用平台、生命周期状态和来源，例如 Ascend 910/95 平台概念卡、数据拷送概念卡。

"可追溯回答"的要点：先给结论，再说明适用范围、依据（读过的卡片与来源）、限制和仍需验证的内容——这正是 recipes/answer_with_evidence.md 定义的流程。

7步答案框架：从提问到可追溯回答

以下步骤整理自 recipes/answer_with_evidence.md：

1. 明确问题：一次只回答一个问题。复杂问题拆开查，不要把实现、调试和性能问题塞进同一条 query。
2. 查看覆盖情况：确认目标范围内真的有知识卡——只有目录不代表有内容（安装后可先用knowledge-query的discover查看覆盖统计）。
3. 按真实范围查询：保留平台与 DSL 条件，不为了增加结果而扩大范围；记录 CANN 版本，打开命中卡后核对正文边界。
4. 选择候选卡：根据标题、摘要、路径和状态选卡。精确 API 名在目标平台稳定卡零命中时，按查询 Skill 单独补搜平台未定位的 draft，仅作待核验线索。
5. 打开卡片正文：读结论、适用条件、限制和完整来源，不要直接拿搜索摘要作答。
6. 核对来源：确认来源确实支持结论；多张卡片冲突时，先比较它们的平台、版本和来源。
7. 整理回答：按固定结构输出——

结论：<直接回答问题> 适用范围：<技术、平台、版本和其他条件> 依据：<使用的知识卡和来源> 限制或冲突：<不适用情况或不同结论> 仍需验证：<源码、实验或性能分析>

💡 第 5、6 步是"可追溯"的核心：标题、摘要或来源链接本身都不构成已核验证据，必须读完正文并核对来源。

零命中处理终极方法：先判"故障"，再判"缺口"

查询返回空结果时，最常见的误区是直接把"没查到"当成"这个技术不存在"。docs/installation_and_usage.md 的"没有结果时怎么办"章节 + knowledge-query Skill 给出了标准处理链：

三条底线（来自 Skill 的权限边界）：

• 零命中不证明API 或能力不存在；
• 命中也不等于当前问题已覆盖，仍要读正文核对边界；
• 不能为了召回而修改知识卡的平台或状态字段。

快速上手：安装后如何发起一次查询

安装入口是 install.sh，以 Claude Code 的 consumer（查询）模式为例：

bash install.sh claude /path/to/project consumer

安装成功后进入目标项目，向 Agent 提问即可。三种常见入口（详见 安装与使用指南）：

提问时给足"问题 + 目标技术 + 目标平台"三要素，例如：

使用knowledge-query查询 950 平台上实现 Softmax 时可复用的算子设计、API 约束和已知性能问题。请选择相关知识卡，核对来源后综合回答。

延伸阅读：把可追溯能力接入你的项目

• 形成可追溯回答：7 步框架完整说明（本文主要依据）
• 安装与使用指南：安装、验证、零命中处理与常见问题
• 查询 API 最佳实践：API 检索的推荐问法
• 知识路径规范：理解知识卡目录结构，方便按路径直接读卡
• knowledge-query Skill 定义：检索边界、补搜与停止条件的权威说明
• 设计原则：为什么知识库要做成"可追溯到来源"的样子

一句话总结：可追溯回答 = 明确问题 → 按范围查询 → 读卡正文 → 核对来源 → 结构化输出；零命中 = 先排除索引故障，再做定向补搜，最后如实报告知识缺口。照着做，你的每次回答都"有据可查"。

【免费下载链接】cannbot-knowledgecannbot算子开发知识库插件依赖的知识库本体仓，给cannbot提供统一的知识底座。项目地址: https://gitcode.com/cann/cannbot-knowledge