aiox-core 5.0.0

package/docs/zh/CHANGELOG.md

@@ -0,0 +1,191 @@
+<!--
+  翻译：zh-CN（简体中文）
+  原文：/docs/CHANGELOG.md
+  最后同步：2026-02-22
+  说明：仅翻译标题和描述，保留技术内容
+-->
+
+# 变更日志
+
+> 🌐 [EN](../CHANGELOG.md) | [PT](../pt/CHANGELOG.md) | [ES](../es/CHANGELOG.md) | **ZH**
+
+---
+
+Synkra AIOX 的所有重要变更都将记录在此文件中。
+
+本格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)，
+本项目遵循 [语义化版本](https://semver.org/spec/v2.0.0.html)。
+
+---
+
+## [2.2.0] - 2026-01-29
+
+### 新增
+
+- **AIOX 自主开发引擎 (ADE)**：完整的自主开发系统，包含 7 个 Epic：
+  - **Epic 1 - Worktree Manager**：用于并行 story 开发的 Git worktree 隔离
+  - **Epic 2 - Migration V2→V3**：autoClaude V3 格式及能力标志
+  - **Epic 3 - Spec Pipeline**：将需求转换为可执行规范
+  - **Epic 4 - Execution Engine**：13 步子任务执行，强制自我批评
+  - **Epic 5 - Recovery System**：自动故障恢复，含尝试跟踪和回滚
+  - **Epic 6 - QA Evolution**：10 阶段结构化审查流程
+  - **Epic 7 - Memory Layer**：用于模式、洞察和注意事项的持久记忆
+
+- **新代理命令**：
+  - `@devops`: `*create-worktree`, `*list-worktrees`, `*merge-worktree`, `*cleanup-worktrees`, `*inventory-assets`, `*analyze-paths`, `*migrate-agent`, `*migrate-batch`
+  - `@pm`: `*gather-requirements`, `*write-spec`
+  - `@architect`: `*assess-complexity`, `*create-plan`, `*create-context`, `*map-codebase`
+  - `@analyst`: `*research-deps`, `*extract-patterns`
+  - `@qa`: `*critique-spec`, `*review-build`, `*request-fix`, `*verify-fix`
+  - `@dev`: `*execute-subtask`, `*track-attempt`, `*rollback`, `*capture-insights`, `*list-gotchas`, `*apply-qa-fix`
+
+- **新脚本**：
+  - `worktree-manager.js`, `story-worktree-hooks.js`, `project-status-loader.js`
+  - `asset-inventory.js`, `path-analyzer.js`, `migrate-agent.js`
+  - `subtask-verifier.js`, `plan-tracker.js`
+  - `recovery-tracker.js`, `approach-manager.js`, `rollback-manager.js`, `stuck-detector.js`
+  - `qa-loop-orchestrator.js`, `qa-report-generator.js`
+  - `codebase-mapper.js`, `pattern-extractor.js`, `gotchas-documenter.js`
+
+- **新工作流**：
+  - `auto-worktree.yaml` - 为 story 自动创建 worktree
+  - `spec-pipeline.yaml` - 5 阶段规范流水线
+  - `qa-loop.yaml` - QA 审查和修复循环
+
+- **新任务**（15+ 个 ADE 新任务）：
+  - Spec Pipeline: `spec-gather-requirements.md`, `spec-assess-complexity.md`, `spec-research-dependencies.md`, `spec-write-spec.md`, `spec-critique.md`
+  - Execution: `plan-create-implementation.md`, `plan-create-context.md`, `plan-execute-subtask.md`
+  - QA: `qa-review-build.md`, `qa-fix-issues.md`, `qa-structured-review.md`
+  - Memory: `capture-session-insights.md`
+  - Worktree: `worktree-create.md`, `worktree-list.md`, `worktree-merge.md`
+
+- **JSON Schemas**：
+  - `agent-v3-schema.json` - V3 代理定义验证
+  - `task-v3-schema.json` - V3 任务定义验证
+
+- **模板**：
+  - `spec-tmpl.md` - 规范文档模板
+  - `qa-report-tmpl.yaml` - QA 报告模板
+
+- **检查清单**：
+  - `self-critique-checklist.md` - 开发者强制自我批评
+
+- **文档**：
+  - [ADE 完整指南](guides/ade-guide.md) - 完整教程
+  - [Epic 1-7 交接文档](architecture/) - 技术交接（ADE-EPIC-1 至 ADE-EPIC-7）
+  - [代理变更](architecture/ADE-AGENT-CHANGES.md) - 所有代理修改及能力矩阵
+
+### 变更
+
+- **代理格式**：所有 12 个代理已迁移到 autoClaude V3 格式及能力标志
+- **代理同步**：所有代理现在在 `.aiox-core/development/agents/` 和 `.claude/commands/AIOX/agents/` 之间同步
+
+### 修复
+
+- 所有 ADE Epic 的代理命令注册
+- V3 格式的 Schema 验证
+
+---
+
+## [2.1.0] - 2025-01-24
+
+### 新增
+
+- **交互式安装向导**：逐步引导设置，含组件选择
+- **多 IDE 支持**：支持 4 个 IDE（Claude Code、Cursor、Gemini CLI、GitHub Copilot）
+- **Squads 系统**：模块化附加组件，包括 HybridOps 用于 ClickUp 集成
+- **跨平台测试**：Windows、macOS 和 Linux 的完整测试覆盖
+- **错误处理和回滚**：安装失败时自动回滚并提供恢复建议
+- **代理改进**：
+  - `dev` 代理在 yolo 模式下的决策日志
+  - `qa` 代理的待办事项管理命令
+  - CodeRabbit 集成用于自动代码审查
+  - 带有项目状态的上下文问候
+- **文档套件**：
+  - 故障排除指南，含 23 个已记录问题
+  - 22 个问答的 FAQ
+  - v2.0 到 v4.0.4 的迁移指南
+
+### 变更
+
+- **目录结构**：`.legacy-core/` 重命名为 `.aiox-core/`
+- **配置格式**：增强 `core-config.yaml`，新增 git、projectStatus 和 sharding 选项部分
+- **代理格式**：更新代理 YAML schema，含 persona_profile、commands visibility 和 whenToUse 字段
+- **IDE 配置**：Claude Code 代理移至 `.claude/commands/AIOX/agents/`
+- **文件位置**：
+  - `docs/architecture/coding-standards.md` → `docs/framework/coding-standards.md`
+  - `docs/architecture/tech-stack.md` → `docs/framework/tech-stack.md`
+  - `.aiox-core/utils/` → `.aiox-core/scripts/`
+
+### 修复
+
+- Windows 长路径安装失败
+- PowerShell 执行策略阻止脚本
+- Linux/macOS 上的 npm 权限问题
+- 安装后 IDE 配置未应用
+
+### 废弃
+
+- 手动安装流程（改用 `npx @synkra/aiox-core install`）
+- `.legacy-core/` 目录名称（自动迁移）
+
+### 安全
+
+- 增加安装目录验证以防止系统目录修改
+- 改进环境变量和 API 密钥的处理
+
+---
+
+## [2.0.0] - 2024-12-01
+
+### 新增
+
+- Synkra AIOX 首次公开发布
+- 11 个专业 AI 代理（dev、qa、architect、pm、po、sm、analyst、ux-expert、data-engineer、devops、db-sage）
+- 任务工作流系统，含 60+ 个预构建任务
+- 模板系统，含 20+ 个文档模板
+- 故事驱动开发方法论
+- 基本 Claude Code 集成
+
+### 已知问题
+
+- 需要手动安装（2-4 小时）
+- 有限的跨平台支持
+- 无交互式向导
+
+---
+
+## [1.0.0] - 2024-10-15
+
+### 新增
+
+- 首次内部发布
+- 核心代理框架
+- 基本任务执行
+
+---
+
+## 迁移说明
+
+### 从 2.0.x 升级到 2.1.x
+
+**快速升级：**
+
+```bash
+npx @synkra/aiox-core install --force-upgrade
+```
+
+**主要变更：**
+
+1. 目录重命名：`.legacy-core/` → `.aiox-core/`
+2. 使用新字段更新 `core-config.yaml`
+3. 重新运行 IDE 配置
+
+---
+
+## 链接
+
+- [故障排除](./installation/troubleshooting.md)
+- [FAQ](./installation/faq.md)
+- [GitHub 仓库](https://github.com/SynkraAI/aiox-core)
+- [Issue 追踪器](https://github.com/SynkraAI/aiox-core/issues)

package/docs/zh/ENVIRONMENT.md

@@ -0,0 +1,136 @@
+<!-- 翻译：zh-CN 原文：/docs/ENVIRONMENT.md 最后同步：2026-02-22 -->
+
+# 环境变量
+
+> 🌐 [EN](../ENVIRONMENT.md) | [PT](../pt/ENVIRONMENT.md) | [ES](../es/ENVIRONMENT.md) | **ZH**
+
+---
+
+本文档列出了 Synkra AIOX 及其组件使用的所有环境变量。
+
+## 概述
+
+Synkra AIOX 使用环境变量进行配置、API 密钥和敏感信息。**切勿在存储库中提交环境变量。**
+
+## 必需的环境变量
+
+### 框架核心
+
+当前，Synkra AIOX 不需要任何必需的环境变量来进行基本操作。所有配置都通过 `core-config.yaml` 和 Squad 配置文件进行。
+
+## 可选的环境变量
+
+### GitHub 集成
+
+如果您正在使用 GitHub CLI 功能：
+
+```bash
+GITHUB_TOKEN=your_github_token_here
+```
+
+**注意：** GitHub CLI (`gh`) 会自动管理身份验证。只有在直接使用 GitHub API 时，此变量才是必需的。
+
+### Squads
+
+某些 Squads 可能需要环境变量。请查看每个 Squad 的 README 获取具体要求。
+
+#### ETL Squad
+
+```bash
+# 可选：数据源的 API 密钥
+YOUTUBE_API_KEY=your_youtube_api_key
+TWITTER_API_KEY=your_twitter_api_key
+# ... 其他服务的 API 密钥
+```
+
+#### 私有 Squads
+
+私有 Squads（在 `aiox-Squads` 存储库中）可能需要额外的环境变量。请查看每个 Squad 的文档。
+
+## 环境文件配置
+
+### 创建 `.env` 文件
+
+1. 复制示例文件（如果可用）：
+   ```bash
+   cp .env.example .env
+   ```
+
+2. 或在项目根目录创建新的 `.env` 文件：
+   ```bash
+   touch .env
+   ```
+
+3. 添加您的环境变量：
+   ```bash
+   # .env
+   GITHUB_TOKEN=your_token_here
+   YOUTUBE_API_KEY=your_key_here
+   ```
+
+### 加载环境变量
+
+Synkra AIOX 使用 `dotenv`（如果已安装）加载 `.env`。若依赖 Node.js 原生能力，请明确使用 `--env-file` 或等效方式加载。
+
+**重要：** `.env` 文件在 gitignore 中，永远不会被提交到存储库。
+
+## 安全最佳实践
+
+1. **切勿提交 `.env` 文件** - 它们会被 gitignore 自动忽略
+2. **切勿提交 API 密钥或 secrets** - 改用环境变量
+3. **为开发和生产使用不同的值** - 创建 `.env.development` 和 `.env.production` 文件
+4. **定期轮换 secrets** - 特别是在它们可能被泄露的情况下
+5. **使用 secrets 管理工具** - 对于生产部署，考虑使用以下服务：
+   - AWS Secrets Manager
+   - Azure Key Vault
+   - HashiCorp Vault
+   - GitHub Secrets (用于 CI/CD)
+
+## CI/CD 的环境变量
+
+对于 GitHub Actions 和其他 CI/CD 管道，使用平台的 secrets 管理：
+
+### GitHub Actions
+
+```yaml
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  CUSTOM_SECRET: ${{ secrets.CUSTOM_SECRET }}
+```
+
+### 其他 CI/CD 平台
+
+请查看您的平台文档获取 secrets 管理：
+- **GitLab CI：** 使用 GitLab CI/CD 变量
+- **CircleCI：** 使用 CircleCI 环境变量
+- **Jenkins：** 使用 Jenkins 凭证
+
+## 故障排除
+
+### 环境变量未加载
+
+1. 检查 `.env` 文件是否存在于项目根目录
+2. 检查 `.env` 文件的语法（`=` 周围没有空格）
+3. 重启您的开发服务器/进程
+4. 检查是否已安装 `dotenv`（如需要）
+
+### 缺少环境变量
+
+如果您看到有关缺少环境变量的错误：
+1. 查看本文档了解必需的变量
+2. 查看 Squad 文档
+3. 检查 `.env` 文件是否包含所有必需的变量
+4. 确保 `.env` 文件位于正确位置（项目根目录）
+
+## 贡献
+
+添加新的环境变量时：
+1. 在本文档中记录它们
+2. 将它们添加到 `.env.example`（如果创建）
+3. 更新相关文档
+4. 确保 `.env` 在 `.gitignore` 中
+
+---
+
+**最后更新：** 2025-11-12
+**Story：** 4.8 - Repository Open-Source Migration

package/docs/zh/FEATURE_PROCESS.md

@@ -0,0 +1,92 @@
+# 功能请求流程
+
+> 🌐 [EN](../FEATURE_PROCESS.md) | [PT](../pt/FEATURE_PROCESS.md) | [ES](../es/FEATURE_PROCESS.md) | **ZH**
+
+---
+
+本文档说明了如何为 AIOX 提出新功能。
+
+## 快速想法
+
+对于快速想法或小的改进：
+
+1. 在"想法"类别中打开讨论
+2. 描述问题和建议的解决方案
+3. 社区和维护者将讨论
+4. 如果有兴趣，可能会升级为 RFC
+
+## RFC 流程（用于重大功能）
+
+对于需要设计决策的较大功能：
+
+### 何时编写 RFC
+
+- 新的主要功能
+- 破坏性更改
+- 重大架构更改
+- 影响许多用户的更改
+
+### RFC 生命周期
+
+1. **草稿**：作者使用我们的 [RFC 模板](../../.github/RFC_TEMPLATE.md) 编写 RFC
+2. **审查中**：2 周评论期
+3. **决策**：维护者接受/拒绝
+4. **实施**：如果被接受，实施开始
+
+### 接受标准
+
+- 符合项目愿景
+- 技术上可行
+- 有明确的实施路径
+- 社区需求已证明
+- 长期可维护
+
+## 投票
+
+- 使用 :+1: 反应表示支持
+- 最受欢迎的想法优先考虑
+- 维护者有最终决定权
+
+## 时间线
+
+- 想法：没有固定的时间表
+- RFC：最少 2 周审查期
+- 实施：基于路线图容量
+
+## 从想法到实施
+
+```text
+社区想法（讨论）
+        │
+        │ [由维护者批准]
+        ▼
+内部待办项目
+        │
+        │ [由产品所有者优先考虑]
+        ▼
+冲刺规划
+        │
+        │ [由开发团队实施]
+        ▼
+发布（在 CHANGELOG.md 中标记）
+```
+
+### 谁可以添加到待办事项？
+
+产品所有者（@po）是向内部待办事项添加项目的唯一权限。
+
+### 贡献者鸣谢
+
+实施其想法的贡献者将在以下地方获得鸣谢：
+
+- CHANGELOG.md 发布说明
+- 实施该功能的 PR
+- 我们的贡献者页面（如适用）
+
+## 问题？
+
+在 GitHub Discussions 或 Discord 中提问。
+
+---
+
+_另请参阅：[社区手册](./community.md) | [贡献指南](./contributing.md)_

package/docs/zh/GLOSSARY.md

@@ -0,0 +1,179 @@
+# Synkra AIOX 术语表
+
+> 本术语表定义了 Synkra AIOX 文档中使用的核心术语的标准中文翻译。
+
+---
+
+## 核心概念
+
+| 英文 | 简体中文 | 繁体中文 | 定义 |
+|------|----------|----------|------|
+| **Agent** | 代理 | 代理 | AI 驱动的专业角色，负责特定领域任务 |
+| **Meta-Agent** | 元代理 | 元代理 | 协调其他代理的主控制代理 |
+| **AIOX Master** | AIOX 主控 | AIOX 主控 | 系统的顶级协调代理 |
+| **Squad** | 小队 | 小隊 | 一组协作代理的集合 |
+| **Persona** | 角色 / 人格 | 角色 / 人格 | 代理的性格和专业特征定义 |
+
+---
+
+## 开发概念
+
+| 英文 | 简体中文 | 繁体中文 | 定义 |
+|------|----------|----------|------|
+| **Story** | 故事 | 故事 | 开发任务的基本单位（可保留英文） |
+| **Epic** | 史诗 / Epic | Epic | 大型功能的分组（通常保留英文） |
+| **Task** | 任务 | 任務 | 可执行的单一操作 |
+| **Workflow** | 工作流 | 工作流程 | 定义任务执行顺序的流程 |
+| **Pipeline** | 流水线 | 管線 | 自动化处理流程 |
+| **Gate** | 门控 | 門控 | 质量检查点 |
+
+---
+
+## 项目类型
+
+| 英文 | 简体中文 | 繁体中文 | 定义 |
+|------|----------|----------|------|
+| **Greenfield** | 绿地项目 | 全新專案 | 从零开始的新项目 |
+| **Brownfield** | 棕地项目 | 既有專案 | 在现有代码基础上开发 |
+
+---
+
+## 系统组件
+
+| 英文 | 简体中文 | 繁体中文 | 定义 |
+|------|----------|----------|------|
+| **Memory Layer** | 记忆层 | 記憶層 | 存储和检索上下文信息的系统 |
+| **Constitution** | 宪法 / 准则 | 憲法 / 準則 | AIOX 的核心规则和原则 |
+| **Orchestration** | 编排 | 編排 | 协调多个代理的过程 |
+| **Hook** | 钩子 | 鉤子 | 事件触发的回调函数 |
+| **MCP** | MCP | MCP | Model Context Protocol（不翻译） |
+| **SYNAPSE** | SYNAPSE | SYNAPSE | 上下文引擎（不翻译） |
+| **CLI** | CLI / 命令行 | CLI / 命令列 | 命令行界面 |
+
+---
+
+## 代理名称
+
+| 英文代号 | 角色名 | 中文描述 |
+|----------|--------|----------|
+| **@dev** | Dex | 全栈开发者 |
+| **@qa** | Quinn | 质量保证工程师 |
+| **@architect** | Aria | 系统架构师 |
+| **@pm** | Morgan | 产品经理 |
+| **@po** | Pax | 产品负责人 |
+| **@sm** | River | Scrum Master |
+| **@analyst** | Atlas | 研究分析师 |
+| **@data-engineer** | Dara | 数据工程师 |
+| **@ux** | Uma | UX 设计专家 |
+| **@devops** | Gage | DevOps 工程师 |
+
+---
+
+## 技术术语
+
+| 英文 | 简体中文 | 繁体中文 | 备注 |
+|------|----------|----------|------|
+| **Self-Modifying** | 自修改 | 自修改 | 系统特性 |
+| **Framework** | 框架 | 框架 | |
+| **Repository** | 仓库 / 代码库 | 倉庫 / 程式庫 | |
+| **Branch** | 分支 | 分支 | Git 概念 |
+| **Commit** | 提交 | 提交 | Git 概念 |
+| **Pull Request** | 拉取请求 / PR | Pull Request | 可保留英文 |
+| **Merge** | 合并 | 合併 | |
+| **Template** | 模板 | 範本 | |
+| **Schema** | 模式 / 架构 | 綱要 | 数据结构定义 |
+| **Migration** | 迁移 | 遷移 | 数据库概念 |
+| **RLS** | RLS | RLS | Row Level Security |
+
+---
+
+## 质量相关
+
+| 英文 | 简体中文 | 繁体中文 | 定义 |
+|------|----------|----------|------|
+| **Quality Gate** | 质量门控 | 品質門控 | 代码提交前的检查点 |
+| **Lint / Linting** | 代码检查 | 程式碼檢查 | 静态代码分析 |
+| **Type Check** | 类型检查 | 型別檢查 | TypeScript 类型验证 |
+| **Code Review** | 代码审查 | 程式碼審查 | |
+| **Test Coverage** | 测试覆盖率 | 測試覆蓋率 | |
+
+---
+
+## 命令相关
+
+| 英文 | 简体中文 | 说明 |
+|------|----------|------|
+| `*help` | 帮助 | 显示可用命令 |
+| `*task` | 执行任务 | 运行指定任务 |
+| `*workflow` | 执行工作流 | 运行指定工作流 |
+| `*create-story` | 创建故事 | 创建新的开发故事 |
+| `*exit` | 退出 | 退出当前代理模式 |
+
+---
+
+## 不翻译的术语
+
+以下术语在中文文档中保持英文：
+
+- **Synkra** - 品牌名
+- **AIOX** - 系统名称
+- **Claude** - AI 模型名
+- **MCP** - 协议名
+- **SYNAPSE** - 系统名
+- **JSON/YAML** - 数据格式
+- **Git/GitHub** - 工具名
+- **npm/Node.js** - 工具名
+- **TypeScript/JavaScript** - 编程语言
+- **API** - 通用术语
+- **PR** - Pull Request 缩写
+- **CI/CD** - 持续集成/部署
+- **IDE** - 集成开发环境
+- **VSCode/Cursor** - 编辑器名
+
+---
+
+## 翻译风格指南
+
+### 1. 技术文档风格
+- 使用正式、专业的语言
+- 避免口语化表达
+- 保持句子简洁
+
+### 2. 代码相关内容
+```markdown
+# 正确
+使用 `npm install` 安装依赖
+
+# 错误
+使用 `npm 安装` 来安装依赖
+```
+
+### 3. 命令和路径
+```markdown
+# 正确
+运行 `npx aiox-core init` 初始化项目
+
+# 错误
+运行 `npx aiox-core 初始化` 初始化项目
+```
+
+### 4. 变量和参数
+```markdown
+# 正确
+设置 `AIOX_DEBUG=true` 启用调试模式
+
+# 错误
+设置 `AIOX_调试=真` 启用调试模式
+```
+
+---
+
+## 更新历史
+
+| 日期 | 版本 | 变更 |
+|------|------|------|
+| 2026-02-22 | v1.0 | 初始版本 |
+
+---
+
+*Synkra AIOX 术语表 v1.0*

package/docs/zh/GUIDING-PRINCIPLES.md

@@ -0,0 +1,97 @@
+<!-- 翻译：zh-CN 原文：/docs/GUIDING-PRINCIPLES.md 最后同步：2026-02-22 -->
+
+# AIOX 方法指导原则
+
+> 🌐 [EN](../GUIDING-PRINCIPLES.md) | [PT](../pt/GUIDING-PRINCIPLES.md) | [ES](../es/GUIDING-PRINCIPLES.md) | **ZH**
+
+---
+
+AIOX 方法是一个用于 AI 辅助软件开发的自然语言框架。这些原则确保贡献保持该方法的有效性。
+
+## 核心原则
+
+### 1. 开发代理必须精简
+
+- **最小化开发代理依赖**：在 IDE 中工作的开发代理必须有最小的上下文开销
+- **为代码节省上下文**：每一行都很重要 - 开发代理应专注于编码，而不是文档
+- **Web 代理可以更大**：在 Web UI 中使用的规划代理（PRD 编写者、架构师）可以有更复杂的任务和依赖
+- **小文件，按需加载**：多个小的专注文件比包含许多分支的大文件更好
+
+### 2. 自然语言优先
+
+- **一切都是 markdown**：代理、任务、模板 - 全部用简单英文编写
+- **核心中没有代码**：框架本身不包含任何编程代码，只有自然语言指令
+- **自包含的模板**：模板定义为 YAML 文件，具有结构化章节，包括元数据、工作流程配置和详细的内容生成说明
+
+### 3. 代理和任务设计
+
+- **代理定义角色**：每个代理是具有特定专业知识的人物角色（例如前端开发人员、API 开发人员）
+- **任务是程序**：代理遵循的逐步说明来完成工作
+- **模板是输出**：具有嵌入式内容生成说明的结构化文档
+- **依赖很重要**：明确仅声明所需的内容
+
+## 实践指南
+
+### 何时添加到核心
+
+- 仅通用软件开发需求
+- 不会膨胀开发代理上下文
+- 遵循现有代理/任务/模板模式
+
+### 何时创建 Squads
+
+- 超越软件开发的特定领域需求
+- 非技术领域（商业、健康、教育、创意）
+- 专门的技术领域（游戏、基础设施、移动）
+- 大量文档或知识库
+- 任何会膨胀核心代理的东西
+
+查看 [Squads 概述](./guides/squads-overview.md) 了解详细示例和想法。
+
+### 代理设计规则
+
+1. **Web/规划代理**：可以有更丰富的上下文、多个任务、广泛的模板
+2. **开发代理**：最少的依赖，专注于代码生成，精简任务集
+3. **所有代理**：清晰的人物角色、具体的专业知识、定义明确的能力
+
+### 任务编写规则
+
+1. 编写清晰的逐步程序
+2. 使用 markdown 格式提高可读性
+3. 保持开发代理任务专注且简洁
+4. 规划任务可以更详细
+5. **优先选择多个小任务而不是一个大的分支任务**
+   - 不是一个包含许多条件路径的任务
+   - 创建多个专注的任务代理可以选择
+   - 这保持上下文开销最小
+6. **重用常见任务** - 不要创建新的文档创建任务
+   - 使用现有的 `create-doc` 任务
+   - 传递具有结构化章节的适当 YAML 模板
+   - 这保持一致性并减少重复
+
+### 模板规则
+
+模板遵循 [AIOX 文档模板](../common/utils/aiox-doc-template.md) 规范，使用 YAML 格式：
+
+1. **结构**：模板在 YAML 中定义，具有清晰的元数据、工作流程配置和章节层次结构
+2. **关注点分离**：LLM 的说明在 `instruction` 字段中，与内容分离
+3. **可重用性**：模板是代理不可知的，可以跨不同代理使用
+4. **关键组件**：
+   - 元数据的 `template` 块（id、name、version、output settings）
+   - 交互模式配置的 `workflow` 块
+   - 定义文档结构的 `sections` 数组及其嵌套子章节
+   - 每个章节都有 `id`、`title` 和 `instruction` 字段
+5. **高级功能**：
+   - 使用 `{{variable_name}}` 语法进行变量替换
+   - 使用 `condition` 字段的条件章节
+   - 使用 `repeatable: true` 的可重复章节
+   - 使用 `owner` 和 `editors` 字段的代理权限
+   - 示例数组用于指导（永远不包含在输出中）
+6. **清晰的输出**：YAML 结构确保所有处理逻辑与生成的内容分离
+
+## 记住
+
+- 力量在于自然语言编排，而不是代码
+- 开发代理编码，规划代理规划
+- 保持开发代理精简以获得最大编码效率
+- 启动 squads 处理专门领域