@mison/ling

v1.2.4

Published

2 days ago

面向 Gemini CLI、Antigravity 与 Codex 的中文 AI Agent 模板工具包

0High
0Medium
0Low

mison

ling ai agent gemini skills templates

灵轨（Ling）

面向 Gemini CLI、Antigravity 与 Codex 的中文 AI Agent 模板工具包，提供 Skills、Agents、Workflows 与 CLI 的一键安装、更新和治理。

快速安装

npm install -g @mison/ling

ling 解决三件事：

项目内安装 Gemini / Antigravity / Codex 资产
全局同步可复用 Skills
为项目启用 Spec 工作流

最常见的项目初始化：

cd /path/to/your-project
ling init --target gemini
ling init --target antigravity
ling init --target codex

如果要同时安装多个目标：

ling init --targets gemini,antigravity,codex

如果你要先做全局 Skills 安装：

ling global sync
ling global sync --target codex
ling global sync --target gemini
ling global sync --target antigravity

先选模式

| 你要做什么 | 命令 | 结果 | | --- | --- | --- | | 给当前项目安装完整资产 | ling init | 项目内生成 .agent/ / .agents/；共享 .agent/ 时会维护 .ling/install-state.json | | 给电脑全局同步可复用 Skills | ling global sync | 写入 ~/.agents/skills/、~/.gemini/skills/、~/.gemini/antigravity/skills/；若与 universal 根目录重复，会自动清理 Gemini CLI 副本 | | 给项目启用 Spec 工作流 | ling spec init | 项目内生成 issues.csv 等 Spec 资产 |

一句话区分：

init 面向项目
global sync 面向整台电脑
spec init 面向项目里的任务驱动流程

项目安装

项目安装是默认用法，也是能力最完整的模式。

gemini 写入项目内 .agent/
antigravity 写入项目内 .agent/（与 Gemini 复用目录，命令与状态独立）
codex 写入项目内 .agents/
Ling 会在项目内写入 .ling/install-state.json，用于记录共享 .agent/ 上到底注册了 gemini、antigravity 还是两者
Codex 额外注入工作区 AGENTS.md 和 ling.rules

cd /path/to/your-project
ling init --target gemini
ling init --target antigravity
ling init --target codex
ling update
ling doctor

非交互环境下，init 必须显式传 --target 或 --targets。

全局 Skills

全局模式只做一件事：把 Skills 同步到真实消费端目录，方便跨项目复用。

ling global sync
ling global sync --target codex
ling global sync --target gemini
ling global sync --target antigravity
ling global status

codex -> ~/.agents/skills/
gemini -> ~/.gemini/skills/（若已存在 ~/.agents/skills/，会自动移除重复副本，避免 Gemini CLI 冲突提示）
antigravity -> ~/.gemini/antigravity/skills/

若检测到旧版 ~/.codex/skills/，ling global sync --target codex 会将其迁移到 ~/.agents/skills/ 并清理，避免 Skills 重复（冲突内容会先备份到 ~/.ling/backups/global/<timestamp>/codex-legacy/...）。

全局模式不会写入项目 Rules、Agents、Workflows，也不会改你的全局 ~/.codex/rules。

Spec

Spec 是核心进阶功能，但理解它只需要记住两句：

ling spec enable 给这台电脑安装全局 Spec 工具箱
ling spec init 给当前项目创建真正要用的 issues.csv

也就是说：

全局 Spec 负责模板、参考资料、约束
项目里的 issues.csv 永远放在项目根目录

最常用的两种方式：

# 完整模式：项目自带 Spec 资产
cd /path/to/your-project
ling spec init

# 轻量模式：只在项目里放 issues.csv，其他能力走全局后备
cd /path/to/your-project
ling spec enable
ling spec init --csv-only

你会得到：

完整模式：<project>/.ling/spec/、<project>/issues.csv、<project>/docs/reviews/、<project>/docs/handoff/
--csv-only：<project>/issues.csv、<project>/docs/reviews/、<project>/docs/handoff/
全局 Spec 资源：~/.ling/spec/templates/、~/.ling/spec/references/、~/.ling/spec/profiles/

如果这台电脑已经有 ~/.agents/skills/，ling spec enable 在启用 gemini 目标时也会自动清理 ~/.gemini/skills/ 里的同名重复副本；若同名 Skill 内容不同，则会保留 Gemini 专用版本，不会误删。

如果你只想要一个本机演练空间，而不是某个真实项目：

ling spec init --spec-workspace

spec doctor 用于检查当前项目的 Spec 状态。

常用命令

| 命令 | 用途 | | --- | --- | | ling init | 在项目内安装目标资产 | | ling update | 更新当前项目已安装目标 | | ling doctor | 诊断当前项目安装状态 | | ling status | 输出项目安装状态 | | ling global sync | 全局同步 Skills | | ling global status | 查看全局 Skills 状态 | | ling spec enable | 启用全局 Spec 工具箱 | | ling spec init | 在当前项目初始化 Spec | | ling spec doctor | 检查当前项目 Spec 状态 | | ling update-all | 批量更新已登记项目 |

常用示例：

ling init --targets gemini,antigravity,codex --path ./myapp
ling init --target antigravity --path ./myapp
ling init --target codex --force --path ./myapp
ling update --path ./myapp
ling doctor --target codex --fix --path ./myapp
ling spec enable
ling spec init --csv-only --path ./myapp
ling update-all --targets antigravity,codex
ling global sync --quiet --dry-run

文档

使用说明

ling 的仓库模板源是 .agents/
文本与模板资源使用 UTF-8 与 LF
不会自动写入全局 ~/.codex/rules
如果 AI 编辑器依赖索引，请不要把 .agent/、.agents/ 放进项目 .gitignore

版本约定：

npm 版本遵循 SemVer
Git tag 和 ling --version 显示为 ling-<SemVer>

源码方式运行：

git clone https://github.com/MisonL/Ling.git
cd Ling
npm install
node bin/ling.js init --target codex --path /path/to/your-project

包含内容

| 组件 | 数量 | 描述 | | --- | --- | --- | | Agents（智能体） | 20 | 专家级 AI 人设（前端、后端、安全、产品、QA 等） | | Skills（技能） | 49 | 特定领域的知识模块（以 SKILL.md 为准，含子技能目录） | | Workflows（工作流） | 12 | 斜杠命令流程 |

工作流与命令

工作流通过斜杠命令触发：

| 命令 | 描述 | | --- | --- | | /brainstorm | 在实施前探索方案 | | /create | 创建新功能或应用 | | /debug | 系统化调试 | | /deploy | 部署应用 | | /enhance | 改进现有代码 | | /orchestrate | 多智能体协同 | | /plan | 创建任务拆解 | | /preview | 本地预览变更 | | /restore-localize-compat | 文档机制对齐与语义汉化流程（维护工作流） | | /status | 检查项目状态 | | /test | 生成并运行测试 | | /ui-ux-pro-max | 50 种风格的设计 |

技能会按上下文自动加载，不需要手工管理大多数 Skill。

开发维护命令

npm run clean           # 清理本地生成产物（如 web/.next、web/node_modules）
npm run clean:dry-run   # 预览将被清理的路径
npm test                # 执行 tests/ 目录下测试
npm run health-check    # 一键执行全链路健康复检

如果你在 web/ 子项目内开发，可按需执行：

cd web
npm install
npm run lint

卸载

npm uninstall -g @mison/ling

旧包和上游旧包如已安装，可一并清理：

npm uninstall -g @mison/ag-kit-cn
npm uninstall -g antigravity-kit @vudovn/ag-kit

macOS / Linux / WSL:

cd /path/to/your-project
rm -rf .agent .agents .agents-backup .codex

Windows PowerShell:

Set-Location C:\path\to\your-project
Remove-Item .agent,.agents,.agents-backup,.codex -Recurse -Force -ErrorAction SilentlyContinue

Windows CMD:

cd /d C:\path\to\your-project
rmdir /s /q .agent
rmdir /s /q .agents
rmdir /s /q .agents-backup
rmdir /s /q .codex

可选：把某个项目移出批量更新索引

ling exclude add --path /path/to/your-project

全局卸载只会移除 ling 命令，不会删除你本地 clone 的源码目录。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme