Skip to content

💫 Toolkit to help you get started with SDD or any other process!

Update how Copilot prompts are created

Den Delimarsky 🌺b31ca1996299
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index c1ebfbc7a..efa13f316 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -96,27 +96,16 @@ jobs:
name=$(basename "$template" .md)
description=$(awk '/^description:/ {gsub(/^description: *"?/, ""); gsub(/"$/, ""); print; exit}' "$template" | tr -d '\r')
content=$(awk '/^---$/{if(++count==2) start=1; next} start' "$template" | sed "s/{ARGS}/$arg_format/g")
-
case $ext in
"toml")
- {
- echo "description = \"$description\""
- echo ""
- echo "prompt = \"\"\""
- echo "$content"
- echo "\"\"\""
- } > "$output_dir/$name.$ext"
- ;;
+ { echo "description = \"$description\""; echo ""; echo "prompt = \"\"\""; echo "$content"; echo "\"\"\""; } > "$output_dir/$name.$ext" ;;
"md")
- echo "$content" > "$output_dir/$name.$ext"
- ;;
+ echo "$content" > "$output_dir/$name.$ext" ;;
"prompt.md")
- {
- echo "# $(echo "$description" | sed 's/\. .*//')"
- echo ""
- echo "$content"
- } > "$output_dir/$name.$ext"
- ;;
+ # Preserve original front matter + body with argument substitution for Copilot
+ # Simply copy the entire template, replacing {ARGS}
+ # This keeps YAML so tooling can parse metadata
+ sed "s/{ARGS}/$arg_format/g" "$template" > "$output_dir/$name.$ext" ;;
esac
fi
done
diff --git a/docs/local-development.md b/docs/local-development.md
index 2a12ac150..20a3d9e2f 100644
--- a/docs/local-development.md
+++ b/docs/local-development.md
@@ -61,6 +61,28 @@ git push origin your-feature-branch
uvx --from git+https://github.com/github/spec-kit.git@your-feature-branch specify init demo-branch-test
```
+### 4a. Absolute Path uvx (Run From Anywhere)
+
+If you're in another directory, use an absolute path instead of `.`:
+
+```bash
+uvx --from /mnt/c/GitHub/spec-kit specify --help
+uvx --from /mnt/c/GitHub/spec-kit specify init demo-anywhere --ai copilot --ignore-agent-tools
+```
+
+Set an environment variable for convenience:
+```bash
+export SPEC_KIT_SRC=/mnt/c/GitHub/spec-kit
+uvx --from "$SPEC_KIT_SRC" specify init demo-env --ai copilot --ignore-agent-tools
+```
+
+(Optional) Define a shell function:
+```bash
+specify-dev() { uvx --from /mnt/c/GitHub/spec-kit specify "$@"; }
+# Then
+specify-dev --help
+```
+
## 5. Testing Script Permission Logic
After running an `init`, check that shell scripts are executable on POSIX systems:
@@ -114,7 +136,8 @@ specify init demo --skip-tls --ai gemini --ignore-agent-tools
|--------|---------|
| Run CLI directly | `python -m src.specify_cli --help` |
| Editable install | `uv pip install -e .` then `specify ...` |
-| Local uvx run | `uvx --from . specify ...` |
+| Local uvx run (repo root) | `uvx --from . specify ...` |
+| Local uvx run (abs path) | `uvx --from /mnt/c/GitHub/spec-kit specify ...` |
| Git branch uvx | `uvx --from git+URL@branch specify ...` |
| Build wheel | `uv build` |