CANNBot for Codex

Codex-native CANNBot plugin for Ascend NPU and CANN development workflows.

This repository packages the standalone CANNBot SKILL.md layer as a Codex plugin. It is generated from the upstream CANNBot skills repository and keeps source traceability in skills-manifest.json and codex-compatibility.json.

Status

• Plugin ID: cannbot
• Version: 2026.07.05-codex.2
• Upstream commit: 7def5becc576de40d0e13b0fddad8345e57540e0
• Packaged skills: 94 (93 upstream + 1 Codex workflow adapter)
• Codex compatibility: 94 codex-ready

Scope

Included by default:

• Ascend C / CANN operator skills
• Catlass, PyPTO, TileLang, Triton Ascend skills
• torch.compile / npugraph_ex diagnostic skills
• model inference and model training diagnostic skills
• Runtime migration and GitCode collaboration skills
• Codex-native direct-invoke operator workflow adapter

Excluded by default:

• official CANNBot team plugins under plugins-official/*
• community workflow applications under plugins-community/*
• experimental ops-lab workflows that need dedicated Codex workflow adapters

The official CANNBot team plugins include agents, workflows, hooks, and tool-specific install scripts. They are not copied directly into this Codex plugin because Codex needs a separate workflow adapter for those semantics.

Install Locally

Add the parent directory as a local Codex marketplace and install the plugin:

codex plugin marketplace add /Users/mcgatom
codex plugin add cannbot@local
codex plugin list

For this repository layout, the marketplace entry should point to ./projects/codex-cannbot.

Validate

make ci

make ci runs script syntax checks, plugin contract validation, and the unit test suite for malformed plugin metadata, upstream sync edge cases, and local Codex install smoke behavior.

Expected result:

{
  "plugin": "cannbot",
  "skillFiles": 94,
  "uniqueSkillNames": 94,
  "supportCounts": {
    "codex-ready": 94
  }
}

For a local Codex install smoke test:

make smoke-install

To refresh from a checked-out upstream CANNBot repository:

make sync-upstream UPSTREAM=/tmp/cannbot-skills-update
make ci

The sync command preserves local skills/cannbot-* Codex workflow adapters.

Repository Layout

.codex-plugin/plugin.json      # Codex plugin metadata
skills/                        # packaged CANNBot skills
skills-manifest.json           # generated source and marketplace traceability
codex-compatibility.json       # Codex compatibility report
docs/codex-adapter.md          # generated adapter report
docs/official-plugin-model.md  # official CANNBot model mapped to Codex
docs/official-plugin-comparison.md
scripts/validate_codex_plugin.py
scripts/sync_upstream.py
scripts/smoke_install.sh
tests/test_plugin_contract.py
Makefile
.github/workflows/ci.yml

Upstream

Canonical CANNBot source:

https://gitcode.com/cann/cannbot-skills

This repository is a Codex adapter/distribution of the standalone skill layer. For full CANNBot team workflows, follow the upstream repository's official installation path.

License

This repository retains the upstream CANN Open Software License Agreement Version 2.0. See LICENSE and NOTICE.