mirror of
https://github.com/github/spec-kit.git
synced 2026-07-06 22:32:13 +08:00
38fd1f6cc2
* support controlled multi-install integrations * fix: harden multi-install integration state * refactor: isolate integration runtime helpers * fix: address copilot review feedback * fix: address follow-up copilot feedback * fix: tighten integration switch semantics * fix: address final copilot review feedback * fix: harden integration manifest read errors * fix: refuse symlinked shared infra paths * test: filter expected self-test preset warning * test: address copilot review nits * refactor: centralize safe shared infra writes * fix: use no-follow writes for shared infra * fix: keep default integration atomic on template refresh * fix: harden shared infra error paths * fix: preflight shared infra and future state schemas * fix: support nested shared scripts during preflight * test: tolerate wrapped schema error output * fix: use safe default mode for shared text writes * fix: use posix paths in shared skip output * fix: share project guard for integration use * fix: centralize spec-kit project guards * fix: use posix project paths in cli output * fix: harden shared manifest and upgrade refresh
126 lines
3.8 KiB
Python
126 lines
3.8 KiB
Python
"""Kimi Code integration — skills-based agent (Moonshot AI).
|
|
|
|
Kimi uses the ``.kimi/skills/speckit-<name>/SKILL.md`` layout with
|
|
``/skill:speckit-<name>`` invocation syntax.
|
|
|
|
Includes legacy migration logic for projects initialised before Kimi
|
|
moved from dotted skill directories (``speckit.xxx``) to hyphenated
|
|
(``speckit-xxx``).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import shutil
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
from ..base import IntegrationOption, SkillsIntegration
|
|
from ..manifest import IntegrationManifest
|
|
|
|
|
|
class KimiIntegration(SkillsIntegration):
|
|
"""Integration for Kimi Code CLI (Moonshot AI)."""
|
|
|
|
key = "kimi"
|
|
config = {
|
|
"name": "Kimi Code",
|
|
"folder": ".kimi/",
|
|
"commands_subdir": "skills",
|
|
"install_url": "https://code.kimi.com/",
|
|
"requires_cli": True,
|
|
}
|
|
registrar_config = {
|
|
"dir": ".kimi/skills",
|
|
"format": "markdown",
|
|
"args": "$ARGUMENTS",
|
|
"extension": "/SKILL.md",
|
|
}
|
|
context_file = "KIMI.md"
|
|
multi_install_safe = True
|
|
|
|
@classmethod
|
|
def options(cls) -> list[IntegrationOption]:
|
|
return [
|
|
IntegrationOption(
|
|
"--skills",
|
|
is_flag=True,
|
|
default=True,
|
|
help="Install as agent skills (default for Kimi)",
|
|
),
|
|
IntegrationOption(
|
|
"--migrate-legacy",
|
|
is_flag=True,
|
|
default=False,
|
|
help="Migrate legacy dotted skill dirs (speckit.xxx → speckit-xxx)",
|
|
),
|
|
]
|
|
|
|
def setup(
|
|
self,
|
|
project_root: Path,
|
|
manifest: IntegrationManifest,
|
|
parsed_options: dict[str, Any] | None = None,
|
|
**opts: Any,
|
|
) -> list[Path]:
|
|
"""Install skills with optional legacy dotted-name migration."""
|
|
parsed_options = parsed_options or {}
|
|
|
|
# Run base setup first so hyphenated targets (speckit-*) exist,
|
|
# then migrate/clean legacy dotted dirs without risking user content loss.
|
|
created = super().setup(
|
|
project_root, manifest, parsed_options=parsed_options, **opts
|
|
)
|
|
|
|
if parsed_options.get("migrate_legacy", False):
|
|
skills_dir = self.skills_dest(project_root)
|
|
if skills_dir.is_dir():
|
|
_migrate_legacy_kimi_dotted_skills(skills_dir)
|
|
|
|
return created
|
|
|
|
|
|
def _migrate_legacy_kimi_dotted_skills(skills_dir: Path) -> tuple[int, int]:
|
|
"""Migrate legacy Kimi dotted skill dirs (speckit.xxx) to hyphenated format.
|
|
|
|
Returns ``(migrated_count, removed_count)``.
|
|
"""
|
|
if not skills_dir.is_dir():
|
|
return (0, 0)
|
|
|
|
migrated_count = 0
|
|
removed_count = 0
|
|
|
|
for legacy_dir in sorted(skills_dir.glob("speckit.*")):
|
|
if not legacy_dir.is_dir():
|
|
continue
|
|
if not (legacy_dir / "SKILL.md").exists():
|
|
continue
|
|
|
|
suffix = legacy_dir.name[len("speckit."):]
|
|
if not suffix:
|
|
continue
|
|
|
|
target_dir = skills_dir / f"speckit-{suffix.replace('.', '-')}"
|
|
|
|
if not target_dir.exists():
|
|
shutil.move(str(legacy_dir), str(target_dir))
|
|
migrated_count += 1
|
|
continue
|
|
|
|
# Target exists — only remove legacy if SKILL.md is identical
|
|
target_skill = target_dir / "SKILL.md"
|
|
legacy_skill = legacy_dir / "SKILL.md"
|
|
if target_skill.is_file():
|
|
try:
|
|
if target_skill.read_bytes() == legacy_skill.read_bytes():
|
|
has_extra = any(
|
|
child.name != "SKILL.md" for child in legacy_dir.iterdir()
|
|
)
|
|
if not has_extra:
|
|
shutil.rmtree(legacy_dir)
|
|
removed_count += 1
|
|
except OSError:
|
|
pass
|
|
|
|
return (migrated_count, removed_count)
|