aog-report-gen

Generates and audits project-level REPORT.md files for AscendC kernel migration projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project-level REPORT.md accurate and consistent across an AscendC kernel migration or backward-generation project is error-prone: tables drift from verification.json data, narrative creeps into data sections, and hand edits silently drop injection markers. This Skill automates report initialization, table refresh, and drift auditing so reports stay complete and customer-facing. ## Core Features & Use Cases - Table injection from verification.json: Runs gen_report_tables.py to regenerate the core-results, determinism, and performance tables between BEGIN-GEN/END-GEN markers, covering the full in-scope op cohort including deferred, blocked, and pending rows. - Skeleton initialization: Creates a canonical 9-section Chinese-language REPORT.md from the OUTPUT_PROJECT_LAYOUT spec when starting a new output/<project>/ port. - Drift auditing with quality lints: Dry-run mode checks section presence, row freshness, cross-link aliveness, and runs four report-quality lints (report-not-log, jargon, archive-link, concision) as blocking or advisory gates. - Use Case: After an AscendC operator lands DONE with a new verification.json, run the refresh mode to update the core-results table, verify the Report-vs-Log and jargon gates pass, and commit the updated REPORT.md. ## Quick Start Ask the agent to refresh the REPORT.md for your migration project by running /aog-report-gen with your project name, adding --init to create a new report skeleton or --audit for a read-only drift check.

Frequently Asked Questions about aog-report-gen

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

FAQPage Schema
How do I generate a REPORT.md for an AscendC kernel migration project?

Run /aog-report-gen with the project name and the --init flag to create a skeleton REPORT.md from the canonical 9-section template. After filling narrative stubs, run the skill again without flags to inject the core-results, determinism, and performance tables from each kernel's verification.json.

How do I check if a project report is out of date?

Run /aog-report-gen with the --audit flag for a read-only dry-run. It compares table rows against verification.json files, checks all required sections and cross-links, and runs the report-not-log, jargon, and archive-link lints, exiting with DRIFT status if anything mismatches.

What projects does aog-report-gen support?

It is restricted to arch22-to-arch35 migration projects and backward-generation projects located under the output/ directory. It does not handle per-op workspace files, session retrospectives, or knowledge-base maintenance, which belong to other skills.

Why does the report audit fail with DRIFT even when table rows match?

DRIFT is also triggered by missing required sections, report-not-log violations such as narrative in front data sections, internal jargon in customer-facing prose, or core-results tables lacking archive links. Concision advisories never cause DRIFT.

Can I edit REPORT.md directly instead of using the skill?

Direct edits by the caller agent are forbidden; all writes must go through a freshly spawned aog-report-gen subagent to prevent context-pressure trimming incidents. If you hand-edit inline, you must still manually run all four report-quality lint scripts before committing.