当前流水线能做什么
平台使用固定阶段：安全拉取 Git、发现 SKILL.md、静态校验、保存内容与版本。构建绑定固定 Commit SHA，Webhook、手动同步和定期检查都进入相同任务队列。
目前不提供任意步骤编排、Shell 执行或自定义测试插件。仓库里的 scripts 可以被检查，但平台不会执行它们。
仓库配置文件
在仓库根目录提交 .skills-platform.yaml：
version: 1
skills:
root: skills
pipeline:
trigger:
branches:
- main
validate:
blockScripts: true
blockExternalLinks: true
| 配置 | 当前行为 |
|---|---|
| version | 当前只接受 1 |
| skills.root | 指定扫描目录，覆盖仓库页面配置的根目录 |
| pipeline.trigger.branches | 校验配置的分支是否在允许列表中 |
| pipeline.trigger.tags | 默认 Ref 指向标签时校验允许的标签 |
| validate.blockScripts | 阻断检测到的脚本内容 |
| validate.blockExternalLinks | 阻断检测到的外部链接 |
分支与标签精确匹配，例如 main 或 refs/heads/main；不支持 release/* 通配符。列出多个分支不会自动创建多分支监听；实际同步目标仍由仓库默认 Ref 决定。不匹配会产生配置诊断。省略相应列表表示不额外限制该类型的 Ref。
未知字段会被拒绝，不能在配置中添加 steps 或 run 来执行命令。
组织级校验策略
在 安全设置（管理端） 配置单文件大小、总大小和文件数上限，以及脚本和外链策略。默认资源限制为单文件 8 MiB、总大小 64 MiB、10,000 个文件；树扫描的资源限制可能覆盖所取仓库树中的文件，应保持仓库精简。
仓库配置只能收紧组织策略，不能用 false 解除组织级阻断。静态检测不能保证内容绝对安全；发布者仍需要审阅警告。
Webhook 与定期检查
在仓库详情查看 Webhook 地址和配置步骤。支持 GitHub、GitLab、Gitea，通过对应签名或共享令牌验证来源，并按 delivery ID 去重。
Webhook 丢失时，后台每分钟检查远端；没有新提交或有效配置变化时，构建会去重。Git 凭据失效会影响后续同步，已发布快照仍可读取。
如何加入测试或模型评测
将自定义测试放在独立的外部 CI，检查通过后把批准的提交合并到平台跟踪的分支，再由本平台校验和交付。
功能分支 → 外部 CI 测试 / 评测 → 合并 main
→ 平台同步与静态校验 → Canary → Stable
当前平台没有实现对外部 CI 结果的强制发布门禁。若要求必须通过评测才能合并，需要在 Git 服务侧设置分支保护与必需检查。
读懂失败诊断
诊断提供 ruleId、严重度、文件路径、行号和说明。Blocker 修复后提交重试；Warning 需要审阅后才能确认发布。Git 拉取失败可能只有仓库同步任务错误，因为此时尚未解析出可构建的提交。
发现、校验和内容写入在同一次静态扫描中完成，界面对应阶段时间可能重叠，不应相加当作总耗时。