YLDev AI Kit

面向 AI 编程工具链的 Kit 化初始化、资源安装、配置管理与本地工作台。

YLDev AI Kit 将 skills、agents、MCP 配置、项目模板与工具适配器组合为可复用的工程能力，并通过统一 CLI 安装到 Codex、Claude Code、Cursor、Kiro、Qwen Code、Qoder、Trae、WorkBuddy 等 AI 编程工具的约定目录中。

它的目标不是替代某一个 AI 工具，而是让团队可以用同一套项目规范、资源目录和配置事实源，稳定地管理多个 AI 工具的接入方式。

Philosophy

AI 工具越多，项目约定越需要集中治理。

YLDev AI Kit 采用 Kit 驱动的资源组织方式：Kit 只声明能力组合，资源保持独立维护，适配器负责落到不同工具的真实目录。这样可以避免把工具差异散落在项目里，也方便团队后续升级、替换或扩展能力。

Quick Start

通过 npm 全局安装：

npm install -g yldev-ai-kit

查看 CLI：

yldev-ai-kit --help

在目标项目中初始化：

yldev-ai-kit init --project .

安装资源、补齐配置并执行健康检查：

yldev-ai-kit install --project .
yldev-ai-kit configure --project .
yldev-ai-kit doctor --project .

启动本地工作台：

yldev-ai-kit dashboard --project .

也可以不全局安装，直接使用 npx：

npx yldev-ai-kit init --project .

What You Get

• 统一 CLI：提供 init、install、configure、doctor、dashboard、sync、upgrade、projects 等命令。
• Kit 化资源组合：用 Kit 组合 skills、agents、MCP、templates 和工具适配器。
• 多工具安装适配：将资源安装到不同 AI 编程工具的项目级或用户级目录。
• 项目事实源：通过 .ai-kit/manifest.json 记录项目已选 Kit、目标工具和资源状态。
• 配置生成：通过 .ai-kit/config.yml 和 .ai-kit/config.example.yml 管理真实配置与示例配置。
• 本地 Dashboard：查看项目、资源、配置、Doctor 检查和 Markdown 文档。

Commands

# 初始化项目
yldev-ai-kit init --project .

# 安装或刷新资源
yldev-ai-kit install --project .

# 配置所有缺失项
yldev-ai-kit configure --project .

# 配置指定资源
yldev-ai-kit configure --project . --resource mcp:deploy-mid

# 重置单个配置项
yldev-ai-kit configure --project . --reset mcp.deploy-mid.token

# 运行健康检查
yldev-ai-kit doctor --project .

# 启动 Dashboard
yldev-ai-kit dashboard --project .

# 同步或升级项目资源
yldev-ai-kit sync --project .
yldev-ai-kit upgrade --project .

# 查看用户级项目登记
yldev-ai-kit projects list

Documentation

• 使用指南
• 架构说明
• 迁移说明

Project Layout

adapters/    目标 AI 编程工具的安装适配器
agents/      可由 Kit 引用的工具代理资源
cli/         yldev-ai-kit CLI 与 Dashboard 实现
docs/        正式文档
discuss/     方案、计划、评审和发布记录
kits/        Kit manifest，声明套件类型、依赖和资源组合
mcp/         MCP 资源 manifest 与 cli.yml
skills/      可由 Kit 引用的技能资源
templates/   项目初始化模板

references/ 仅用于本地参考资料，不进入提交与 npm 发布包。

Development

安装依赖：

pnpm install

构建 CLI 与 Dashboard：

pnpm build

运行测试：

pnpm test

源码模式运行：

node cli/bin/yldev-ai-kit.js --help

Updating

已初始化项目可以通过以下命令同步或升级资源：

yldev-ai-kit sync --project .
yldev-ai-kit upgrade --project .

升级前建议先执行：

yldev-ai-kit doctor --project .

Package

npm 包包含 CLI 入口、构建产物、adapters、agents、mcp、kits、templates 与 skills。

不会进入发布包的内容包括测试产物、源码 map、Python 缓存、本地测试 skill、本地 tarball，以及项目根目录的 references/。

Status

当前版本：0.1.0

该版本提供 CLI 与 Dashboard 的基础闭环，适合在受控项目中试点使用。正式接入团队流程前，建议先在示例项目中完整验证 init、configure、install、doctor 与 dashboard。

Contributing

欢迎围绕以下方向改进：

• 新增或优化 AI 编程工具适配器
• 扩展 Kit 与资源 manifest
• 完善 Dashboard 的项目管理能力
• 拆分偏大的 CLI 或 Dashboard 模块
• 补充更多端到端验证场景

正式方案、计划和评审文档请写入 discuss/；稳定文档请写入 docs/。

License

MIT