feat(core): add Lingma IDE support

[caohuanglin]

PR Description

Summary

Added Lingma IDE support to OpenSpec. Lingma IDE is an Alibaba product with millions of users in China. It recently added skills and slash command support, making OpenSpec integration essential to serve this large user base with structured AI-assisted development workflows. Official website:https://lingma.aliyun.com/

Changes

• Added lingma.ts command adapter with proper file path structure (.lingma/commands/opsx-<id>.md)
• Updated registry to include Lingma adapter
• Added Lingma to legacy cleanup patterns
• Created comprehensive tests covering all adapter functionality
• Updated documentation in supported-tools.md

Key Features

• Generates 10 command files with YAML frontmatter format
• Creates proper skill directory structure
• Supports all standard OPSX workflow commands
• Cross-platform path handling

Generated with Qwen using Lingma IDE

Summary by CodeRabbit

• New Features

  • Lingma is now available as a supported tool in OpenSpec for command generation and skill management.

• Documentation

  • CLI docs and tool reference updated to list Lingma and include it in non-interactive setup examples.

• Tests

  • Added test coverage to validate Lingma adapter behavior and cross-platform path handling.

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds first-class support for the Lingma tool: new command adapter, adapter export and registry registration, AI_TOOLS config entry, docs updates, and tests covering file path and Markdown/YAML formatting.

Changes

Cohort / File(s)	Summary
New Lingma Adapter src/core/command-generation/adapters/lingma.ts	Implements lingmaAdapter: ToolCommandAdapter with toolId: 'lingma', getFilePath producing .lingma/commands/opsx/<id>.md, and formatFile emitting Markdown with YAML frontmatter (name, description, category, tags) plus body.
Adapter Export & Registry src/core/command-generation/adapters/index.ts, src/core/command-generation/registry.ts	Exports lingmaAdapter from adapters index and registers it in CommandAdapterRegistry static initializer.
Configuration src/core/config.ts	Adds { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' } to AI_TOOLS.
Documentation docs/supported-tools.md, docs/cli.md	Adds Lingma to supported-tools reference and CLI docs; documents skills and commands paths and includes lingma in available tool IDs.
Tests test/core/command-generation/adapters.test.ts	Adds tests for lingmaAdapter: validates toolId, file path generation for multiple commands, YAML frontmatter fields and tags, and includes Lingma in cross-platform path checks.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• feat(cli): add multi-provider skill generation support #556: Adds/registers Lingma adapter and AI_TOOLS entry (directly related implementation).
• feat: add Qoder CLI support to configuration and documentation #261: Adds a new AI tool and modifies src/core/config.ts AI_TOOLS entries (similar pattern).
• feat: add Qwen Code support with slash command integration #250: Adds support for another AI tool and updates AI_TOOLS (same config area).

Suggested reviewers

• TabishB

Poem

🐰 I hopped in bytes and chewed the log,
Lingma seeds sown under opsx bog.
YAML tidings, tags in line,
Registry hums — a tool divine.
Hop, push, commit — the garden's fine! 🥕✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat(core): add Lingma IDE support' directly and clearly summarizes the main change: adding support for the Lingma IDE tool to the OpenSpec core functionality.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

No actionable comments were generated in the recent review. 🎉

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[caohuanglin]

As shown in the screenshot, the commands can be successfully triggered.

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@src/core/legacy-cleanup.ts`:
- Line 36: Remove the mistaken legacy-cleanup entry for 'lingma' that points to
'.lingma/commands/opsx' so live Lingma output isn't deleted; specifically delete
the mapping with key 'lingma' in the legacy-cleanup registry (the entry
"'lingma': { type: 'directory', path: '.lingma/commands/opsx' }") so
detectLegacySlashCommands and cleanupLegacyArtifacts no longer treat the current
Lingma adapter output (see adapters/lingma.ts) as a legacy path.

🧹 Nitpick comments (1)

src/core/command-generation/adapters/lingma.ts (1)

22-32: Align YAML value escaping with windsurf and claude adapters.

The lingma adapter leaves YAML values unquoted, which fails if name, description, category, or tags contain special characters (:, #, [, {, etc.). Other adapters in this codebase—specifically windsurf and claude—already implement escapeYamlValue() for defensive YAML formatting. Adopt the same pattern here for consistency and robustness.

Example using escapeYamlValue pattern

+/**
+ * Escapes YAML special characters in scalar values.
+ */
+function escapeYamlValue(value: string): string {
+  if (/[:#\[\]{},&*!'"|>@`]|^[-?]/.test(value)) {
+    return `"${value.replace(/"/g, '\\"')}"`;
+  }
+  return value;
+}
+
+/**
+ * Formats a tags array as a YAML array with proper escaping.
+ */
+function formatTagsArray(tags: string[]): string {
+  const escapedTags = tags.map((tag) => escapeYamlValue(tag));
+  return `[${escapedTags.join(', ')}]`;
+}
+
 export const lingmaAdapter: ToolCommandAdapter = {
   toolId: 'lingma',
 
   getFilePath(commandId: string): string {
     return path.join('.lingma', 'commands', 'opsx', `${commandId}.md`);
   },
 
   formatFile(content: CommandContent): string {
-    const tagsStr = content.tags.join(', ');
     return `---
-name: ${content.name}
-description: ${content.description}
-category: ${content.category}
-tags: [${tagsStr}]
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
 ---
 
 ${content.body}`;
   },
 };