mirror of
https://github.com/github/spec-kit.git
synced 2026-08-03 06:26:30 +08:00
a5560fcf13
* docs(scripts): document the 'py' script type and sh/ps migration plan (#3284) Bring remaining docs up to date with the Python (`py`) workflow-script variant introduced in #3277, and record the retention/deprecation plan for the shell variants. - AGENTS.md: document the `scripts:` frontmatter (sh/ps/py), clarify the `{SCRIPT}` placeholder resolution, and add a "Script Types and Migration" section (why py is recommended, defaults, phased sh/ps deprecation path). Note the Python agent-context variant. - docs/quickstart.md, docs/local-development.md: mention the `py` variant and `--script sh|ps|py`. - docs/reference/integrations.md: add `py` to the `--script` rows for install/switch/upgrade. - .devcontainer/devcontainer.json: auto-approve `.specify/scripts/python/`. Closes #3284. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 298d6ec2-a330-49bc-9394-fe2b77f25ff3 * docs(scripts): address review — accurate paths, prompt behavior, scoped py claims Addresses the review on PR #3653: - AGENTS.md: fix the agent-context Python path to its real `extensions/agent-context/scripts/python/` location. - AGENTS.md: qualify that only templates that invoke a helper script carry `scripts:` frontmatter (constitution/specify do not). - AGENTS.md: narrow the availability claim — `py` covers the core command templates; the bundled extensions ship Python scripts on disk but their command templates still invoke shell variants, so `--script py` does not yet route extension commands to Python. - AGENTS.md / quickstart / local-development: describe the interactive prompt vs. non-interactive OS default instead of "auto-selects". - local-development: add `--script py` to the wrong-script-type fix. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 298d6ec2-a330-49bc-9394-fe2b77f25ff3 * docs(scripts): trim deprecation timeline, correct parity/scope claims (review) Addresses the second review on PR #3653: - Remove the speculative four-phase deprecation timeline from AGENTS.md. A forward-looking removal schedule is roadmap content, not contributor guidance, and its phases lacked an actionable adoption signal. Replace it with the concrete contributor parity rule plus a one-line current-posture note pointing removal work to the #3277 epic. - Stop stating dual-maintenance as already eliminated: reframe "single source of truth" as the intended direction, noting all three variants are still maintained in parallel today. - Correct the parity-coverage claim: Python ports have output-parity tests where the contract is stdout-based and unit tests elsewhere, rather than every file being compared to every shell counterpart. - Scope the `scripts:` frontmatter rule to core command templates and note the agent-context/git extension templates don't use it yet. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 298d6ec2-a330-49bc-9394-fe2b77f25ff3 --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
75 lines
2.1 KiB
JSON
75 lines
2.1 KiB
JSON
// For format details, see https://aka.ms/devcontainer.json. For config options, see the
|
|
// README at: https://github.com/devcontainers/templates/tree/main/src/python
|
|
{
|
|
"name": "SpecKitDevContainer",
|
|
// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
|
|
"image": "mcr.microsoft.com/devcontainers/python:3.13-trixie", // based on Debian "Trixie" (13)
|
|
"features": {
|
|
"ghcr.io/devcontainers/features/common-utils:2": {
|
|
"installZsh": true,
|
|
"installOhMyZsh": true,
|
|
"installOhMyZshConfig": true,
|
|
"upgradePackages": true,
|
|
"username": "devcontainer",
|
|
"userUid": "automatic",
|
|
"userGid": "automatic"
|
|
},
|
|
"ghcr.io/devcontainers/features/dotnet:2": {
|
|
"version": "lts"
|
|
},
|
|
"ghcr.io/devcontainers/features/git:1": {
|
|
"ppa": true,
|
|
"version": "latest"
|
|
},
|
|
"ghcr.io/devcontainers/features/node": {
|
|
"version": "lts"
|
|
}
|
|
},
|
|
|
|
// Use 'forwardPorts' to make a list of ports inside the container available locally.
|
|
"forwardPorts": [
|
|
8080 // for Spec-Kit documentation site
|
|
],
|
|
"containerUser": "devcontainer",
|
|
"updateRemoteUserUID": true,
|
|
"postCreateCommand": "chmod +x ./.devcontainer/post-create.sh && ./.devcontainer/post-create.sh",
|
|
"postStartCommand": "git config --global --add safe.directory ${containerWorkspaceFolder}",
|
|
"customizations": {
|
|
"vscode": {
|
|
"extensions": [
|
|
"mhutchie.git-graph",
|
|
"eamodio.gitlens",
|
|
"anweber.reveal-button",
|
|
"chrisdias.promptboost",
|
|
// Github Copilot
|
|
"GitHub.copilot",
|
|
"GitHub.copilot-chat",
|
|
// Codex
|
|
"openai.chatgpt",
|
|
// Kilo Code
|
|
"kilocode.Kilo-Code",
|
|
// Claude Code
|
|
"anthropic.claude-code"
|
|
],
|
|
"settings": {
|
|
"debug.javascript.autoAttachFilter": "disabled", // fix running commands in integrated terminal
|
|
|
|
// Specify settings for Github Copilot
|
|
"git.autofetch": true,
|
|
"chat.promptFilesRecommendations": {
|
|
"speckit.constitution": true,
|
|
"speckit.specify": true,
|
|
"speckit.plan": true,
|
|
"speckit.tasks": true,
|
|
"speckit.implement": true
|
|
},
|
|
"chat.tools.terminal.autoApprove": {
|
|
".specify/scripts/bash/": true,
|
|
".specify/scripts/powershell/": true,
|
|
".specify/scripts/python/": true
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|