用途：brand-xlsx 是面向 Codex、Claude Code 的 AI 智能体技能，用于从公司 .xlsx 模板提取可复用品牌档案，并基于用户提供的数据生成风格一致的 Excel 工作簿。用户只需描述想填充的工作簿或模型，由智能体映射到命名单元格与命名区域，调用内部 Python 引擎、校验输出并返回 .xlsx。
主要能力：核心动词为 extract、verify、generate，另有可选的 comprehend、learn、propose-overrides、refine。extract 从模板生成品牌档案；comprehend 由模型理解模板并缓存；verify 输出 QA 结论；generate 依据数据与档案生成新工作簿；learn 从历史提炼重复 QA 发现；propose-overrides 提出修正建议；refine 依据生成后反馈改进未来生成。引擎本身不调用模型。
使用方式：先运行依赖预检 python scripts/cli.py doctor，再按需提取、理解、验证与生成。提取命令为 python scripts/cli.py extract --name <brand> --template <template.xlsx> --scope project；生成命令为 python scripts/cli.py generate --name <brand> --input <grid-document.json> --output <output.xlsx> --scope auto --qa auto。反馈追加需在交付文件后，用 python scripts/cli.py refine --name <brand> --input refinement.json --accept。
适用场景：需要批量生成符合公司模板品牌的 Excel、报表或模型填充任务。
限制：脚本 scripts/cli.py 为内部引擎入口；需先满足 Python 依赖。GridDocument 中不得写入样式名、颜色、字体或品牌标识；区域填充超出命名范围会被拒绝；XLSX 派生索引不在支持范围；缺少渲染器时视觉审计降级为 L0 并仅记录 INFO；strict 模式在缺少完整渲染证据时报错。缺失模板或数据时应主动询问。