jeremylongshore/PR to Spec
Convert GitHub PRs into structured, agent-consumable spec artifacts
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| github_token | GitHub token for API access | no | ${{ github.token }} |
| comment | Post spec summary as a PR comment | no | true |
| output_dir | Directory to write spec artifacts | no | .pr-to-spec/specs |
| ai_enhance | Enhance spec with AI-generated insights (requires ai_api_key) | no | false |
| ai_provider | AI provider: anthropic or openai | no | anthropic |
| ai_api_key | API key for AI provider (or set ANTHROPIC_API_KEY/OPENAI_API_KEY) | no | — |
| ai_model | Override the default AI model | no | — |
| format | Output format: yaml, markdown, json, both | no | both |
| webhook_url | URL to POST the JSON spec to when generation completes | no | — |
Outputs
| name | description |
|---|---|
| spec_yaml_path | Path to the generated YAML spec |
| spec_md_path | Path to the generated Markdown summary |
| pr_number | PR number that was analyzed |
| files_changed | Number of files changed in the PR |
| risk_count | Number of risk flags identified |
| spec_json_path | Path to the generated JSON spec |