用途:把一份受治理的报表契约(governed report contract)转成一个可独立运行、可通过输入报表名触发的技能。生成物自包含,包含契约副本、哈希清单、运行器、渲染器和设计系统,复制到其他仓库或单独安装后仍可使用,不依赖本技能存在(页面图表来自固定 CDN 除外)。模型在生成技能中职责很小:选参数、写两句摘要、报告失败;数字均来自契约。
主要能力与用法:生成前需有有效契约,校验命令:python3 "${CLAUDE_SKILL_DIR}/../governed-report-contract/scripts/validate_contract.py" reports/<name>;若未安装同级技能,可在下一步传 --validator <path>。生成命令示例:python3 "${CLAUDE_SKILL_DIR}/scripts/new_report_skill.py" --contract reports/monthly-pnl --out .claude/skills/monthly-pnl。输出文件夹名为技能名,宜用 kebab-case 且具体。生成过程会物化 contract/、写 contract.manifest.json(每文件 SHA-256)、复制运行器/渲染器/设计系统、渲染 SKILL.md,并生成 evals/evals.json 初稿。随后对真实仓库演练:python3 .claude/skills/monthly-pnl/scripts/run_report.py --contract .claude/skills/monthly-pnl/contract --profile <PROFILE> --warehouse <WAREHOUSE_ID> --out /tmp/pnl.json;再 python3 .claude/skills/monthly-pnl/scripts/render_report.py --envelope /tmp/pnl.json --out /tmp/pnl.html。
输出结构与结果信封:技能含 SKILL.md、contract/、contract.manifest.json、scripts/run_report.py、scripts/render_report.py、assets/(report.css、report-template.html、report-charts.js)与 evals/evals.json(≥8 应触发 / ≥8 不应触发 / 3 案例)。运行器与渲染器均是块失败即非零退出;三个脚本均支持 --selftest。结果信封显式定义运行与渲染接口,含 contract、generated_at、attested_principal、params、freshness、blocks(key、kind、identity、trust、status、columns、rows、row_count),status 为 ok、empty、partial、error,partial 表示被截断或超行上限并会带标记渲染。
限制与注意:不得编辑生成的 contract/,运行器会重新哈希并在漂移时拒绝运行,应改上游契约后重新生成;图表需网络,数字与表格不需要,每个图表位有可见回退;animation: false 非装饰性,动画中截图/打印/PDF 会空白或半绘;生成技能不得从本技能导入;生成的描述是草稿,需按团队用语改写为单行 150–400 字符且不与同类报表技能触发词冲突;摘要仅可引用信封中存在的值、不超过两句并保留 AI 归属标记;--skip-validate 仅用于已手动校验的情况,绕过失败契约会生成返回错误数字的技能。作者/许可等未提供。