# PARA Workspace
**人类与 AI Agent 的工作空间框架**
[](https://opensource.org/licenses/MIT)
[](../../CHANGELOG.md)
[](https://antigravity.google/)
🇺🇸 English •
🇻🇳 Tiếng Việt •
🇨🇳 中文 •
🇪🇸 Español •
🇫🇷 Français
---
| 章节 | 说明 |
| :-- | :-- |
| [🌌 概述](#-概述) | 什么是 PARA Workspace，三大基础原则 |
| [📂 架构](#-架构) | 仓库结构 + 生成的工作空间结构 |
| [📥 安装](#-安装) | 先决条件、设置、配置文件、故障排除 |
| [🧠 内核](#-内核) | 不变原则、启发式规则、契约 |
| [🛠️ CLI 参考](#-cli-参考) | 所有 CLI 命令 |
| [📑 工作流目录](#-工作流目录) | 32 个受治理的工作流 |
| [🛡️ 规则目录](#-规则目录) | 14 条治理规则 |
| [🧩 技能目录](#-技能目录) | 21 个可复用技能 |
| [🔌 工具系统](#-工具系统-v180) | 安装外部 Agentic 插件 |
| [🧩 任务管理](#-任务管理混合-3-文件模型) | 混合 3-文件模型 |
| [🔄 升级](#-升级版本) | 自动更新 + 全新安装 |
| [🗺️ 路线图](#-路线图) | 版本历史 + 计划中的功能 |
## 🌌 概述
**PARA Workspace** 是一个开源工作空间框架，定义了人类和 AI Agent 如何组织知识并协作完成项目。它以 **代码仓库(repo)** 的形式分发，包含内核（宪法）、CLI 工具和模板 —— 并据此生成您实际进行工作的 **工作空间(workspace)**。内核强制执行各项不变原则和启发式规则，使每个工作空间都具有可预测性、可审计性且对 AI Agent 友好。
### 三大基础原则
1. **Repo ≠ Workspace（仓库 ≠ 工作空间）** — 仓库仅包含治理内容（内核、CLI、模板），不包含任何用户数据。
2. **Workspace = Runtime（工作空间 = 运行时）** — 由 `para init` 生成，每个工作空间是一个独立的实例，您与您的 Agent 在其中协同工作。
3. **Kernel = Constitution（内核 = 宪法）** — 所有工作空间必须遵循的不可变规则。对规则的更改需要通过 RFC 提案 + 升级版本号。
```mermaid
flowchart TD
R["🏛️ Repo\n(宪法 + 编译器)"]
W["💻 Workspace\n(操作系统 Runtime)"]
A["🤖 Agent\n(环境执行)"]
R -->|para init| W
W -->|agent attach| A
style R fill:#4a90d9,stroke:#2c5f8a,color:#fff
style W fill:#50c878,stroke:#2e8b57,color:#fff
style A fill:#ff8c42,stroke:#cc6633,color:#fff
```
---
## 📂 架构
### 仓库结构 (本仓库)
```
para-workspace/
├── .github/ # 🤖 CI/CD — validate-pr.yml, CODEOWNERS
├── rfcs/ # 📝 RFC 提案流程 — TEMPLATE.md
├── kernel/ # 🧠 宪法 (Constitution)
│ ├── KERNEL.md
│ ├── invariants.md # 11条硬性规则 (修改需升 MAJOR 版)
│ ├── heuristics.md # 10条软性约定
│ ├── schema/ # workspace, project, backlog 等的 JSON Schema
│ └── examples/ # 有效/无效的合规模板示例
├── cli/ # 🔧 编译器 (Compiler)
│ ├── para # 入口脚本 (兼容 Bash 3.2+)
│ ├── lib/ # 核心库 logger, validator, rollback 等
│ └── commands/ # init, scaffold, status, migrate, install 等命令
├── templates/ # 📦 脚手架与受治理库
│ ├── common/agents/ # 工作流, 规则, 技能 及 catalog.yml
│ │ └── projects/ # .project.yml 模板
│ └── profiles/ # dev, general 预设配置
├── tests/ # 🧪 kernel/ 与 cli/ 的集成测试
├── docs/ # 📖 文档
├── CONTRIBUTING.md
├── VERSIONING.md
├── CHANGELOG.md
└── VERSION
```
### 工作空间结构 (由 `para init` 生成)
```