-
Notifications
You must be signed in to change notification settings - Fork 277
Description
Step Name Alignment Issues
Found across: .github/workflows/daily-syntax-error-quality.lock.yml, .github/workflows/daily-copilot-token-report.lock.yml, and shared imports.
Summary
Three distinct naming inconsistencies were identified across the workflow lock files: one capitalization outlier for a GitHub action, one incorrect tool name capitalization with a non-standard parenthetical, and an inconsistency between two shared import components.
Issues Identified
1. [High Priority] Inconsistent Naming: "Set up Go" → "Setup Go"
Current step name:
daily-syntax-error-quality.lock.yml(source:.github/workflows/daily-syntax-error-quality.md, line 35):Set up Go
Issue:
Every other workflow in the repository uses Setup Go (one word) or Setup Go for CLI build when calling actions/setup-go. The daily-syntax-error-quality.md workflow is the only one using the two-word form Set up Go, which is an outlier against the established project convention.
Count: 1 outlier vs. ~15 workflows using Setup Go / Setup Go for CLI build
Suggested improvement:
- Change
Set up Go→Setup Go
2. [High Priority] Terminology Mismatch: "Install UV (Python package manager)" → "Install uv"
Current step name:
daily-copilot-token-report.lock.yml(source:.github/workflows/daily-copilot-token-report.md):Install UV (Python package manager)
Issue:
Two problems in one step name:
- Wrong capitalization: The tool is officially named
uv(lowercase) by Astral, notUV. Using uppercaseUVis factually incorrect. - Non-standard parenthetical: No other
Install *step in the repository appends a parenthetical explanation.Install GitHub Copilot CLI,Install Claude Code CLI,Install awf binary, etc. all omit parenthetical descriptions.
Additionally, the only other uv step in the repository (mcp-inspector.lock.yml) uses Setup uv (lowercase), showing an inconsistency in both capitalization and verb choice.
Suggested improvement:
- Change
Install UV (Python package manager)→Install uv - For the verb: since this step runs a
curlinstall script (not an action),Install uvis the correct imperative verb. Themcp-inspector.lock.ymlstep usesastral-sh/setup-uvaction, soSetup uvis appropriate there.
3. [Medium Priority] Inconsistent Shared Import Names: "Upload source and data" vs "Upload source files and data"
Current step names:
shared/trending-charts-simple.md(line 26):Upload source and datashared/python-dataviz.md(line 68):Upload source files and data
Issue:
Two shared import files define a semantically identical step (uploading Python source files and data artifacts) with different names. Workflows that import both (e.g. stale-repo-identifier.md) end up with both names in the same compiled lock file. The pattern Upload source files and data is more descriptive and explicit — "files" clarifies what "source" refers to.
Affected workflows (importing trending-charts-simple.md): audit-workflows, daily-firewall-report, daily-performance-summary, portfolio-analyst, prompt-clustering-analysis, stale-repo-identifier
Suggested improvement:
- Change
Upload source and data(inshared/trending-charts-simple.md) →Upload source files and data
Agentic Task Description
To apply these improvements:
daily-syntax-error-quality.md— Findname: Set up Goand change toname: Setup Godaily-copilot-token-report.md— Findname: Install UV (Python package manager)and change toname: Install uvshared/trending-charts-simple.md— Findname: Upload source and dataand change toname: Upload source files and data- Recompile each affected workflow with
gh aw compile (workflow-name).mdto regenerate the.lock.ymlfiles - Verify the compiled
.lock.ymlfiles reflect the corrected names
Related Files
- Source workflows:
.github/workflows/daily-syntax-error-quality.md,.github/workflows/daily-copilot-token-report.md - Shared import:
.github/workflows/shared/trending-charts-simple.md - Compiled lock files: corresponding
.lock.ymlfiles - Project glossary:
docs/src/content/docs/reference/glossary.md
Priority
This issue is High Priority for items 1 and 2 (factual outlier / wrong tool capitalization) and Medium Priority for item 3 (shared import divergence).
AI generated by Step Name Alignment for daily maintenance
Generated by Step Name Alignment
- expires on Feb 22, 2026, 12:29 PM UTC