菜单
Validate GitCode workflow YAML files against the platform API. Use when validating workflow syntax, checking for schema errors, or running schema checks on case-generated YAML.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/opensourceways/gitcode-action-foundational-tests --skill validate-yaml命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | validate-yaml |
| description | Validate GitCode workflow YAML files against the platform API. Use when validating workflow syntax, checking for schema errors, or running schema checks on case-generated YAML. |
Validate workflow YAML files using the GitCode platform's POST /api/v2/projects/{project}/actions/valid endpoint.
GITCODE_COOKIE in project root .env (browser cookie, not v8 API token)GITCODE_OWNER and GITCODE_REPO configuredset -a && source <(grep -v '^#' .env | grep '=' | sed 's/ #.*//') && set +a
./phase02/scripts/extract-workflows.sh phase01/runs/<run-id>/cases/yaml/ tmp/
python phase02/scripts/validate_workflow.py tmp/<case>.yml
| # | Error | Fix |
|---|---|---|
| 1 | on: array format on:\n- push | Change to map: on:\n push: |
| 2 | Duplicate key name: | One name: per job/step |
| 3 | Step name contains [ ] | Replace with ( ) |
| 4 | ${{ }} in unquoted run: | Wrap entire value in double quotes, escape inner " as \" |
| 5 | if: bare keyword always | Use ${{ always() }} |
| 6 | runs-on multiline list | Use inline array [ubuntu-latest, x64, small] |
| 7 | permissions with contents/pull-requests | Delete the entire permissions block |
| 8 | on.<event>.types illegal value | See allowed values table |
| 9 | on.<event> branches empty or >32 | At least 1, max 32 |
on.<event>.types| Event | Allowed |
|---|---|
pull_request_comment | created, deleted, edited |
merge_requests | close, merge, open, reopen, update |
See phase01/schema/VALIDATION-RULES.md for complete platform validation rules.