@zeyue0329/xiaoma-cli 1.0.49 → 1.6.4

package/tools/cli/xiaoma-cli.js

@@ -0,0 +1,106 @@
+const { program } = require('commander');
+const path = require('node:path');
+const fs = require('node:fs');
+const { execSync } = require('node:child_process');
+const semver = require('semver');
+const prompts = require('./lib/prompts');
+
+// The installer flow uses many sequential @clack/prompts, each adding keypress
+// listeners to stdin. Raise the limit to avoid spurious EventEmitter warnings.
+if (process.stdin?.setMaxListeners) {
+  const currentLimit = process.stdin.getMaxListeners();
+  process.stdin.setMaxListeners(Math.max(currentLimit, 50));
+}
+
+// Check for updates - do this asynchronously so it doesn't block startup
+const packageJson = require('../../package.json');
+const packageName = 'xiaoma-cli';
+checkForUpdate().catch(() => {
+  // Silently ignore errors - version check is best-effort
+});
+
+async function checkForUpdate() {
+  try {
+    // For beta versions, check the beta tag; otherwise check latest
+    const isBeta =
+      packageJson.version.includes('Beta') ||
+      packageJson.version.includes('beta') ||
+      packageJson.version.includes('alpha') ||
+      packageJson.version.includes('rc');
+    const tag = isBeta ? 'beta' : 'latest';
+
+    const result = execSync(`npm view ${packageName}@${tag} version`, {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 5000,
+    }).trim();
+
+    if (result && semver.gt(result, packageJson.version)) {
+      const color = await prompts.getColor();
+      const updateMsg = [
+        `You are using version ${packageJson.version} but ${result} is available.`,
+        '',
+        'To update, exit and first run:',
+        `  npm cache clean --force && npx xiaoma-cli@${tag} install`,
+      ].join('\n');
+      await prompts.box(updateMsg, 'Update Available', {
+        rounded: true,
+        formatBorder: color.yellow,
+      });
+    }
+  } catch {
+    // Silently fail - network issues or npm not available
+  }
+}
+
+// Fix for stdin issues when running through npm on Windows
+// Ensures keyboard interaction works properly with CLI prompts
+if (process.stdin.isTTY) {
+  try {
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    // On Windows, explicitly reference the stdin stream to ensure it's properly initialized
+    if (process.platform === 'win32') {
+      process.stdin.on('error', () => {
+        // Ignore stdin errors - they can occur when the terminal is closing
+      });
+    }
+  } catch {
+    // Silently ignore - some environments may not support these operations
+  }
+}
+
+// Load all command modules
+const commandsPath = path.join(__dirname, 'commands');
+const commandFiles = fs.readdirSync(commandsPath).filter((file) => file.endsWith('.js'));
+
+const commands = {};
+for (const file of commandFiles) {
+  const command = require(path.join(commandsPath, file));
+  commands[command.command] = command;
+}
+
+// Set up main program
+program.version(packageJson.version).description('XiaoMa Core CLI - Universal AI agent framework');
+
+// Register all commands
+for (const [name, cmd] of Object.entries(commands)) {
+  const command = program.command(name).description(cmd.description);
+
+  // Add options
+  for (const option of cmd.options || []) {
+    command.option(...option);
+  }
+
+  // Set action
+  command.action(cmd.action);
+}
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command provided
+if (process.argv.slice(2).length === 0) {
+  program.outputHelp();
+}

package/tools/docs/_prompt-external-modules-page.md

@@ -0,0 +1,59 @@
+# Prompt: Generate External Modules Reference Page
+
+## Goal
+
+Create a reference documentation page at `docs/reference/modules.md` that lists all official external XiaoMa modules with descriptions and links.
+
+## Source of Truth
+
+Read `tools/cli/external-official-modules.yaml` — this is the authoritative registry of official external modules. Use the module names, codes, npm package names, and repository URLs from this file.
+
+## Research Step
+
+For each module in the registry, visit its GitHub repository (url in the YAML record) 
+and read its README to get:
+- A 1-2 sentence description of what the module does
+- The key agents and workflows it provides (if listed)
+- Any notable features or use cases
+
+## Output Format
+
+Create `docs/reference/modules.md` following the project's Reference Catalog structure (see `docs/_STYLE_GUIDE.md`):
+
+```
+1. Title + Hook
+2. Items (## for each module)
+   - Brief description (one sentence)
+   - **Key Info:** as flat list (code, npm package, GitHub link)
+3. Installation note
+```
+
+## Style
+use @docs/_STYLE_GUIDE.md
+
+## Frontmatter
+
+```yaml
+---
+title: Official Modules
+---
+```
+
+## Content Requirements
+
+- Start with a brief intro explaining that XiaoMa extends through official modules selected during installation
+- For each module include:
+  - `##` header with module name
+  - 1-2 sentence description (sourced from GitHub README, not just the registry's short description)
+  - Key info list: module code, npm package (linked), GitHub repo (linked)
+  - Brief bullet list of what it provides (agents, workflows, key features) — keep to 3-5 bullets
+- Include a `:::tip` admonition about how to install modules (via `npx xiaoma-cli` installer)
+- Mention that community modules and a marketplace are coming
+- Do NOT include built-in modules (core, xmc) — this page is specifically for external/add-on modules
+
+## Existing Pages for Reference
+
+Look at these files to match the tone and style of existing reference docs:
+- `docs/reference/agents.md`
+- `docs/reference/commands.md`
+- `docs/reference/testing.md`

package/tools/docs/fix-refs.md

@@ -0,0 +1,91 @@
+---
+title: Fix Documentation References
+description: Corrects workflow, agent, and command references in XiaoMa documentation
+---
+
+# Fix Documentation References
+
+## Scope
+
+Fix reference patterns ONLY. Do not modify links, formatting, structure, or other content.
+
+## Purpose
+
+Fix incorrect references to workflows, agents, and commands in XiaoMa documentation files.
+
+## Step 1: Establish Target Audience
+
+Before fixing references, determine who the document is for:
+
+| Audience | Indicators | Style |
+|----------|------------|-------|
+| **Newbies** | tutorials/, getting-started, installation/, "What You'll Learn" | Keep "workflow", include platform hints |
+| **Experienced** | reference/, explanation/ | Drop "workflow", no platform hints |
+| **How-To** | how-to/ | **Ask** — depends on the task |
+
+**How-To guides require judgment**: Don't assume experienced. Ask: "Does this task require prior XiaoMa knowledge?" Early-journey tasks (first PRD, first sprint) are newbie docs. Customization and advanced features are experienced.
+
+**If unclear**: Ask the user "Who is the target audience for this document — new users learning XiaoMa, or experienced users who know the system?"
+
+This determines whether helper words like "workflow" and platform hints are helpful context or just noise.
+
+## Reference Patterns to Fix
+
+### Always Wrong
+
+| Pattern | Example | Problem |
+|---------|---------|---------|
+| `*workflow` | `*prd` | Obsolete menu shortcut notation |
+| `/workflow` | `/workflow-init` | Platform-specific slash command |
+| `xiaoma_xmc_*` | `xiaoma_xmc_workflow-init` | Internal slash command name, platform-specific |
+
+### Correct Format
+
+Use backticks with plain workflow name:
+- **Wrong**: Run `/workflow-init`
+- **Wrong**: Run `*prd`
+
+**When to say "workflow"**:
+- **Newbie docs** (getting-started): "Run the `prd` workflow" — helps them learn what it is
+- **Other docs**: "Run `prd`" — they already know, so "workflow" is noise
+
+**Platform hint**: Only in newbie docs, and only on the **first** workflow mention:
+- First mention: Run the `help` workflow (`/xiaoma-help` on most platforms)
+- Subsequent mentions: Run `prd` — no hint, no "workflow" needed after they've seen the pattern
+
+In experienced docs, the hint is always noise — just use the workflow name.
+
+### Workflow Name Changes
+
+| Old Name | New Name | Notes |
+|----------|----------|-------|
+| `workflow-init` | `xiaoma-help` | DEPRECATED - help system replaces initialization |
+| `workflow-status` | `xiaoma-help` | DEPRECATED - help system replaces status checking |
+
+### The Help System
+
+The `xiaoma-help` workflow is the modern replacement for both `workflow-init` and `workflow-status`:
+- **Universal**: Works regardless of workflow state or module
+- **Contextual**: Infers completion from artifacts and conversation
+- **Adaptive**: Guides users through workflows based on phase ordering
+- **Anytime**: Can be run at any point, no pre-initialization needed
+
+Users can run `xiaoma-help` to get guidance on what to do next. It detects:
+- What workflows have been completed (by checking for output artifacts)
+- What module is active
+- What the next recommended/required step is
+
+## Lessons Learned
+
+1. **Platform-agnostic**: Docs should never include platform-specific invocation patterns (slashes, prefixes)
+2. **Backtick the name**: Use backticks around workflow names: `workflow-name`
+3. **Simple names**: Just the workflow name, no `xiaoma_xmc_` prefix, no `/` prefix
+
+## Self-Check
+
+Before finishing, verify you ONLY changed reference patterns:
+
+- [ ] Did I change any hyperlinks? **If yes, revert.**
+- [ ] Did I change any formatting (horizontal rules, whitespace, structure)? **If yes, revert.**
+- [ ] Did I remove or add any sections? **If yes, revert.**
+- [ ] Did I modify anything not matching the patterns in "Reference Patterns to Fix"? **If yes, revert.**

package/tools/docs/native-skills-migration-checklist.md

@@ -0,0 +1,281 @@
+# Native Skills Migration Checklist
+
+Branch: `refactor/all-is-skills`
+
+Scope: migrate the XiaoMa-supported platforms that fully support the Agent Skills standard from legacy installer outputs to native skills output.
+
+Current branch status:
+
+- `Claude Code` has already been moved to `.claude/skills`
+- `Codex CLI` has already been moved to `.agents/skills`
+
+This checklist now includes those completed platforms plus the remaining full-support platforms.
+
+## Claude Code
+
+Support assumption: full Agent Skills support. XiaoMa has already migrated from `.claude/commands` to `.claude/skills`.
+
+**Install:** `npm install -g @anthropic-ai/claude-code` or `brew install claude-code`
+
+- [x] Confirm current implementation still matches Claude Code skills expectations
+- [x] Confirm legacy cleanup for `.claude/commands`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy command output
+- [x] Confirm ancestor conflict protection because Claude Code inherits skills from parent directories and `ancestor_conflict_check: true` is set in platform-codes.yaml
+- [x] Implement/extend automated tests as needed
+
+## Codex CLI
+
+Support assumption: full Agent Skills support. XiaoMa has already migrated from `.codex/prompts` to `.agents/skills`.
+
+**Install:** `npm install -g @openai/codex`
+
+- [x] Confirm current implementation still matches Codex CLI skills expectations
+- [x] Confirm legacy cleanup for project and global `.codex/prompts`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy prompt output
+- [x] Confirm ancestor conflict protection because Codex inherits parent-directory `.agents/skills`
+- [x] Implement/extend automated tests as needed
+
+## Cursor
+
+Support assumption: full Agent Skills support. XiaoMa currently installs legacy command files to `.cursor/commands`; target should move to a native skills directory.
+
+- [x] Confirm current Cursor skills path and that XiaoMa should target `.cursor/skills`
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.cursor/commands`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy command output
+- [x] Confirm no ancestor conflict protection is needed because a child workspace surfaced child `.cursor/skills` entries but not a parent-only skill during manual verification
+- [x] Implement/extend automated tests
+- [x] Commit
+
+## Windsurf
+
+Support assumption: full Agent Skills support. Windsurf docs confirm workspace skills at `.windsurf/skills` and global skills at `~/.codeium/windsurf/skills`. XiaoMa has now migrated from `.windsurf/workflows` to `.windsurf/skills`. Manual verification also confirmed that Windsurf custom skills are triggered via `@skill-name`, not slash commands.
+
+- [x] Confirm Windsurf native skills directory as `.windsurf/skills`
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.windsurf/workflows`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy workflow output
+- [x] Confirm no ancestor conflict protection is needed because manual Windsurf verification showed child-local `@` skills loaded while a parent-only skill was not inherited
+- [x] Implement/extend automated tests
+
+## Cline
+
+Support assumption: full Agent Skills support. Cline docs confirm workspace skills at `.cline/skills/<skill-name>/SKILL.md` and global skills at `~/.cline/skills/`. XiaoMa has now migrated from `.clinerules/workflows` to `.cline/skills`.
+
+**Install:** VS Code extension `saoudrizwan.claude-dev` — search "Cline" in Extensions or `code --install-extension saoudrizwan.claude-dev`
+
+- [x] Confirm current Cline skills path is `.cline/skills/{skill-name}/SKILL.md` with YAML frontmatter (name + description)
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.clinerules/workflows`
+- [x] Test fresh install — 43 skills installed to `.cline/skills/`
+- [x] Test reinstall/upgrade from legacy workflow output
+- [x] Confirm no ancestor conflict protection is needed because Cline only scans workspace-local `.cline/skills/` and global `~/.cline/skills/`, with no ancestor directory inheritance
+- [x] Implement/extend automated tests — 9 assertions in test suite 18
+- [x] Commit
+
+## Google Antigravity
+
+Support assumption: full Agent Skills support. Antigravity docs confirm workspace skills at `.agent/skills/<skill-folder>/` and global skills at `~/.gemini/antigravity/skills/<skill-folder>/`. XiaoMa has now migrated from `.agent/workflows` to `.agent/skills`.
+
+- [x] Confirm Antigravity native skills path and project/global precedence
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.agent/workflows`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy workflow output
+- [x] Confirm no ancestor conflict protection is needed because manual Antigravity verification in `/tmp/antigravity-ancestor-repro/parent/child` showed only the child-local `child-only` skill, with no inherited parent `.agent/skills` entry
+- [x] Implement/extend automated tests
+
+## Auggie
+
+Support assumption: full Agent Skills support. XiaoMa currently installs commands to `.augment/commands`; target should move to `.augment/skills`.
+
+- [x] Confirm Auggie native skills path and compatibility loading from `.claude/skills` and `.agents/skills` via Augment docs plus local `auggie --print` repros
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.augment/commands`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy command output
+- [x] Confirm no ancestor conflict protection is needed because local `auggie --workspace-root` repro showed child-local `.augment/skills` loading `child-only` but not parent `parent-only`
+- [x] Implement/extend automated tests
+- [x] Commit
+
+## CodeBuddy
+
+Support assumption: full Agent Skills support. CodeBuddy docs confirm workspace skills at `.codebuddy/skills/<skill-name>/SKILL.md` and global skills at `~/.codebuddy/commands/`. XiaoMa has now migrated from `.codebuddy/commands` to `.codebuddy/skills`.
+
+**Install:** Download [Tencent CodeBuddy IDE](https://codebuddyide.net/) or install as VS Code extension `CodebuddyAI.codebuddy-ai`
+
+- [x] Confirm CodeBuddy native skills path is `.codebuddy/skills/{skill-name}/SKILL.md` with YAML frontmatter (name + description) — per docs, not IDE-verified
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.codebuddy/commands`
+- [x] Test fresh install — 43 skills installed to `.codebuddy/skills/` (installer output only)
+- [x] Test reinstall/upgrade from legacy command output
+- [ ] **NEEDS MANUAL IDE VERIFICATION** — requires Tencent Cloud account; confirm skills appear in UI and test ancestor inheritance
+- [x] Implement/extend automated tests — 9 assertions in test suite 19
+- [x] Commit
+
+## Crush
+
+Support assumption: full Agent Skills support. Crush scans project-local `.crush/skills/` exclusively ([GitHub issue #2072](https://github.com/charmbracelet/crush/issues/2072) confirms this and requests adding `~/.agents/skills/`). XiaoMa has now migrated from `.crush/commands` to `.crush/skills`.
+
+**Install:** `brew install charmbracelet/tap/crush` (macOS/Linux) or `winget install charmbracelet.crush` (Windows)
+
+- [x] Confirm Crush project-local skills path is `.crush/skills/{skill-name}/SKILL.md` — per GitHub issue #2072 confirming `.crush/skills/` is the only scan path
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.crush/commands`
+- [x] Test fresh install — 43 skills installed to `.crush/skills/`
+- [x] Test reinstall/upgrade from legacy command output
+- [x] Confirm no ancestor conflict protection is needed because Crush only scans project-local `.crush/skills/`, no ancestor inheritance
+- [x] Manual CLI verification — `crush run` lists all 10 skills and successfully triggers xiaoma-help
+- [x] Implement/extend automated tests — 9 assertions in test suite 20
+- [x] Commit
+
+## Kiro
+
+Support assumption: full Agent Skills support. Kiro docs confirm project skills at `.kiro/skills/<skill-name>/SKILL.md` and describe steering as a separate rules mechanism, not a required compatibility layer. XiaoMa has now migrated from `.kiro/steering` to `.kiro/skills`. Manual app verification also confirmed that Kiro can surface skills in Slash when the relevant UI setting is enabled, and that it does not inherit ancestor `.kiro/skills` directories.
+
+- [x] Confirm Kiro skills path and verify XiaoMa should stop writing steering artifacts for this migration
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.kiro/steering`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from legacy steering output
+- [x] Confirm no ancestor conflict protection is needed because manual Kiro verification showed Slash-visible skills from the current workspace only, with no ancestor `.kiro/skills` inheritance
+- [x] Implement/extend automated tests
+
+## OpenCode
+
+Support assumption: full Agent Skills support. XiaoMa currently splits output between `.opencode/agents` and `.opencode/commands`; target should consolidate to `.opencode/skills`.
+
+- [x] Confirm OpenCode native skills path and compatibility loading from `.claude/skills` and `.agents/skills` in OpenCode docs and with local `opencode run` repros
+- [x] Implement installer migration from multi-target legacy output to single native skills target
+- [x] Add legacy cleanup for `.opencode/agents`, `.opencode/commands`, `.opencode/agent`, and `.opencode/command`
+- [x] Test fresh install
+- [x] Test reinstall/upgrade from split legacy output
+- [x] Confirm ancestor conflict protection is required because local `opencode run` repros loaded both child-local `child-only` and ancestor `parent-only`, matching the docs that project-local skill discovery walks upward to the git worktree
+- [x] Implement/extend automated tests
+- [x] Commit
+
+## Roo Code
+
+Support assumption: full Agent Skills support. XiaoMa currently installs commands to `.roo/commands`; target should move to `.roo/skills` or the correct mode-aware skill directories.
+
+**Install:** VS Code extension `RooVeterinaryInc.roo-cline` — search "Roo Code" in Extensions or `code --install-extension RooVeterinaryInc.roo-cline`
+
+- [x] Confirm Roo native skills path is `.roo/skills/{skill-name}/SKILL.md` with `name` frontmatter matching directory exactly (lowercase, alphanumeric + hyphens only)
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.roo/commands`
+- [x] Test fresh install — 43 skills installed, verified in Roo Code v3.51
+- [x] Test reinstall/upgrade from legacy command output
+- [x] Confirm no ancestor conflict protection is needed because manual Roo Code v3.51 verification showed child-local `child-only` skill loaded while parent-only skill was not inherited
+- [x] Implement/extend automated tests — 7 assertions in test suite 13
+- [x] Commit
+
+## Trae
+
+Support assumption: full Agent Skills support. [Trae docs](https://docs.trae.ai/ide/skills) confirm workspace skills at `.trae/skills/<skill-name>/SKILL.md`. XiaoMa has now migrated from `.trae/rules` to `.trae/skills`.
+
+**Install:** Download [standalone IDE](https://www.trae.ai/download) (macOS/Windows/Linux) or `winget install -e --id ByteDance.Trae`
+
+- [x] Confirm Trae native skills path is `.trae/skills/{skill-name}/SKILL.md` — per official docs
+- [x] Implement installer migration to native skills output
+- [x] Add legacy cleanup for `.trae/rules`
+- [x] Test fresh install — 43 skills installed to `.trae/skills/`
+- [x] Test reinstall/upgrade from legacy rules output
+- [x] Confirm no ancestor conflict protection is needed — Trae docs describe project-local `.trae/skills/` only
+- [ ] **NEEDS MANUAL IDE VERIFICATION** — download Trae IDE and confirm skills appear in UI
+- [x] Implement/extend automated tests — 9 assertions in test suite 21
+- [x] Commit
+
+## GitHub Copilot
+
+Support assumption: full Agent Skills support. XiaoMa currently uses a custom installer that generates `.github/agents`, `.github/prompts`, and `.github/copilot-instructions.md`; target should move to `.github/skills`.
+
+**Install:** VS Code extension `GitHub.copilot` — search "GitHub Copilot" in Extensions or `code --install-extension GitHub.copilot`
+
+- [x] Confirm GitHub Copilot native skills path is `.github/skills/{skill-name}/SKILL.md` — also reads `.claude/skills/` automatically
+- [x] Design the migration away from the custom prompt/agent installer model — replaced 699-line custom installer with config-driven `skill_format: true`
+- [x] Implement native skills output, ideally with shared config-driven code where practical
+- [x] Add legacy cleanup for `.github/agents`, `.github/prompts`, and XiaoMa markers in `copilot-instructions.md`
+- [x] Test fresh install — 43 skills installed to `.github/skills/`
+- [x] Test reinstall/upgrade from legacy custom installer output — legacy dirs removed, XiaoMa markers stripped, user content preserved
+- [x] Confirm no ancestor conflict protection is needed because manual Copilot verification showed child-local `child-only` skill loaded while parent-only skill was not inherited
+- [x] Implement/extend automated tests — 11 assertions in test suite 17 including marker cleanup
+- [x] Commit
+
+## KiloCoder — SUSPENDED
+
+**Status: Kilo Code does not support the Agent Skills standard.** The original migration assumed skills support because Kilo forked from Roo Code, but manual IDE verification confirmed Kilo has not merged that feature. XiaoMa support is paused until Kilo implements skills.
+
+**Install:** VS Code extension `kilocode.kilo-code` — search "Kilo Code" in Extensions or `code --install-extension kilocode.kilo-code`
+
+- [x] ~~Confirm KiloCoder native skills path~~ — **FALSE**: assumed from Roo Code fork, not verified. Manual testing showed no skills support in the IDE
+- [x] Config and installer code retained in platform-codes.yaml with `suspended` flag — hidden from IDE picker, setup blocked with explanation
+- [x] Installer fails early (before writing `_xiaoma/`) if Kilo is the only selected IDE, protecting existing installations
+- [x] Legacy cleanup still runs for `.kilocode/workflows` and `.kilocodemodes` when users switch to a different IDE
+- [x] Automated tests — 7 assertions in suite 22 (suspended config, hidden from picker, setup blocked, no files written, legacy cleanup)
+
+## Gemini CLI
+
+Support assumption: full Agent Skills support. Gemini CLI docs confirm workspace skills at `.gemini/skills/` and user skills at `~/.gemini/skills/`. Also discovers `.agents/skills/` as an alias. XiaoMa previously installed TOML files to `.gemini/commands`.
+
+**Install:** `npm install -g @google/gemini-cli` or see [geminicli.com](https://geminicli.com)
+
+- [x] Confirm Gemini CLI native skills path is `.gemini/skills/{skill-name}/SKILL.md` (per [geminicli.com/docs/cli/skills](https://geminicli.com/docs/cli/skills/))
+- [x] Implement native skills output — target_dir `.gemini/skills`, skill_format true, template_type default (replaces TOML templates)
+- [x] Add legacy cleanup for `.gemini/commands` (via `legacy_targets`)
+- [x] Test fresh install — skills written to `.gemini/skills/xiaoma-master/SKILL.md` with correct frontmatter
+- [x] Test reinstall/upgrade from legacy TOML command output — legacy dir removed, skills installed
+- [x] Confirm no ancestor conflict protection is needed — Gemini CLI uses workspace > user > extension precedence, no ancestor directory inheritance
+- [x] Implement/extend automated tests — 9 assertions in test suite 23 (config, fresh install, legacy cleanup, reinstall)
+- [x] Manual CLI verification — `gemini` lists all 10 skills and successfully triggers xiaoma-help
+- [ ] Commit
+
+## iFlow
+
+Support assumption: full Agent Skills support. iFlow docs confirm workspace skills at `.iflow/skills/` and global skills at `~/.iflow/skills/`. XiaoMa previously installed flat files to `.iflow/commands`.
+
+- [x] Confirm iFlow native skills path is `.iflow/skills/{skill-name}/SKILL.md`
+- [x] Implement native skills output — target_dir `.iflow/skills`, skill_format true, template_type default
+- [x] Add legacy cleanup for `.iflow/commands` (via `legacy_targets`)
+- [x] Test fresh install — skills written to `.iflow/skills/xiaoma-master/SKILL.md`
+- [x] Test legacy cleanup — legacy commands dir removed
+- [x] Implement/extend automated tests — 6 assertions in test suite 24
+- [ ] **NEEDS MANUAL IDE VERIFICATION** — install iFlow and confirm skills appear in UI and can be triggered
+- [ ] Commit
+
+## QwenCoder
+
+Support assumption: full Agent Skills support. Qwen Code supports workspace skills at `.qwen/skills/` and global skills at `~/.qwen/skills/`. XiaoMa previously installed flat files to `.qwen/commands`.
+
+- [x] Confirm QwenCoder native skills path is `.qwen/skills/{skill-name}/SKILL.md`
+- [x] Implement native skills output — target_dir `.qwen/skills`, skill_format true, template_type default
+- [x] Add legacy cleanup for `.qwen/commands` (via `legacy_targets`)
+- [x] Test fresh install — skills written to `.qwen/skills/xiaoma-master/SKILL.md`
+- [x] Test legacy cleanup — legacy commands dir removed
+- [x] Implement/extend automated tests — 6 assertions in test suite 25
+- [ ] **NEEDS MANUAL IDE VERIFICATION** — install QwenCoder and confirm skills appear in UI and can be triggered
+- [ ] Commit
+
+## Rovo Dev
+
+Support assumption: full Agent Skills support. Rovo Dev now supports workspace skills at `.rovodev/skills/` and user skills at `~/.rovodev/skills/`. XiaoMa previously used a custom 257-line installer that wrote `.rovodev/workflows/` and `prompts.yml`.
+
+- [x] Confirm Rovo Dev native skills path is `.rovodev/skills/{skill-name}/SKILL.md` (per Atlassian blog)
+- [x] Replace 257-line custom `rovodev.js` with config-driven entry in `platform-codes.yaml`
+- [x] Add legacy cleanup for `.rovodev/workflows` (via `legacy_targets`) and XiaoMa entries in `prompts.yml` (via `cleanupRovoDevPrompts()` in `_config-driven.js`)
+- [x] Test fresh install — skills written to `.rovodev/skills/xiaoma-master/SKILL.md`
+- [x] Test legacy cleanup — legacy workflows dir removed, `prompts.yml` XiaoMa entries stripped while preserving user entries
+- [x] Implement/extend automated tests — 8 assertions in test suite 26
+- [ ] **NEEDS MANUAL IDE VERIFICATION** — install Rovo Dev and confirm skills appear in UI and can be triggered
+- [ ] Commit
+
+## Summary Gates
+
+- [x] All full-support XiaoMa platforms install `SKILL.md` directory-based output
+- [x] No full-support platform still emits XiaoMa command/workflow/rule files as its primary install format
+- [x] Legacy cleanup paths are defined for every migrated platform
+- [x] Automated coverage exists for config-driven and custom-installer migrations
+- [ ] Installer docs and migration notes updated after code changes land