Skip to content

GitHub Action

This page lists each input of the Speccy GitHub Action, alternayte/speccy. Keep the verdict in CI shows a whole workflow, and Reply commands lists the replies that record a decision.

Input Default What it does
config .speccy.yaml The path of .speccy.yaml. Speccy reviews the bundles of the folder it is in.
enforcement empty advisory: a verdict never fails the job. blocking: Not Build Ready fails it. Empty: enforcement in .speccy.yaml, else advisory.
models empty The model of each review role, one per line: role=backend:model. “all” sets every role. Backends: anthropic, openai, openrouter, deepseek. Empty: lint checks only. Example: all=anthropic:<model>
anthropic-api-key empty The Anthropic API key, when models uses anthropic.
openai-api-key empty The OpenAI API key, when models uses openai.
openrouter-api-key empty The OpenRouter API key, when models uses openrouter.
deepseek-api-key empty The DeepSeek API key, when models uses deepseek.
server empty Connected mode: the Speccy server that reviews the files with its models. Empty: mode and server in .speccy.yaml, else standalone.
token empty Connected mode: a personal API token for the server.
version latest The Speccy release to run, such as v0.1.0.
github-token ${{ github.token }} The token that posts comments and checks. It needs pull-requests and checks write permissions.