人工智能AI AgentAI 技能后端前端【免费下载链接】skillhubSelf-hosted, open-source agent skill registry for enterprises. Publish version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.项目地址https://gitcode.com/gh_mirrors/sk/skillhub点击查看免费下载本篇技术指南围绕 SkillHub 的审核与治理模块展开系统讲解命名空间审核与平台审核两层模型、审核任务状态机、权限模型、Web 控制台操作流程、合规声明快照差异审核、举报处理与推广管理并结合仓库源码与测试说明底层实现帮助开发者与平台管理员快速掌握技能包发布前审核、批准、拒绝、撤回的完整链路。审核体系概览两层审核模型SkillHub 作为自托管的企业级 Agent 技能包注册中心README通过一套完整的审核工作流确保发布到注册中心的技能包符合团队规范。审核机制分为两层命名空间审核团队管理员审核本命名空间成员提交的技能包确保其符合团队规范平台审核平台管理员审核从命名空间推广到全局的技能包控制进入全局注册中心的技能质量。两层审核分别由不同的角色与权限入口驱动命名空间层基于命名空间成员角色OWNER / ADMIN判定平台层基于平台角色SKILL_ADMIN / SUPER_ADMIN判定具体权限判定集中在 ReviewPermissionChecker.java。审核流程一个技能包版本从提交到发布经历以下五个阶段开发者发布技能包 → 进入「待审核」状态管理员收到通知 → 查看技能包详情管理员决策 → 批准或拒绝批准后 → 技能包正式发布拒绝后 → 开发者收到反馈可修改后重新提交。审核状态审核任务ReviewTask的状态定义如下状态说明PENDING待审核APPROVED已批准REJECTED已拒绝WITHDRAWN已撤回从源码层面看审核任务实体 ReviewTask.java 中的ReviewTaskStatus枚举核心值为PENDING / APPROVED / REJECTED撤回WITHDRAWN操作在领域层表现为删除处于 PENDING 的审核任务并将对应技能版本恢复为草稿draft状态便于开发者修改后重新提交见 ReviewService.withdrawReview。治理功能清单审核工作流多级审核命名空间 → 平台推广、批量审核举报系统用户可以举报不当技能包管理员调查处理推广管理将命名空间已批准的技能包推广到全局审计日志记录所有治理操作提交、批准、拒绝、撤回等。审核任务的底层实现状态机、并发保护与事件通知技能版本状态流转技能版本SkillVersion自身带有一套生命周期状态。提交审核时ReviewService.submitReview 要求版本处于DRAFT或UPLOADED状态随后将其置为PENDING_REVIEW并创建审核任务批准后版本转为PUBLISHED并写入publishedAt时间戳拒绝后版本转为REJECTED。任何状态不符合预期的提交都会抛出DomainBadRequestException如review.submit.not_draft、review.not_pending。并发安全审核任务实体带Version乐观锁字段见 ReviewTask.java。批准与拒绝均通过reviewTaskRepository.updateStatusWithVersion(...)以带版本条件更新方式执行若同时被其他管理员操作导致版本不匹配将抛出ConcurrentModificationException避免双审或状态覆盖。此外批准时还会校验同命名空间下是否已有其他技能占用相同 slug 且已发布防止命名冲突error.skill.approve.nameConflict。事件与通知每次状态变更都会通过 SpringApplicationEventPublisher发布领域事件包括ReviewSubmittedEvent、ReviewApprovedEvent、ReviewRejectedEvent、SkillPublishedEvent并调用GovernanceNotificationService.notifyUser向提交者发送 REVIEW 类型通知通知内容区分 Review approved / Review rejected。Web 端通知跳转路由由 notification-target.ts 映射到/dashboard/reviews/{entityId}。审核对象技能版本与技能套件审核任务实体通过subjectTypeSKILL_VERSION/SUITE_VERSION区分审核对象见 ReviewTask.java技能套件Skill Suite版本同样走审核流程并由 ReviewPortalAppService 按对象类型分发到ReviewService或SkillSuiteLifecycleService处理。审核权限模型审核权限由 ReviewPermissionChecker.java 集中控制规则如下提交审核技能所有者本人、平台审核角色或拥有该命名空间ADMIN/OWNER角色的用户可提交审核批准/拒绝平台审核角色SKILL_ADMIN、SUPER_ADMIN可审核所有命名空间及全局技能包命名空间OWNER/ADMIN可审核本命名空间GLOBAL类型命名空间除外提交者自己不能审核自己提交的任务除非拥有SUPER_ADMIN或在本命名空间拥有 OWNER/ADMIN 角色查看审核提交者本人始终可查看其余用户需满足审核权限。对应到前端路由review-paths.ts全局审核中心/dashboard/reviews要求平台角色包含SKILL_ADMIN/USER_ADMIN/SUPER_ADMIN之一命名空间审核/dashboard/namespaces/{slug}/reviews要求当前用户在团队命名空间中担任OWNER或ADMIN。审核操作实战Web 控制台与 API提交审核发布技能包时系统自动创建审核任务开发者可以在「我的提交」中查看审核状态并等待管理员审核。API 方式POST /api/v1/reviews Content-Type: application/json { skillVersionId: version-123 }对应控制器实现见 ReviewController.java服务端会校验版本状态DRAFT/UPLOADED、命名空间是否有效冻结FROZEN、归档ARCHIVED的命名空间不可提交、提交权限重复提交会触发唯一约束并返回review.submit.duplicate。审核技能包访问/dashboard/reviews全局或/dashboard/namespaces/{slug}/reviews命名空间查看待审核列表点击技能包查看详情可执行以下检查查看元数据名称、描述、版本浏览文件列表在线查看文件内容单文件预览接口会校验路径禁止..与绝对路径防目录穿越见 ReviewController.getReviewFile下载完整包进行本地测试查看合规声明快照和相对上一发布版本的差异。做出决策批准技能包正式发布开发者收到通知拒绝填写拒绝原因开发者可修改后重新提交添加审核意见可选。Web 端交互逻辑封装在 use-review-detail.ts批准时 comment 可选拒绝时 UI 层强制要求填写 comment将拒绝视为显式反馈动作操作成功后同时失效审核列表与治理看板缓存。审核详情与文件预览的 API# 获取审核任务详情 GET /api/v1/reviews/{id} # 获取审核中的技能包详情元数据、文件列表、合规快照等 GET /api/v1/reviews/{id}/skill-detail # 单文件在线预览path 为包内相对路径 GET /api/v1/reviews/{id}/file?pathSKILL.md # 下载审核包本地测试 GET /api/v1/reviews/{id}/download下载接口支持两种模式当后端对象存储返回预签名 URL 时非 HTTPS 请求会 302 重定向到该地址否则以附件流式返回见 ReviewController.buildDownloadResponse。批准与拒绝POST /api/v1/reviews/{id}/approve Content-Type: application/json { comment: Looks good! Approved. }POST /api/v1/reviews/{id}/reject Content-Type: application/json { comment: Please fix the documentation and add more examples. }参数说明参数类型说明idstring审核任务 ID路径参数commentstring审核意见可选最多 1000 字符批准动作的完整副作用链路ReviewService.approveReview将审核任务置为 APPROVED → 技能版本置为 PUBLISHED 并记录发布时间 → 将版本元数据displayName、summary同步到技能主体 → 发布SkillPublishedEvent与ReviewApprovedEvent→ 通知提交者。拒绝动作则仅将版本置为 REJECTED并携带评论发布ReviewRejectedEvent。列出与查询# 列出待审核任务命名空间维度 GET /api/v1/reviews/pending?namespaceIdns-123page0size20 # 列出我的提交仅 PENDING GET /api/v1/reviews/my-submissions?page0size20此外还提供按状态全量列表GET /api/v1/reviews?statusPENDINGnamespaceId...page0size20sortDirectionDESC无 namespaceId 时要求平台审核角色以及「我的进度」聚合查询GET /api/v1/reviews/my-progress?subjectTypestatusqpage0size20支持按审核对象类型、状态和关键词过滤size 上限 100。待审核列表默认按submittedAt倒序、已处理列表按reviewedAt倒序排列见 ReviewPortalAppService.buildReviewPageable。历史提交记录可通过GET /api/v1/reviews/{id}/attempts查看同一技能/套件版本的全部审核尝试。撤回审核开发者发现问题可以在审核通过前撤回提交访问「我的提交」找到待审核的技能包点击「撤回」确认撤回。API 方式POST /api/v1/reviews/{id}/withdraw撤回有严格限制只有待审核PENDING状态的技能包可以撤回且仅提交者本人可执行。源码中withdrawReview会先校验任务提交者身份review.withdraw.not_submitter再删除任务并调用SkillGovernanceService.withdrawPendingVersion将版本恢复为草稿见 ReviewService.java。审核合规声明x-astron-compliance 快照与差异如果待审核版本包含x-astron-compliance审核详情会展示版本级合规快照和差异摘要。合规快照由 ComplianceMetadataService.java 在发布/审核流程中构建并写入解析后的元数据 JSONcomplianceSnapshot字段包含 schemaVersion、映射列表与摘要digest。差异类型新增声明待审版本新增了标准、控制项或证据删除声明待审版本移除了上一发布版本已有的声明修改声明标准、控制项标题或证据发生变化摘要变化complianceSnapshot.digest变化表示规范化后的声明内容发生变化。审核建议确认声明是否与技能实际能力相关。例如安全响应技能声明 MITRE ATTCK 技术编号时应能在说明或证据文件中看到对应依据点击差异项查看证据路径、外部链接和摘要不只看声明标题对删除或大范围修改的声明提高审核优先级因为这会影响下游审计系统引用如果证据缺失、路径不可访问、声明明显不匹配技能能力建议拒绝并要求作者修正。需要特别强调边界SkillHub 能保证的是结构正确、证据可追溯、版本快照不可变不能替作者保证真的合规。审核通过或拒绝时应结合差异摘要判断风险但 Agent 执行 trace 不由 SkillHub 记录。举报处理用户可以举报不当技能包管理员调查并处理访问/dashboard/reports查看举报列表调查举报内容采取行动归档技能包、警告用户等。举报 APIPOST /api/v1/skills/{namespace}/{slug}/reports Content-Type: application/json { reason: INAPPROPRIATE_CONTENT, details: This skill contains malicious code }该端点由 SkillReportController.java 实现按命名空间 slug 与技能 slug 解析目标技能记录举报原因、详情、举报者 IP 与 User-Agent返回举报记录 ID 与状态举报后的通知路由由 NotificationController 映射到/dashboard/reports。推广管理命名空间 → 全局平台管理员审核从命名空间推广到全局的技能包。推广在领域层由 PromotionService.java 独立建模与普通审核分离因为它会创建或更新全局命名空间中的独立技能谱系提交推广源技能版本必须是PUBLISHED目标命名空间必须是GLOBAL类型同一源技能存在 PENDING 推广时不可重复提交promotion.duplicate_pending批准推广校验审核权限平台角色与提交者的提交权限后在全局命名空间创建同名技能首次推广INITIAL或将新版本写入既有全局技能后续更新UPDATE目标版本冲突会返回promotion.target_version_conflict并复用源版本的元数据、清单、文件记录含 SHA-256 与存储键最后发布SkillPublishedEvent/PromotionApprovedEvent并通知提交者拒绝推广仅更新推广请求状态不影响源技能。推广相关操作通过POST /api/v1/promotions、/approve、/reject等端点暴露见 PromotionController.java通知跳转路由为/dashboard/promotions。审计日志所有治理操作可追溯所有审核操作都会记录到审计日志。在应用服务层 ReviewPortalAppService.java 中每次操作都会调用AuditLogService.record记录审计事件动作类型包括REVIEW_SUBMIT提交审核REVIEW_APPROVE批准REVIEW_REJECT拒绝REVIEW_WITHDRAW撤回审计记录携带操作者、动作、对象类型REVIEW_TASK、目标 ID、请求 ID、客户端 IP 与 User-Agent评论内容也会作为详情一并落库保证治理链路完整可追溯。注意事项与最佳实践审核权限只有命名空间的 Admin 和 Owner 可以审核本命名空间的技能包。平台管理员可以审核所有技能包。审核时效建议在 24 小时内完成审核避免阻塞开发者审核记录所有审核操作都会记录到审计日志合规审计合规声明以版本快照形式记录。审核通过或拒绝时应结合差异摘要判断风险但 Agent 执行 trace 不由 SkillHub 记录批量审核管理员可以批量批准多个技能包审核意见拒绝时建议提供详细的改进建议撤回限制只有待审核状态的技能包可以撤回。延伸阅读审核概念与流程图review-concept.png、review-flow.png审核列表界面截图见 review-list.png前端审核中心路由与权限review-paths.ts前端审核交互 Hooksuse-review-detail.ts后端审核接口ReviewController.java、ReviewPortalAppService.java领域层审核实现ReviewService.java、ReviewPermissionChecker.java推广管理实现PromotionService.java合规快照构建ComplianceMetadataService.java治理总览文档docs/02-domain-model.md、docs/05-business-flows.md。赞分享人工智能AI AgentAI 技能后端前端【免费下载链接】skillhubSelf-hosted, open-source agent skill registry for enterprises. Publish version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.项目地址https://gitcode.com/gh_mirrors/sk/skillhub点击查看免费下载相关推荐SkillHub 技能包审核与治理Review Governance实战指南SkillHub 技能包审核与治理Review Governance实战指南 导读 SkillHub 内置了一套面向企业级技能注册中心的 多级审核工作流人工智能AI AgentAI 技能后端前端快速找出重复文件和相似图片CzkawkaKrokiet完整使用指南快速找出重复文件和相似图片CzkawkaKrokiet完整使用指南 Czkawka 是一个用 Rust 编写的免费开源工具专门用来在磁盘上找出重复文件、桌面应用Skillhub 技能生命周期状态模型全解容器状态、版本状态、审核工作流与治理动作Skillhub 技能生命周期状态模型全解容器状态、版本状态、审核工作流与治理动作 Skillhub 是一套面向企业的自托管开源 Agent 技能注册中心r人工智能AI AgentAI 技能后端前端上一篇Fresh 中 active links 的实现原理与样式化指南基于 aria-current 的当前链接高亮下一篇Sunshine游戏串流3步搭建个人云游戏平台的终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
