Scenario / 使用场景

知识缺口

• 使用场景：ops-perf-evolution 进化流程（lingxi-evo / wm_ops）为 AscendC 算子选择优化策略时，
  主 agent 需要按瓶颈类型/算子族检索策略卡与 Playbook；当前 161 张精选策略卡（P 性能/D 数据类型/
  A 精度/R A5 架构）和 142 份 Playbook 只存在于 cannbot-skills 仓 references/cards|playbooks/，
  未进入知识库，无法被 knowledge-query 检索、无治理约束（sources/status/platforms），
  与知识仓已有的 ascendc optimizations 体系割裂。
• 适用范围：AscendC 算子性能优化；平台 a2（R 系列为 950）；cannbot-skills
  evolution-strategies / evolution-world-model / evolution-knowledge 三个 Skill 的策略消费链路。
• 现有检索：以"双缓冲""tiling 多核切分""CV 流水"等查询现有知识库，只能命中零散的
  optimization 卡片，覆盖不到进化策略库的 250 策略体系；策略选择依赖 Skill 本地文件读取，
  无统一检索入口。

Domain / 所属领域

尚不确定

Technology or scope / 技术或作用域

Ascend C

Query attempt / 已尝试的检索

Query attempt / 已尝试的检索

检索工具：knowledge-query（本仓标准检索 Skill），平台筛选 platform=a2，k=3。

根本原因：这套进化优化策略库（161 张精选策略卡 + 142 份 Playbook，含瓶颈分类、
适用算子族、实测加速比）整体存放在 cannbot-skills 仓
community/ops/evolution-strategies/references/cards|playbooks/，不在本仓
knowledge/ 语料内——knowledge-query 按构造就不可能召回它们，与检索词优劣无关。

（迁移后同一组查询的验证：三条查询的 Top 命中均为本次迁入卡
contrib/ascendc/optimizations/evolution_strategies/...，如 P19 自定义 PingPong、
P72/P104 matmul 多核切分、P110 UB 累加器复用，缺口已闭合。）

Expected knowledge / 期望补充的知识

1. 策略选择：「AscendC kernel 出现 mte2_stall / tiling_imbalance / no_overlap 等
   瓶颈时，有哪些经过实测的优化策略？」→ 应召回对应策略卡（如 P1 双缓冲、
   P4 负载均衡），正文能说明触发条件、改造思路、适用算子族和失效边界。
2. 落地操作：「选定策略 PX 后，具体按什么步骤改造 kernel？」→ 应召回对应
   Playbook（Runbook），含分步 SOP、约束复核（UB/L1 预算）和自检方法。
3. 状态判定：「策略 PX 现在还能用吗？」→ frontmatter status 标明
   stable/deprecated（R1-R8、P6/P13/P42/P62/P82 共 13 张为 deprecated 留档），
   检索默认不把 deprecated 当推荐结论。
4. 平台范围：「该策略适用于 A2 还是 950？」→ frontmatter platforms 明确
   （R 系列 = 950，其余 = a2）。
   需求满足的判定标准：

• 上述第 1、2 类查询（platform=a2）Top-3 内命中对应迁入卡（已实测满足，
  见「已尝试的检索」表）；
• bash check.sh 全绿：knowledge_lint P0/P1/P2=0、索引 7508 卡 verify 通过、
  检索质量门达标（recall@k=0.548 / MRR=0.459，不低于迁移前基线）；
• 每张卡 sources pin 到 cannbot-skills 固定提交，可回溯原文。

明确不包含（范围边界）：进化运行时发现的 X 系列 89 卡（cannbot-skills
references/discovered/，运行时可写、单算子置信度的过程产物）不入库，
待验证稳定升格为精选卡后按常规知识建设流程另行贡献。

Candidate sources / 候选来源

Checklists / 提交确认

• 我已搜索现有知识和 Issue，确认当前需求尚未被覆盖。
• 我理解没有可靠来源或明确适用范围的内容可能不会进入知识库。