Skip to content

feat(integrations): add MiniMax Code (mcode) agent integration (#4644) - #4645

Open
philo-x wants to merge 1 commit into
github:mainfrom
philo-x:feat/4644-support-minimax-code
Open

philo-x wants to merge 1 commit into
github:mainfrom
philo-x:feat/4644-support-minimax-code

Conversation

@philo-x

@philo-x philo-x commented Sep 19, 2026

Copy link
Copy Markdown
Contributor

Description

Adds MiniMax Code (an AI coding assistant CLI, binary mcode) as a supported Spec Kit integration under the canonical key mcode.

MiniMax Code discovers project skills natively at .minimax/skills/<skill-name>/SKILL.md (runtime source workspace-minimax, priority 65) and invokes them via its slash shortcut (/speckit-<command>). This wires it up as a SkillsIntegration with its own isolated .minimax/skills layout (multi_install_safe=True). Headless dispatch uses mcode exec "<prompt>" with --model and --output-format json (verified against mcode exec --help).

Closes #4644

Test selection reasoning

Changed file Affects Test Why
src/specify_cli/integrations/mcode/__init__.py (+ registry wiring) new mcode integration, specify init scaffolding T1 new integration install path; CLI scaffolding change needs at minimum /speckit.specify
src/specify_cli/_invocation_style.py slash-invocation rendering in init next-steps and hook invocations T1 invocation display feeds every command's guidance
src/specify_cli/commands/init.py specify init next-steps output T1 init scaffolding change
integrations/catalog.json specify integration search/info discovery T2 catalog-only change
docs/reference/integrations.md, issue templates, agent-context-defaults.json docs / issue forms / agent-context extension no slash-command behavior

Required tests

  • T1: /speckit.specify (invoked as /speckit-specify) — (new mcode integration install path + init scaffolding + live agent skill execution)
  • T2: specify integration search mcode / specify integration info mcode — (catalog discovery)

Manual test results

Agent: MiniMax Code (mcode 0.4.12 via @minimax-ai/code@latest, custom provider ark / deepseek-v4-flash) | OS/Shell: macOS 15.6 / zsh

Command tested Notes
Setup: specify init ... --integration mcode --non-interactive --script sh PASS — mcode executable detected on PATH (no --ignore-agent-tools needed); scaffolded 10 skills under .minimax/skills/speckit-*/SKILL.md; next steps correctly rendered dash-notation slash commands /speckit-constitution, /speckit-specify, /speckit-plan, etc.
Runtime Skill Discovery: mcode exec "What skills are available in this project?" PASS — MiniMax Code actively scanned .minimax/skills/ and listed all local Spec Kit workflow skills (speckit-specify, speckit-clarify, speckit-plan, speckit-tasks, etc.) as project-local skills.
T1: mcode exec --permission full "/speckit-specify Add health check endpoint with uptime and memory metrics" PASSFull agent workflow execution verified: MiniMax Code discovered /speckit-specify, ran the feature allocation script, and generated specs/001-health-check-endpoint/spec.md (7.7 KB with P1–P3 user stories, 8 functional requirements, 5 success criteria, assumptions), completed checklists/requirements.md (16 items passed on iteration 1), and persisted state to .specify/feature.json.
T2: specify integration search mcode PASS — found MiniMax Code (mcode) v1.0.0 with tags cli, skills.
T3: specify integration info mcode PASS — reported MiniMax Code (mcode) v1.0.0, author spec-kit-core, Built-in integration.
Log excerpt: MiniMax Code execution of /speckit-specify (T1)
Specification complete and validated. Here's the summary:

## Completion Report

**Feature**: Health Check Endpoint (feature #001)

- **SPECIFY_FEATURE_DIRECTORY**: specs/001-health-check-endpoint
- **SPEC_FILE**: specs/001-health-check-endpoint/spec.md
- **Checklist**: specs/001-health-check-endpoint/checklists/requirements.md
- Feature context persisted to .specify/feature.json for downstream commands

**What the spec covers**
- 3 prioritized user stories: P1 manual status view (status + uptime + memory), P2 automated monitoring integration (stable machine-readable responses), P3 early warning when memory usage is high
- 8 functional requirements (FR-001–FR-008), each testable
- 5 measurable, technology-agnostic success criteria (e.g., health data in under 1 second for 99% of queries; outage detected within 1 minute)
- Key entities: Health Status, Uptime, Memory Usage
- Assumptions documenting defaults (unauthenticated access with no sensitive data, memory = running system not host, configurable warning threshold, out-of-scope items like CPU/disk/dependency status)

**Validation results**: All 16 quality checklist items passed on iteration 1. No [NEEDS CLARIFICATION] markers remain.

Automated test results

Ran with .venv/bin/python -m pytest (per CONTRIBUTING guidance):

  • Integration & consistency suites:
    .venv/bin/python -m pytest tests/integrations/test_integration_mcode.py tests/integrations/test_registry.py tests/test_agent_config_consistency.py -q
    Result: 896 passed in 48.11s.
  • Full test suite:
    .venv/bin/python -m pytest tests -q
    Result: 8,079 passed, 207 skipped (1 failure is unrelated upstream test_ps_variant_prefixed_with_powershell_launcher due to absence of pwsh/powershell on macOS).

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (fill in the disclosure below)

AI disclosure: Prepared with AI assistance. ChatGPT (GPT-5.6 Sol) was used to review the integration design, validate the Spec Kit and MiniMax Code architecture, and identify the relevant integration surfaces. Antigravity (Gemini 3.8 Flash, High, autonomous) was used on behalf of @philo-x for implementation, test authoring, end-to-end mcode workflow verification, and documentation alignment.

…b#4644)

MiniMax Code is an AI coding assistant (binary: mcode). It discovers
project skills from .minimax/skills/<skill-name>/SKILL.md and invokes them
via the /speckit-<command> slash shortcut, so wire it up as a
SkillsIntegration with its own isolated .minimax/ directory
(multi_install_safe=True).

Closes github#4644

Includes registry wiring, invocation-style mapping, init next-steps,
discovery catalog, integrations doc, agent-context default (AGENTS.md),
issue templates, and a dedicated test module.

Assisted-by: Antigravity (model: Gemini 3.8 Flash (High), autonomous)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Agent]: Add support for MiniMax Code (mcode)

1 participant