@mdsfe/mds-cli

MDS 命令行工具，旨在高效完成项目初始化、规范配置及环境维护。

🚀 快速开始

安装/更新

# 全局安装
npm install -g @mdsfe/mds-cli

# 快捷更新
mds up

常用命令

• 项目初始化: mds init <project-name>
  根据 MDS 标准模板快速创建应用。
• SDD 工作流初始化: mds sdd
  一键配置业务项目内的 SDD 环境（生成 .agent、.specify、项目宪法等），并自动补齐必需的技能套件（如 speckit、init-vitepress 等）。
• Cybervisor 流水线初始化: mds cybervisor
  一键为任意前后端项目生成 cybervisor.yaml 流水线配置，接入 AI 驱动的自动化工作流。
• OpenCode 团队模板: mds opencode
  一键生成 opencode.jsonc、.gitignore 补丁、bootstrap-opencode.sh 和 opencode-local.sh，适合给团队项目快速接入 OpenCode。
• 技能管理 (Skills): mds skills
  支持罗列、批量安装、套件安装。支持分发到已检测到的用户级技能目录（Codex, Cursor, Antigravity 等）。
• 环境诊断: mds doctor
  检查当前网络、Registry 认证及 NodeJS 环境。

🛠 SDD 开发流程

1. 初始化: 在项目根目录下运行 mds sdd。
2. 编写规范: 在 .specify 中定义需求。
3. 能力对齐: 如需手动补齐技能，使用 mds skills speckit 安装全量 SDD 专家套件。

🤖 Cybervisor 流水线初始化

Cybervisor 是一个 AI 驱动的本地任务流水线工具，支持将自然语言提示编排为可复现的自动化工作流。mds cybervisor 命令可为任意前后端项目一键生成 cybervisor.yaml 初始化配置，无需手动编写流水线文件。

前置依赖

# 安装 cybervisor（需 Python 3.9+）
pip install cybervisor

使用方式

在项目根目录下运行：

# 生成默认流水线配置（simple 模板）
mds cybervisor

# 使用 speckit 模板（适合 SDD 规范驱动项目）
mds cybervisor --template speckit

# 强制覆盖已有的 cybervisor.yaml
mds cybervisor --force

执行后会在当前目录生成：

• cybervisor.yaml — 流水线主配置文件，定义任务阶段（stage）、提示词（prompt）及产出验证逻辑

生成后的典型工作流

# 1. 初始化配置
mds cybervisor --template speckit

# 2. 按需编辑 cybervisor.yaml 中的 prompt 和 stages

# 3. 执行流水线
cybervisor run

# 4. 查看任务状态
cybervisor status

# 5. 验证配置合法性
cybervisor validate cybervisor.yaml

模板说明

| 模板 | 适用场景 | |------|---------| | simple | 通用前后端项目，快速接入单阶段任务流 | | speckit | SDD 规范驱动项目，包含需求分析、原型还原等多阶段任务链 |

🧠 技能管理 (MDS Skills)

mds skills 支持从全局注册中心拉取最新的专家能力。

核心特性

• 一键套件安装: 支持安装元技能（Meta Skills），如 mds skills speckit 会自动安装分析、计划、任务拆解等全套 10 个 SDD 技能。
• 批量安装: 支持逗号分隔的批量安装，如 mds skills git-mr-review,init-vitepress。
• 依赖自愈: 安装技能时会自动解析并补齐其声明的所有依赖项。

常用指令

# 1. 远程查看当前可用 skills
mds skills --list

# 2. 安装整个 Speckit SDD 专家套件 (推荐)
mds skills speckit

# 3. 批量安装多个特定技能
mds skills igit-mr-review,init-vitepress,node-env-guide

# 4. 指定安装目标工具
mds skills speckit --tool codex,cursor,antigravity

# 5. 强制更新本地已安装的技能
mds skills speckit --force

🤖 OpenCode 团队模板

如果你想给一个现有项目快速补齐 OpenCode 的项目级配置，推荐直接运行：

mds opencode

它会在当前目录生成：

• opencode.jsonc
• scripts/bootstrap-opencode.sh
• scripts/opencode-local.sh
• .gitignore 中缺失的 .opencode.local/

也支持自定义 Provider 和模型：

mds opencode . \
  --provider-id qianfan \
  --provider-name "Baidu Qianfan Coding" \
  --default-model qianfan/glm-5 \
  --small-model qianfan/ernie-4.5-turbo-20260402

❓ 常见问题排查 (Troubleshooting)

如果您在安装或升级时遇到问题，请先运行 mds doctor。

1. 权限不足 (EACCES)

如果在执行 mds up 或 npm install -g 时报 EACCES 错误：

• mds up 会优先自动回退到用户级安装目录（默认 ~/.npm-global）。
• 重新打开终端或执行 source ~/.zshrc 即可使 PATH 生效。

2. 文件冲突 (EEXIST)

如果报错 EEXIST: file already exists，请执行强制覆盖：

npm install -g @mdsfe/mds-cli --force

3. Snapshot 同步 (开发者)

CLI 内置了技能注册表的快照，可通过以下命令手动同步最新远程状态：

npm run skills:sync

📦 发布指南 (核心维护者)

# 小版本迭代 (0.x.0) - 推荐用于新特性发布
npm run release:minor

# 修订号更新 (0.0.x)
npm run release:patch