pin-github-actions
The mechanizable slice of CI supply-chain hardening, enforced at two points: at commit (the git hook, over staged changes) and at agent tool-use (over a tool call's arguments, as the agent writes) -- a workflow that references a third-party GitHub Action by a movable ref -- a branch or a version tag -- instead of a full 40-character commit SHA. A tag like v4 or a branch like main can be re-pointed at new code after review, so the action that runs tomorrow need not be the one that was audited today; a compromised or rug-pulled release rides in on exactly that mutability. The gate blocks an added line that references an action by a non-SHA ref (owner/repo at a tag/branch); a full 40-char SHA pin passes, local actions (no ref) pass, and 'pragma: allowlist unpinned-action' on the same line is a visible, deliberate exception. This is the OpenSSF Scorecard Pinned-Dependencies control for the slice a diff can show; signature and provenance verification stay out of scope.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 10
- Forks
- 1
01 前言 Front Matter
- name
- pin-github-actions
- metadata
- { "chock.artifact": "hook", "chock.enforcement": "block", "chock.coverage_without_chock": "advisory" }
- description
- The mechanizable slice of CI supply-chain hardening, enforced at two points: at commit (the git hook, over staged changes) and at agent tool-use (over a tool call's arguments, as the agent writes) -- a workflow that references a third-party GitHub Action by a movable ref -- a branch or a version tag -- instead of a full 40-character commit SHA. A tag like v4 or a branch like main can be re-pointed at new code after review, so the action that runs tomorrow need not be the one that was audited today; a compromised or rug-pulled release rides in on exactly that mutability. The gate blocks an added line that references an action by a non-SHA ref (owner/repo at a tag/branch); a full 40-char SHA pin passes, local actions (no ref) pass, and 'pragma: allowlist unpinned-action' on the same line is a visible, deliberate exception. This is the OpenSSF Scorecard Pinned-Dependencies control for the slice a diff can show; signature and provenance verification stay out of scope.
03 SKILL.md 正文
Pin GitHub Actions
The mechanizable slice of CI supply-chain hardening, enforced at two points: at commit (the git hook, over staged changes) and at agent tool-use (over a tool call's arguments, as the agent writes) -- a workflow that references a third-party GitHub Action by a movable ref -- a branch or a version tag -- instead of a full 40-character commit SHA. A tag like v4 or a branch like main can be re-pointed at new code after review, so the action that runs tomorrow need not be the one that was audited today; a compromised or rug-pulled release rides in on exactly that mutability. The gate blocks an added line that references an action by a non-SHA ref (owner/repo at a tag/branch); a full 40-char SHA pin passes, local actions (no ref) pass, and 'pragma: allowlist unpinned-action' on the same line is a visible, deliberate exception. This is the OpenSSF Scorecard Pinned-Dependencies control for the slice a diff can show; signature and provenance verification stay out of scope.
on(commit|tool_use): block(content_regex) paths=.github/workflows/*|.github/actions/* scan=added_lines allowlist_pragma=pragma:\s*allowlist\s+unpinned-action content_pattern(regex)
Unpinned GitHub Action detected: a workflow references an action by a tag or branch (owner/repo at a movable ref) rather than a full 40-character commit SHA. Pin it to the SHA -- keep the version in a trailing comment for readability -- so a re-tagged or compromised release cannot change what runs. 'pragma: allowlist unpinned-action' on the same line marks a reviewed exception; in the agent (tool use, the turn's end) it counts only when that exact line is already committed in HEAD, so an agent asks a person rather than writing the pragma itself.
This skill is advisory: the client reading it has no mechanism to enforce it. The same policy compiled by chock blocks at commit, on an agent's file writes and at turn end. See https://github.com/open-coder-ai/chock
04 同仓库更多 Skills
validate
Lint Chock policy conformance. args(policy_id or all) returns(findings, verdict) invoke(validate, check, promotion_to_review) exclude(eval, optimize)
policy-init
Create conformant Chock policy from request. args(request, target_path, artifact_hint) returns(folder, wiring) invoke(skill, hook, rule, workflow, convention, always_never) exclude(coding, edit_existing)
optimize
Improve Chock policy from usage evidence. args(policy_path, >=3 traces) returns(promoted_edit / rejected_record / no_bar) invoke(misfire, ignore, tuning) exclude(policy_init, one_off_edit)
eval
Run Chock policy eval suite. args(policy_path) returns(pass_rate, verdict) invoke(test, run_evals, promotion_check) exclude(validate, optimize)
chock-init
Onboard a repo into Chock. args(repo_path, agents, agent_agnostic) returns(wiring) invoke(onboard, scaffold, setup) exclude(coding, policy_creation)
validate
Lint Chock policy conformance. args(policy_id or all) returns(findings, verdict) invoke(validate, check, promotion_to_review) exclude(eval, optimize)