dotai

安装

新的 .claude/settings.json 文件

npx shadcn@latest add https://raw.githubusercontent.com/udecode/dotai/main/registry/all.json

已存在的 .claude/settings.json 文件

Dotai:

/plugin marketplace add https://github.com/udecode/dotai
/plugin install dotai notification debug test dig codex

Claude Plugins Official:

/plugin install ralph-loop@@claude-plugins-official
/plugin install frontend-design@@claude-plugins-official

Compound Engineering:

/plugin marketplace add https://github.com/kieranklaassen/compound-engineering-plugin
/plugin install compound-engineering

组件

组件	数量
插件	7
命令	5
技能	3

插件

插件	描述
dotai	开发工具包 - 文档与规划
debug	四阶段调试框架
test	TDD 工作流程 - 红绿重构
dig	克隆并探索库源代码
notification	macOS 通知
media	自动播放/暂停媒体
codex	用于 Codex 的 MCP 服务器

命令

文档

命令	描述
/dotai:create-app-design	生成应用设计文档
/dotai:update-app-design	更新现有应用设计文档
/dotai:create-tech-stack	生成技术栈文档
/dotai:update-tech-stack	更新现有技术栈文档
/dotai:install	安装插件文件

技能

技能会根据上下文自动调用。

调试

技能	插件	描述
debug	debug	内置深度堆栈追踪的四阶段调试过程

测试

技能	插件	描述
tdd	test	测试驱动开发 - 先写测试，观察失败，再使其通过

研究

技能	插件	描述
dig	dig	克隆并探索库源代码以解答 API 问题

提示系统

通过 .claude/prompt.yml 进行动态提示注入：

钩子	描述
beforeStart	Claude 回答前的检查清单
beforeComplete	宣称完成前的验证事项
afterCompact	压缩后恢复上下文

示例配置：

beforeStart:
  - tag: SKILL-ANALYSIS
    header: 🎯 技能检查
    todos:
      - "列出可用技能，调用适用的技能"

beforeComplete:
  - tag: VERIFICATION
    header: 🔒 验证
    todos:
      - "类型检查：bun typecheck"
      - "代码风格检查：bun lint:fix"

Compound Engineering

工作流命令

命令	描述
/workflows:lfg	完全自主工作流（计划 → 执行 → 审查 → 浏览器测试 → 录制视频）
/workflows:brainstorm	在计划之前探索需求
/workflows:plan	创建实施计划
/workflows:review	运行全面的代码审查
/workflows:work	有条不紊地执行任务
/workflows:compound	记录已解决的问题

代理（27）

• 审查（14）：agent-native-reviewer、architecture-strategist、code-simplicity-reviewer、data-integrity-guardian、deployment-verification-agent、dhh-rails-reviewer、kieran-rails-reviewer、kieran-python-reviewer、kieran-typescript-reviewer、pattern-recognition-specialist、performance-oracle、security-sentinel、julik-frontend-races-reviewer、data-migration-expert
• 研究（4）：best-practices-researcher、framework-docs-researcher、git-history-analyzer、repo-research-analyst
• 设计（3）：design-implementation-reviewer、design-iterator、figma-design-sync
• 工作流（5）：bug-reproduction-validator、every-style-editor、lint、pr-comment-resolver、spec-flow-analyzer
• 文档（1）：ankane-readme-writer

技能（14）

agent-native-architecture、andrew-kane-gem-writer、compound-docs、create-agent-skills、dhh-rails-style、dspy-ruby、frontend-design、skill-creator、every-style-editor、file-todos、git-worktree、rclone、agent-browser、gemini-imagegen

MCP 服务器

context7 - 框架文档查询（Rails、React、Next.js、Vue、Django、Laravel 等）

开发

请参阅 CONTRIBUTING.md。

许可证

MIT

dotai 快速上手指南

dotai 是一套专为 Claude Code 设计的开发工具集，包含插件、命令和技能，旨在优化文档规划、调试、测试驱动开发（TDD）及代码审查工作流。

环境准备

• 操作系统：推荐 macOS（部分插件如 notification 依赖 macOS 特性），Linux/Windows 需确认具体兼容性。
• 前置依赖：
  • 已安装 Node.js (建议 LTS 版本)。
  • 已安装并配置好 Claude Code CLI 工具。
  • 项目根目录下存在 .claude 配置目录。

安装步骤

根据你的项目配置情况，选择以下任一方式安装核心组件。

方式一：新项目初始化（推荐）

如果你还没有 .claude/settings.json 文件，或希望重置配置，使用 shadcn 风格的一键安装：

npx shadcn@latest add https://raw.githubusercontent.com/udecode/dotai/main/registry/all.json

方式二：现有项目添加

如果已有 .claude/settings.json 文件，请通过插件市场手动添加并安装所需模块：

1. 添加 dotai 市场源并安装核心插件：

   /plugin marketplace add https://github.com/udecode/dotai
   /plugin install dotai notification debug test dig codex
   

2. (可选) 安装官方精选插件：

   /plugin install ralph-loop@@claude-plugins-official
   /plugin install frontend-design@@claude-plugins-official
   

3. (可选) 安装复合工程插件 (Compound Engineering)：

   /plugin marketplace add https://github.com/kieranklaassen/compound-engineering-plugin
   /plugin install compound-engineering
   

基本使用

安装完成后，你可以通过内置命令、自动技能或配置文件来增强开发体验。

1. 使用文档生成命令

快速生成或更新项目设计与技术栈文档：

/dotai:create-app-design   # 生成应用设计文档
/dotai:create-tech-stack   # 生成技术栈文档

若需更新现有文档：

/dotai:update-app-design
/dotai:update-tech-stack

2. 体验自动化技能 (Skills)

技能会根据上下文自动触发，无需手动输入命令：

• 调试 (debug)：当遇到错误时，自动启动四阶段深度调试流程。
• 测试 (tdd)：在编写功能时，自动遵循“红 - 绿 - 重构”的 TDD 流程。
• 源码探索 (dig)：当询问第三方库 API 时，自动克隆并分析源码以提供准确答案。

3. 配置动态提示词 (Prompt System)

在项目根目录创建或编辑 .claude/prompt.yml，定义任务开始前后的检查清单。

示例配置：

beforeStart:
  - tag: SKILL-ANALYSIS
    header: 🎯 Skill Check
    todos:
      - "List available skills, invoke applicable ones"

beforeComplete:
  - tag: VERIFICATION
    header: 🔒 Verify
    todos:
      - "Typecheck: bun typecheck"
      - "Lint: bun lint:fix"

4. 高级工作流 (需安装 Compound Engineering)

执行全自动开发循环或专项任务：

/workflows:lfg        # 全自主工作流：计划 -> 编码 -> 审查 -> 浏览器测试 -> 录屏
/workflows:plan       # 创建详细的实施计划
/workflows:review     # 运行全面的代码审查