# ai-codespec 安装指南

以下步骤面向 AI Agent。


## 环境要求

开始安装之前，请确保环境中已具备：

- Node.js 18+（`npm` / `npx`）
- 公司 GitLab Package Registry 访问权限
- 团队只读 npm Token

如未安装 Node.js，请先按团队《Node.js 环境安装指南》安装后**重开终端**：<https://vvcazjv268.feishu.cn/wiki/I0KywUlJNiYH0RkZ3hmc1nzZnIf>

## 第 1 步 配置 npm Registry 与 Token

Agent 让用户提供团队只读 Token（飞书 Wiki 安装指南中提供），然后执行：

```shell
# 配置 @ai scope 指向公司私有 Registry
npm config set "@ai:registry" "https://git.manifoldtech.cn/api/v4/projects/ai%2Fai-codespec/packages/npm/"

# 配置只读 Token（把 <TOKEN> 替换为团队提供的实际值）
npm config set "//git.manifoldtech.cn/api/v4/projects/ai%2Fai-codespec/packages/npm/:_authToken" "glpat-WoFFcrVOCrrkz_DEjiVpNm86MQp1OjIwCA.01.0y16dsfbm"
```

## 第 2 步 安装

```shell
# 全局安装 CLI
npm install -g @ai/ai-codespec
```

## 第 3 步 同步团队资产

```shell
# 同步 Windsurf 全局 skills 与 workflows
ai-codespec install
```

## 第 4 步 验证

```shell
ai-codespec --version
ai-codespec status
```

## 升级与清理

```shell
# 更新团队资产
ai-codespec update

# 更新并清理已下线的 mt-* 团队资产
ai-codespec update --clean
```

更多命令与能力指南，可参考 [ai-codespec 用户使用指南](https://vvcazjv268.feishu.cn/wiki/Uqszwg4VnirByFkfKc6co93HncF)。