github-action-sha-resolver
将 GitHub Action 标签/版本(例如 @v4)解析为其完整的 40 字符提交 SHA 以进行安全固定。
📖 中文导读:将 GitHub Action 标签/版本(例如 @v4)解析为其完整的 40 字符提交 SHA 以进行安全固定。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: github-action-sha-resolver description: Resolves GitHub Action tags/versions (e.g., @v4) to their full 40-character commit SHAs for security pinning. allowed-tools: mcp_github-mcp_list_tags, mcp_github-mcp_get_tag
GitHub Action SHA Resolver
This skill provides a secure workflow to identify the exact commit SHA associated with a specific version of a GitHub Action.
Available MCP Tools
| Tool | Purpose |
|---|---|
mcp_github-mcp_list_tags |
Lists all tags for a given repository |
mcp_github-mcp_get_tag |
Retrieves detailed information about a specific tag |
Workflow Logic
When a user asks for the SHA of an action version (e.g., actions/checkout@v4):
Repository Identification:
- Parse the input into owner (
actions) and repo (checkout).
- Parse the input into owner (
Tag Retrieval:
- Use
mcp_github-mcp_list_tagsto list available tags for the repository. - Search through the results to find the exact tag name match (e.g.,
v4). - If pagination is needed, continue fetching pages until the tag is found or exhausted.
- Use
SHA Extraction:
- Extract the
commit.shafrom the tag object in the list response. - This provides the full 40-character commit SHA directly.
- Extract the
Safety & Security Guidelines
- Verify Source: Always ensure the action is from the official or expected organization.
- Full SHA Policy: Only return the full 40-character hexadecimal SHA. Never return shortened SHAs for version pinning.
- Ambiguity Check: If multiple tags exist for a version (e.g.,
v4andv4.1.1), ask the user for clarification before providing a SHA.
Example Interaction
User: "Give me the SHA for actions/setup-node@v3" Agent Action:
- Calls
mcp_github-mcp_list_tags(owner="actions", repo="setup-node", perPage=100). - Searches through the returned tags for
v3. - Finds the tag and extracts commit SHA:
051d54f3a8c27888bd22a30b9f6d6309277c7315. - Response: "The commit SHA for
actions/setup-node@v3is051d54f3a8c27888bd22a30b9f6d6309277c7315."