aog-knowledge-maintain

Reviews AscendC operator findings and stages user-local knowledge base entries.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/WangWindow/CANN-BatchMatMulMaxsum --skill aog-knowledge-maintain-wangwindow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aog-knowledge-maintain
Source: https://github.com/WangWindow/CANN-BatchMatMulMaxsum/tree/main/.agents/skills/aog-knowledge-maintain
Command: npx skills add https://github.com/WangWindow/CANN-BatchMatMulMaxsum --skill aog-knowledge-maintain-wangwindow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AscendC operator development generates hard-won lessons (build errors, precision pitfalls, performance patterns) that get lost between runs. This Skill reviews runtime findings, deduplicates them against the bundled knowledge base, and stages validated c-tier entries without ever mutating release-owned content. ## Core Features & Use Cases - Four maintenance modes: "update" (fast per-op review), "scan" (full KB dedup and validation), "validate" (test a single known issue against the current environment), and "learn" (scrape AscendC best practices from hiascend.com). - Semantic quality gates: generalization checks, applicability scope tagging (SoC/CANN/op-class), evidence cross-checks against actual kernel code, and regression-risk detection before any entry is admitted. - Tiered safety model: bundled b-tier cards are strictly read-only; all new knowledge is staged as user-local c-tier intake JSON for the orchestrator to admit. - Use Case: After an AscendC operator run finishes, point the Skill at workspace/{op}/knowledge_update.md to review the findings, generalize the lessons, and emit a validated intake file. ## Quick Start Run the knowledge maintenance skill in update mode on workspace/myop/knowledge_update.md to review and stage new AscendC findings.

Frequently Asked Questions about aog-knowledge-maintain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the AscendC knowledge base after an operator run?

Invoke the skill in default update mode with knowledge_update_path pointing to workspace/{op}/knowledge_update.md. It reviews the findings, applies generalization and scope gates, and emits a c-tier intake JSON for the orchestrator to admit.

What are the four modes of the aog-knowledge-maintain skill?

Update (fast per-op review), scan (full KB dedup and obsolete-entry detection), validate (test one known issue ID against the current A5 environment), and learn (scrape AscendC best practices from hiascend.com and stage new findings).

Can this skill modify the bundled knowledge base cards?

No. Bundled b-tier content under kb/ is strictly read-only. The skill only emits user-local c-tier intake entries; promotion into the bundled tier is a separate release-review operation it never performs.

Why does a KB entry need an applicability scope?

Lessons validated on one chip or CANN version may not transfer to another, such as A5 versus A3. The mandatory scope object (soc, cann, bisheng, op_class) prevents silent over-generalization and lets future agents filter entries by environment.

What happens when a proposed entry contradicts an existing rule?

The regression-risk gate compares overlapping-scope entries for tolerance loosening, anti-pattern reintroduction, or unsupported scope broadening. Matching entries are withheld, flagged in a risk report, or blocked pending user review.