用途:该技能用于仓库范围的 AAS 维护、维护者侧 PR 修复或合并批次、canonical 同步、AAS Core 或 Workbench 变更、受保护发布,以及托管目录或旧版重定向基础设施。不适用于无需维护者权限或 canonical 收敛的普通贡献工作。
主要能力与用法:把包含此技能的仓库根视为仅限 PR。变更前须阅读 AGENTS.md、.github/MAINTENANCE.md 和当前维护者文档;不得直接提交或推送到 main,即使用户要求“push to main”,那只是最终目标状态。保留无关的脏工作,使用干净的临时克隆或主题分支。接受的源 PR 使用 npm run merge:batch,不得用原始合并 API 或通用推送工具替代。生成产物与贡献者署名收敛交由 automation/canonical-repo-state,它会运行 sync:repo-state,并重新计算 README ## Top Contributors 榜,不得手改这些表。发布使用 release:prepare 和 release:publish,它们不授权直接推 main。
源检查:变更前抓取 origin/main,确认干净的维护者检出位于 main 且等于 origin/main;检查范围内的活动 PR、issue、讨论、Actions 失败、Dependabot、CodeQL、secret scanning 及相关的 npm audit;从 package.json 和工作流文件确认当前脚本,不依赖记忆中的 CI 或发布行为。
CI 与检查:定期受保护检查为 pr-policy、pr-evidence、source-validation、artifact-preview。skill-review.yml 负责语义审查,其 review 表示 Tessl 通过或有效相同内容复用,manual-review-required 需维护者语义审查与精确完整 head 认证。skillspector-advisory.yml 为 PR 专属静态建议扫描,使用 evidence-ready 轮询同一 PR 且同 head SHA 的 pr-evidence 结果。SkillSpector、Jev、shadow 决策和计时遥测既不满足这些检查,也不授权合并。
SkillSpector 建议 CI:证据就绪后最多轮询 60 次,间隔 10 秒,任务超时 12 分钟;失败或超时表示未运行扫描。计划变更的 canonical skills/<skill-id>/** 目录,安装 NVIDIA SkillSpector v2.12.0(固定提交 c7958a3268d9498644b22edb75d0f051bbc8cbfc),使用 Python 3.12、uv==0.8.22 和 uv sync --frozen --no-dev;在 Linux 网络命名空间内以 runner 用户运行 --no-llm,禁用追踪。边界:最多 50 个变更技能根、每技能 1,000 文件与 16 MiB、每次调用 60 秒、总计 600 秒预算、每份 JSON 报告 8 MiB、建议任务超时 15 分钟。报告保留 14 天,需比对 manifest 的 head_sha 与 base_sha。状态包括 dry-run、deleted-or-no-skill、reported、partial、scanner-nonzero、incomplete;缺失输出不视为干净扫描。
维护者清单:编辑前先分类所有开放 PR,区分有效源变更、可修复 PR、冲突、仅生成噪声、推广链接及不受支持的所有权/许可变更。可选加速:npm run maintainer:sweep。验证变更技能时运行 npm run validate、npm run validate:references、npm run security:docs、变更技能证据及相关测试。整个受跟踪的 skills/<skill-id>/** 子树视为技能内容,需检查语义、安全、来源、声明风险、限制及每个捆绑文件。
限制:上述内容均为维护者专属操作,需要相应权限与受保护分支约定;缺失事实包括具体收费、价格、平台支持范围与效果,暂未提供。