---
source: ../../README.md
source_version: 5.2.0
translation_version: 5.2.0
last_synced: 2026-04-22
status: current
---

# Universal Development Standards

[![npm version](https://img.shields.io/npm/v/universal-dev-standards.svg)](https://www.npmjs.com/package/universal-dev-standards)
[![License: MIT + CC BY 4.0](https://img.shields.io/badge/License-MIT%20%2B%20CC%20BY%204.0-blue.svg)](../../LICENSE)
[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-green.svg)](https://nodejs.org/)

> **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文

**版本**: 5.17.0 | **发布日期**: 2026-05-28 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)

语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。

---

## 🚀 快速开始

### 通过 npm 安装（推荐）

```bash
# 全局安装（稳定版）
npm install -g universal-dev-standards

# 初始化项目
uds init
```

> 寻找 beta 或 RC 版本？请参阅 [预发布版本](../../docs/PRE-RELEASE.md)。

### 或使用 npx（无需安装）

```bash
npx universal-dev-standards init
```

> **注意**：仅复制标准文件不会启用 AI 协助功能。请使用 `uds init` 自动配置 AI 工具，或手动在工具配置文件中引用标准。

### 🗺️ 安装后下一步

| 我想要... | 命令 |
| :--- | :--- |
| **理解现有代码库** | `/discover` |
| **用规格驱动开发新功能** | `/sdd` |
| **处理遗留代码** | `/reverse` |
| **选择开发方法论** | `/methodology` |
| **编写规范化的 commit** | `/commit` |

> **提示**：输入 `/dev-workflow` 获取完整的开发阶段指南与所有可用命令。
>
> 另请参阅：[每日开发工作流程指南](adoption/DAILY-WORKFLOW-GUIDE.md)

---

## ✨ 功能特色

<!-- UDS_STATS_TABLE_START -->
| 类别 | 数量 | 说明 |
|----------|-------|-------------|
| **核心标准** | 127 | 通用开发准则 |
| **AI Skills** | 54 | 互动式技能 |
| **斜线命令** | 48 | 快速操作 |
| **CLI 命令** | 6 | list, init, configure, check, update, skills |
<!-- UDS_STATS_TABLE_END -->

> **5.0 新功能？** 请参阅[预发布说明](../../docs/PRE-RELEASE.md)了解新功能详情。

---

## 🏗️ 系统架构

UDS 采用 **双层执行模型 (Dual-Layer Execution Model)**，专为高速互动开发与深度技术合规而设计。

```mermaid
graph TD
    A[AI 助手 / 开发者] --> B{执行层}
    B -- "日常任务" --> C["技能层 Skills (.ai.yaml)"]
    B -- "深度审查" --> D["标准层 Standards (.md)"]
    
    C --> C1[Token 优化]
    C --> C2[互动式引导]
    
    D --> D1[完整理论与定义]
    D --> D2[工具自动化配置]
    
    C1 -. "回退机制" .-> D1
```

| 面向 | 技能层 Skills (执行层) | 核心标准 Standards (知识库) |
| :--- | :--- | :--- |
| **格式** | YAML 优化 | 完整 Markdown |
| **目标** | 高速互动与快速查询 | 深度理解与理论依据 |
| **Token 使用** | 极小（AI 友好） | 详细（参考文献） |

---

## 🤖 AI 工具支持

| AI 工具 | 状态 | Skills | 斜线命令 | 配置文件 |
| :--- | :--- | :---: | :---: | :--- |
| **Claude Code** | ✅ 完整支持 | **29** | **33** | `CLAUDE.md` |
| **OpenCode** | ✅ 完整支持 | **29** | **33** | `AGENTS.md` |
| **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** | `.cursorrules` |
| **Roo Code** | ✅ 完整支持 | **核心** | **工作流** | `.roo/rules/` |
| **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |
| **Cline** | 🔶 部分支持 | **核心** | **工作流** | `.clinerules` |
| **Windsurf** | 🔶 部分支持 | **核心** | **规则书** | `.windsurfrules` |
| **GitHub Copilot** | 🔶 部分支持 | **核心** | **提示词** | `.github/copilot-instructions.md` |
| **OpenAI Codex** | 🔶 部分支持 | **核心** | — | `AGENTS.md` |
| **Aider** | 🔶 部分支持 | — | — | `AGENTS.md` |
| **Continue** | 🔶 部分支持 | — | — | `.continue/config.json` |
| **Google Antigravity** | ⚠️ 最低限度 | — | — | `.antigravity/rules.md` |

> **状态图例**：✅ 完整支持 | 🧪 预览版 | 🔶 部分支持 | ⚠️ 最低限度 | ⏳ 计划中

---

## 📦 安装方式

### CLI 工具（主要方式）

**npm（推荐）**
```bash
npm install -g universal-dev-standards
uds init        # 交互式初始化
uds check       # 检查采用状态
uds update      # 更新至最新版本
uds config      # 管理偏好设置（语言、模式）
uds uninstall   # 从项目移除标准
```

---

## ⚙️ 设置

使用 `uds config` 管理您的偏好设置：

| 参数 | 命令示例 | 说明 |
| :--- | :--- | :--- |
| **提交语言** | `uds config --lang zh-CN` | 设置 AI 提交消息的偏好语言 |
| **标准等级** | `uds init --level 2` | 选择采用深度 (1: 基本, 3: 全面) |
| **工具模式** | `uds config --mode skills` | 在 Skills、Standards 或两者之间切换 |

---

## 👥 贡献

1. **建议改进**：开立 issue 说明问题与解决方案。
2. **添加示例**：提交实际使用示例。
3. **扩展标准**：贡献语言/框架/领域扩展。

详细准则请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。

---

## 📄 授权

| 组件 | 授权 |
| :--- | :--- |
| **文档内容** | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
| **CLI 工具** | [MIT](../../cli/LICENSE) |

## 致谢

UDS 的架构灵感来自以下杰出的开源项目：

| 项目 | 借鉴概念 | 授权 |
|------|---------|------|
| [Superpowers](https://github.com/obra/superpowers) | 系统性调试、代理调度、验证证据 | MIT |
| [GSD](https://github.com/gsd-build/get-shit-done) | 结构化任务定义、可追溯性矩阵、验证循环上限 | MIT |
| [PAUL](https://github.com/ChristopherKahler/paul) | Plan-Apply-Unify 循环、验收驱动开发 | MIT |
| [CARL](https://github.com/ChristopherKahler/carl) | 上下文感知加载、动态规则注入 | MIT |
| [CrewAI](https://github.com/crewAIInc/crewAI) | 多代理通信协议、上下文预算追踪 | MIT |
| [LangGraph](https://github.com/langchain-ai/langgraph) | 工作流状态协议、HITL 中断检查点 | MIT |
| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | 事件溯源、动作-观察流模式 | MIT |
| [DSPy](https://github.com/stanfordnlp/dspy) | 代理签名、结构化 I/O 契约 | MIT |

> **注意**：UDS 仅借鉴概念与方法论，不包含上述项目的任何源代码。

---

**由开源社区用 ❤️ 维护**
