审核技能与套装
本页面向具备审核权限的操作者，说明待审内容核查、决定提交及结果确认；作者可按职责表跟踪申请。审核决定针对具体申请及版本，不替代 Agent 执行测试、合规认证或全局提升审批。
前置条件与职责
| 操作 | 身份与条件 | 入口 |
|---|---|---|
| 团队命名空间审核 | 该命名空间所有者（Owner）或空间管理员（Admin） | 命名空间详情的“审核”入口，跳转统一审核中心并预选当前范围 |
| 跨命名空间审核 | 平台技能管理员（SKILL_ADMIN）或超级管理员（SUPER_ADMIN） | /dashboard/reviews |
| 跟踪本人申请 | 提交者 | “我的审核进度”；申请可读不代表可以批准 |
| 全局提升与撤销 | 提交者及有权平台审核人 | /dashboard/promotions，与普通版本审核分别处理 |
团队命名空间的所有者及空间管理员可审核本人提交；超级管理员可自审。其他本人提交不能仅凭平台技能管理员身份自审；全局提升的本人申请仅超级管理员可审核。普通审核决定还要求命名空间为 ACTIVE。规则见审核权限策略。
普通公开（PUBLIC）或空间成员可见（NAMESPACE_ONLY）上传进入扫描与审核流程；私有（PRIVATE）上传先保留，仍须确认发布或另行提审。新版审核期间，旧发布版可能继续可用。
查询审核申请
“审核中心”集中展示当前账号有权读取的技能、套装、头像和可见范围申请。命名空间入口复用同一队列；“治理中心”保留举报、全局提升、治理记录和治理通知，不重复展示普通审核任务。用户资料审核仍为独立队列，按用户管理权限进入。
筛选区域提供关键词、审核状态、审核范围、申请事项和申请来源。关键词匹配名称、坐标或提交人；申请事项与来源分别筛选，例如 GitHub 同步既可能是首次发布，也可能是版本更新。平台审核人可选择未加入但有权审核的命名空间；命名空间所有者和空间管理员只能选择其管理范围。
修改条件后点击“查询”才更新结果并返回第一页。“重置”恢复待审核、全部范围、全部事项、全部来源及空关键词。排序、分页和已查询条件保留在地址中，从详情返回时恢复；未点击查询的输入不会改变当前结果。范围读取失败时先重试，不以空范围代替授权结果。
核查内容并提交决定
图：申请仍为待审且具备处理权限时才可作出决定；读取旧版本不等于核对本次申请。
- 在待审列表打开申请，核对提交者、对象、目标版本、可见范围及命名空间。GitHub 同步项另有内容修订号、来源仓库和固定 commit；安装使用的技术版本在技术信息中查看。
- 在内容页签先核对本次生效的展示名称、简要描述和详细概述，再展开原始技能包核对文件。网页自定义内容必须与本次申请绑定，不能以旧发布版或原始 SKILL.md 替代。顶部申请信息集中展示事项、范围、版本、提交人及证据状态；头像及可见范围申请按自身对象展示，不能把可见范围当作内容版本号。对象存储读取失败时不得以空白预览判定内容合格。
- 在“来源与安全”核对许可证依据、扫描报告和发现项。区分执行失败、风险发现和分析器未配置。普通版本扫描未结束不能批准；许可证未识别或依据缺失时，须读取具体状态及证据，不能将其解释为许可已确认。
- 若有头像或可见范围变更，核对申请中的候选和目标；若为技能套装（Skill Suite），核对待审快照、入口技能及成员固定版本。快照未加载时批准不可用，成员获批不等于套装获批。套装定义与套装 Bundle 导入操作不是同一对象，见技能套装。
- 在“审核记录”读取历史意见，完成证据检查后提交批准或拒绝。拒绝须写明具体文件、问题和修订条件；批准意见可选。切换页签保留意见，切换申请会清空意见和未确认弹窗。本版不提供“附条件批准”状态。
| 检查结果 | 处理依据 | 后续动作 |
|---|---|---|
| 当前内容、目标及证据一致 | 已检查本次申请，且无待解决问题 | 批准后重新核对任务和对象结果 |
| 文件、证据或声明存在明确问题 | 记录可定位的问题及修订条件 | 拒绝，作者按意见修订 |
| 扫描、快照或文件未就绪 | 无法获得作决定所需证据 | 先排障或等待，不将缺失结果当作合格 |
在线预览限制集中如下；超限不表示文件被删除，须按下载权限获取后核查。
| 项目 | 固定限制 | 超限表现 |
|---|---|---|
| 逐行比较 | 文件超过64KiB或1000行 | 跳过逐行比较 |
| 当前正文在线加载 | 文件超过256KiB | 不在线加载正文 |
| 已删除旧文件的基线下载 | 文件超过1MiB | 审核页不能下载该旧文件 |
这些是前端/接口实现限制，不由审核页面配置；依据审核详情及审核接口。GET /api/v1/reviews/{id}/skill-detail?includeDocumentation=false 读取元数据、网页或包内自定义展示内容及说明路径，不读取对象存储正文；README 或 SKILL.md 回退正文需按需读取；缺省为 true。
切换内容页签或点击核查入口时，页面平滑回到包含标题的详情页顶部；系统开启减少动态效果时直接定位。异步加载及填写审核意见不重复改变阅读位置。简介独立展示，下载与文件浏览位于内容顶部；所有页签使用统一主宽，窄屏对比上下排列。正文随主页面滚动。
理解变更对比
版本关系直接展示已发布基线、本次待审版本及已读取的包信息；未填写的变更说明不生成空区域。无可展示合规声明时不保留空折叠框；快照不可用不等于已确认没有声明。
普通技能更新的“变更对比”以真实已发布基线为左侧，以本次待审版本为右侧，比较有效展示名称、简要描述、详细概述，并列出新增、修改和删除的文件。首次发布没有已发布基线，页面明确说明，不生成虚假的空版本差异。GitHub 更新保留固定来源修订及逐行文件比较；头像和可见范围申请比较各自候选或目标，不生成内容版本差异。
切换到历史记录不能绕过内容核查：本次正文、比较或套装快照读取失败时，批准保持不可用。已处理申请只读；列表可见不代表当前账号有决定权限。搜索索引维护已移至系统设置，不属于审核任务。
核查合规声明
含 x-astron-compliance 的版本展示合规快照和新增、删除、修改差异；complianceSnapshot.digest 变化表示规范化声明变化。必须将声明与实际能力、控制项、证据路径和外部材料对应核查，不能只看标准名称。证据不可访问、内容不匹配或删除影响下游引用时，应先记录问题并要求修订。注册中心保存结构化声明和版本快照，不替作者认证实际合规；依据见合规元数据。
状态对象对照
任务 PENDING 时，版本可能仍为 SCANNING；不得用任务状态代替版本状态。以下四类对象分别读取。
审核任务状态
| 状态 | 含义 | 处理者与下一步 |
|---|---|---|
PENDING | 等待决定 | 有权审核人读取当前申请后处理 |
APPROVED | 已批准 | 提交者核对版本或资料生效 |
REJECTED | 已拒绝并保留意见 | 提交者修订后重提 |
SUPERSEDED | 被后续申请替代 | 提交者及审核人查看当前申请 |
任务枚举没有 WITHDRAWN。普通技能版本撤回删除待审任务并调整版本状态，不删除已发布旧版，也不撤销已批准的全局提升，见撤回服务。
技能版本状态
| 状态 | 含义 | 处理者与下一步 |
|---|---|---|
DRAFT | 版本草稿，不是创作 API 草稿对象 | 技能所有者完成准备 |
SCANNING | 扫描运行中 | 扫描服务完成后继续流程 |
SCAN_FAILED | 扫描执行失败 | 部署方及技能所有者排障后重试 |
UPLOADED | 已上传，尚未发布 | 所有者确认发布或提交审核 |
PENDING_REVIEW | 版本等待人工决定 | 有权审核人核对本次版本 |
PUBLISHED | 已发布 | 使用者按可见范围访问，执行效果另验 |
REJECTED | 未获批准 | 所有者修订并重提 |
YANKED | 已撤下 | 使用者选择可安装替代版本 |
依据：版本枚举。
套装导入操作状态
| 状态 | 含义 | 处理者与下一步 |
|---|---|---|
RUNNING | 正在执行 | 导入者跟踪原操作，不重复确认 |
WAITING_FOR_MEMBERS | 等待成员就绪 | 导入服务及成员审核人处理成员 |
BLOCKED_RETRYABLE | 可重试阻塞 | 导入者排障后重试原操作 |
REPREVIEW_REQUIRED | 原预览不可继续 | 导入者重新预览并核对差异 |
SUITE_DRAFT_CREATED | 已创建套装草稿，尚未批准 | 套装所有者继续发布 |
CANCELLED | 已取消，不代表全部回滚 | 导入者核对已完成成员动作 |
依据：导入状态；恢复步骤见套装 Bundle 导入。
头像审核结果
头像复用技能审核申请，但字段维度独立；机器阻止不等于人工已拒绝。
| 字段 | 取值与含义 | 处理者与下一步 |
|---|---|---|
候选 status | PENDING待处理、ACTIVE使用中、REJECTED拒绝、SUPERSEDED替代、REMOVED移除 | 所有者及审核人核对候选与当前头像；响应名为 candidateStatus |
machineStatus | SKIPPED跳过、PENDING待处理、PROCESSING执行中、PASSED允许、BLOCKED阻止、ERROR执行错误 | 机器服务处理；部署方排查 ERROR |
reviewStatus | NOT_REQUIRED无需人工、PENDING待审、APPROVED批准、REJECTED拒绝、APPEAL_PENDING申诉待审 | 有权审核人及所有者按意见处理 |
完成标准与失败处理
普通版本批准后，任务为 APPROVED、目标版本为 PUBLISHED，再按目标身份访问验证。资料申请须核对资料实际生效，不能仅查看版本号。拒绝后，普通版本为 REJECTED 并有修订意见；作者在当前版本入口修订重提。审核批准不代表 Agent 执行成功或安全风险已消除。
| 现象 | 最可能原因 | 定位手段 | 处置 |
|---|---|---|---|
| 列表存在但无法批准 | 自审、命名空间状态或身份不满足 | 核对提交者、角色及命名空间状态 | 交由符合条件者处理；不要切换请求绕过限制 |
| 批准按钮禁用 | 扫描或头像未就绪、套装快照加载失败 | 查看扫描、候选和快照错误 | 完成依赖或重试读取；不要以缺失结果代替合格证据 |
| 文件或说明为空 | 对象读取失败或超预览上限 | 查看文件大小及预览错误，按权限下载 | 补齐可读材料后再决定；不要直接批准空白预览 |
| 提交决定报状态冲突 | 任务已被处理或替代 | 刷新记录，核对任务ID及当前状态 | 以新状态为准；不要连续重复批准或拒绝 |
全局撤销与治理边界
删除已提升技能被阻止时，从来源技能详情的“提升到全局”区域申请撤销。平台技能管理员或超级管理员在 /dashboard/promotions 的“撤销待审核”处理；本人提交受上述自审限制。撤销记录为 APPROVED 后，须核对活动关联已解除，再按权限删除来源技能。隐藏、归档或撤回普通审核不替代撤销。
无待审撤销申请时，有权平台操作者可在详情直接撤销并留存记录；存在待审申请则从队列处理。批准撤销会删除整条全局技能及其版本、评价和统计，来源技能保留；客户端文件无法收回，旧地址允许重新占用。若记录已批准而删除仍受阻，须核对是否再次提升，并记录对象ID、申请ID、部署版本与失败响应；不要直接修改数据库关系。流程见撤销服务。
举报入口为 /dashboard/reports，须按具体举报和现有治理权限处理；举报调查不自动批准或拒绝版本。审核任务撤回仅针对待审申请，历史意见与当前申请的可操作性须分别判断。