mirror of
https://github.com/github/spec-kit.git
synced 2026-08-03 06:26:30 +08:00
Adds a skills-based integration for the Factory Droid CLI alongside the existing Claude/Codex skills agents. The integration scaffolds `.factory/skills/speckit-*` directories and documents the install step in the devcontainer post-create script via the official npm distribution (`npm install -g droid`), which matches the layout of every other CLI install block above and avoids executing an unverified remote shell installer. The integration is also added to the user-facing supported-agent table in `docs/reference/integrations.md` so the new key is discoverable from the published documentation, as required by the "Updating this documentation" guideline in AGENTS.md. Operator-supplied extra args via `SPECKIT_INTEGRATION_DROID_EXTRA_ARGS` are appended after the canonical Spec Kit flags so the canonical flags are always present in argv. The Factory Droid CLI parser uses last-wins duplicate-flag semantics (verified empirically against droid 0.175.0), so a later operator-supplied value may override the canonical one — this is a deliberate inversion of the cursor-agent / opencode / codex ordering. Includes: - `src/specify_cli/integrations/droid/__init__.py` (subpackage) - `tests/integrations/test_integration_droid.py` (46 tests, including regression coverage for the no-trailing-newline frontmatter fusion bug, idempotent skill injection, and env-var path resolution) - `integrations/catalog.json` entry + `updated_at` bump - Alphabetical registration in `src/specify_cli/integrations/__init__.py` and `tests/integrations/test_registry.py` - Devcontainer Droid install block via the npm distribution (`npm install -g droid`), replacing the earlier curl-based installer - User-facing supported-agent table row in `docs/reference/integrations.md` (key `droid`, `.factory/skills/` layout, `/speckit-<command>` invocation) - `AGENT_CONFIG` entry and matching alphabetical entries in `tests/test_agent_config_consistency.py` (`ISSUE_TEMPLATE_AGENT_KEYS`) and the three issue-template dropdowns (`agent_request.yml`, `bug_report.yml`, `feature_request.yml`) so `test_issue_template_agent_lists_match_runtime_integrations` keeps the runtime/template surfaces synchronized Closes #822 Assisted-by: Droid (oracle-reviewer) Assisted-by: Droid (model: MiniMax M3, autonomous) Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
126 lines
3.5 KiB
Bash
Executable File
126 lines
3.5 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
# Exit immediately on error, treat unset variables as an error, and fail if any command in a pipeline fails.
|
|
set -euo pipefail
|
|
|
|
# Function to run a command and show logs only on error
|
|
run_command() {
|
|
local command_to_run="$*"
|
|
local output
|
|
local exit_code
|
|
|
|
# Capture all output (stdout and stderr)
|
|
output=$(eval "$command_to_run" 2>&1) || exit_code=$?
|
|
exit_code=${exit_code:-0}
|
|
|
|
if [ $exit_code -ne 0 ]; then
|
|
echo -e "\033[0;31m[ERROR] Command failed (Exit Code $exit_code): $command_to_run\033[0m" >&2
|
|
echo -e "\033[0;31m$output\033[0m" >&2
|
|
|
|
exit $exit_code
|
|
fi
|
|
}
|
|
|
|
# Installing CLI-based AI Agents
|
|
|
|
echo -e "\n🤖 Installing Copilot CLI..."
|
|
run_command "npm install -g @github/copilot@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Claude CLI..."
|
|
run_command "npm install -g @anthropic-ai/claude-code@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Codex CLI..."
|
|
run_command "npm install -g @openai/codex@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Gemini CLI..."
|
|
run_command "npm install -g @google/gemini-cli@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Augie CLI..."
|
|
run_command "npm install -g @augmentcode/auggie@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Qwen Code CLI..."
|
|
run_command "npm install -g @qwen-code/qwen-code@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing OpenCode CLI..."
|
|
run_command "npm install -g opencode-ai@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Junie CLI..."
|
|
run_command "npm install -g @jetbrains/junie-cli@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Pi Coding Agent..."
|
|
run_command "npm install -g @earendil-works/pi-coding-agent@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Kiro CLI..."
|
|
# https://kiro.dev/docs/cli/
|
|
KIRO_INSTALLER_URL="https://kiro.dev/install.sh"
|
|
KIRO_INSTALLER_SHA256="7487a65cf310b7fb59b357c4b5e6e3f3259d383f4394ecedb39acf70f307cffb"
|
|
KIRO_INSTALLER_PATH="$(mktemp)"
|
|
|
|
cleanup_kiro_installer() {
|
|
rm -f "$KIRO_INSTALLER_PATH"
|
|
}
|
|
trap cleanup_kiro_installer EXIT
|
|
|
|
run_command "curl -fsSL \"$KIRO_INSTALLER_URL\" -o \"$KIRO_INSTALLER_PATH\""
|
|
run_command "echo \"$KIRO_INSTALLER_SHA256 $KIRO_INSTALLER_PATH\" | sha256sum -c -"
|
|
|
|
run_command "bash \"$KIRO_INSTALLER_PATH\""
|
|
|
|
kiro_binary=""
|
|
if command -v kiro-cli >/dev/null 2>&1; then
|
|
kiro_binary="kiro-cli"
|
|
elif command -v kiro >/dev/null 2>&1; then
|
|
kiro_binary="kiro"
|
|
else
|
|
echo -e "\033[0;31m[ERROR] Kiro CLI installation did not create 'kiro-cli' or 'kiro' in PATH.\033[0m" >&2
|
|
exit 1
|
|
fi
|
|
|
|
run_command "$kiro_binary --help > /dev/null"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Kimi Code CLI..."
|
|
# https://code.kimi.com
|
|
run_command "npm install -g @moonshot-ai/kimi-code@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing CodeBuddy CLI..."
|
|
run_command "npm install -g @tencent-ai/codebuddy-code@latest"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🤖 Installing Factory Droid CLI..."
|
|
run_command "npm install -g droid@latest"
|
|
|
|
if ! command -v droid >/dev/null 2>&1; then
|
|
echo -e "\033[0;31m[ERROR] Droid CLI installation did not create 'droid' in PATH.\033[0m" >&2
|
|
exit 1
|
|
fi
|
|
|
|
run_command "droid --version > /dev/null"
|
|
echo "✅ Done"
|
|
|
|
# Installing UV (Python package manager)
|
|
echo -e "\n🐍 Installing UV - Python Package Manager..."
|
|
run_command "pipx install uv"
|
|
echo "✅ Done"
|
|
|
|
# Installing DocFx (for documentation site)
|
|
echo -e "\n📚 Installing DocFx..."
|
|
run_command "dotnet tool update -g docfx"
|
|
echo "✅ Done"
|
|
|
|
echo -e "\n🧹 Cleaning cache..."
|
|
run_command "sudo apt-get autoclean"
|
|
run_command "sudo apt-get clean"
|
|
|
|
echo "✅ Setup completed. Happy coding! 🚀"
|