sinapse-ai 5.0.8 → 6.0.1

package/docs/zh/CHANGELOG.md

@@ -1,191 +0,0 @@
-<!--
-  翻译：zh-CN（简体中文）
-  原文：/docs/CHANGELOG.md
-  最后同步：2026-02-22
-  说明：仅翻译标题和描述，保留技术内容
--->
-
-# 变更日志
-
-> 🌐 [EN](../CHANGELOG.md) | [PT](../pt/CHANGELOG.md) | [ES](../es/CHANGELOG.md) | **ZH**
-
----
-
-SINAPSE 的所有重要变更都将记录在此文件中。
-
-本格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)，
-本项目遵循 [语义化版本](https://semver.org/spec/v2.0.0.html)。
-
----
-
-## [2.2.0] - 2026-01-29
-
-### 新增
-
-- **SINAPSE 自主开发引擎 (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 格式及能力标志
-- **代理同步**：所有代理现在在 `.sinapse-ai/development/agents/` 和 `.claude/commands/SINAPSE/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/` 重命名为 `.sinapse-ai/`
-- **配置格式**：增强 `core-config.yaml`，新增 git、projectStatus 和 sharding 选项部分
-- **代理格式**：更新代理 YAML schema，含 persona_profile、commands visibility 和 whenToUse 字段
-- **IDE 配置**：Claude Code 代理移至 `.claude/commands/SINAPSE/agents/`
-- **文件位置**：
-  - `docs/architecture/coding-standards.md` → `docs/framework/coding-standards.md`
-  - `docs/architecture/tech-stack.md` → `docs/framework/tech-stack.md`
-  - `.sinapse-ai/utils/` → `.sinapse-ai/scripts/`
-
-### 修复
-
-- Windows 长路径安装失败
-- PowerShell 执行策略阻止脚本
-- Linux/macOS 上的 npm 权限问题
-- 安装后 IDE 配置未应用
-
-### 废弃
-
-- 手动安装流程（改用 `npx @sinapse/sinapse-ai install`）
-- `.legacy-core/` 目录名称（自动迁移）
-
-### 安全
-
-- 增加安装目录验证以防止系统目录修改
-- 改进环境变量和 API 密钥的处理
-
----
-
-## [2.0.0] - 2024-12-01
-
-### 新增
-
-- SINAPSE 首次公开发布
-- 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 @sinapse/sinapse-ai install --force-upgrade
-```
-
-**主要变更：**
-
-1. 目录重命名：`.legacy-core/` → `.sinapse-ai/`
-2. 使用新字段更新 `core-config.yaml`
-3. 重新运行 IDE 配置
-
----
-
-## 链接
-
-- [故障排除](./installation/troubleshooting.md)
-- [FAQ](./installation/faq.md)
-- [GitHub 仓库](https://github.com/SinapseAI/sinapse-ai)
-- [Issue 追踪器](https://github.com/SinapseAI/sinapse-ai/issues)

package/docs/zh/ENVIRONMENT.md

@@ -1,136 +0,0 @@
-<!-- 翻译：zh-CN 原文：/docs/ENVIRONMENT.md 最后同步：2026-02-22 -->
-
-# 环境变量
-
-> 🌐 [EN](../ENVIRONMENT.md) | [PT](../pt/ENVIRONMENT.md) | [ES](../es/ENVIRONMENT.md) | **ZH**
-
----
-
-本文档列出了 SINAPSE 及其组件使用的所有环境变量。
-
-## 概述
-
-SINAPSE 使用环境变量进行配置、API 密钥和敏感信息。**切勿在存储库中提交环境变量。**
-
-## 必需的环境变量
-
-### 框架核心
-
-当前，SINAPSE 不需要任何必需的环境变量来进行基本操作。所有配置都通过 `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（在 `sinapse-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
-   ```
-
-### 加载环境变量
-
-SINAPSE 使用 `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

@@ -1,92 +0,0 @@
-# 功能请求流程
-
-> 🌐 [EN](../FEATURE_PROCESS.md) | [PT](../pt/FEATURE_PROCESS.md) | [ES](../es/FEATURE_PROCESS.md) | **ZH**
-
----
-
-本文档说明了如何为 SINAPSE 提出新功能。
-
-## 快速想法
-
-对于快速想法或小的改进：
-
-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

@@ -1,179 +0,0 @@
-# SINAPSE 术语表
-
-> 本术语表定义了 SINAPSE 文档中使用的核心术语的标准中文翻译。
-
----
-
-## 核心概念
-
-| 英文 | 简体中文 | 繁体中文 | 定义 |
-|------|----------|----------|------|
-| **Agent** | 代理 | 代理 | AI 驱动的专业角色，负责特定领域任务 |
-| **Meta-Agent** | 元代理 | 元代理 | 协调其他代理的主控制代理 |
-| **SINAPSE Master** | SINAPSE 主控 | SINAPSE 主控 | 系统的顶级协调代理 |
-| **Squad** | 小队 | 小隊 | 一组协作代理的集合 |
-| **Persona** | 角色 / 人格 | 角色 / 人格 | 代理的性格和专业特征定义 |
-
----
-
-## 开发概念
-
-| 英文 | 简体中文 | 繁体中文 | 定义 |
-|------|----------|----------|------|
-| **Story** | 故事 | 故事 | 开发任务的基本单位（可保留英文） |
-| **Epic** | 史诗 / Epic | Epic | 大型功能的分组（通常保留英文） |
-| **Task** | 任务 | 任務 | 可执行的单一操作 |
-| **Workflow** | 工作流 | 工作流程 | 定义任务执行顺序的流程 |
-| **Pipeline** | 流水线 | 管線 | 自动化处理流程 |
-| **Gate** | 门控 | 門控 | 质量检查点 |
-
----
-
-## 项目类型
-
-| 英文 | 简体中文 | 繁体中文 | 定义 |
-|------|----------|----------|------|
-| **Greenfield** | 绿地项目 | 全新專案 | 从零开始的新项目 |
-| **Brownfield** | 棕地项目 | 既有專案 | 在现有代码基础上开发 |
-
----
-
-## 系统组件
-
-| 英文 | 简体中文 | 繁体中文 | 定义 |
-|------|----------|----------|------|
-| **Memory Layer** | 记忆层 | 記憶層 | 存储和检索上下文信息的系统 |
-| **Constitution** | 宪法 / 准则 | 憲法 / 準則 | SINAPSE 的核心规则和原则 |
-| **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` | 退出 | 退出当前代理模式 |
-
----
-
-## 不翻译的术语
-
-以下术语在中文文档中保持英文：
-
-- **SINAPSE** - 品牌名
-- **SINAPSE** - 系统名称
-- **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 sinapse-ai init` 初始化项目
-
-# 错误
-运行 `npx sinapse-ai 初始化` 初始化项目
-```
-
-### 4. 变量和参数
-```markdown
-# 正确
-设置 `SINAPSE_DEBUG=true` 启用调试模式
-
-# 错误
-设置 `SINAPSE_调试=真` 启用调试模式
-```
-
----
-
-## 更新历史
-
-| 日期 | 版本 | 变更 |
-|------|------|------|
-| 2026-02-22 | v1.0 | 初始版本 |
-
----
-
-*SINAPSE 术语表 v1.0*

package/docs/zh/GUIDING-PRINCIPLES.md

@@ -1,97 +0,0 @@
-<!-- 翻译：zh-CN 原文：/docs/GUIDING-PRINCIPLES.md 最后同步：2026-02-22 -->
-
-# SINAPSE 方法指导原则
-
-> 🌐 [EN](../GUIDING-PRINCIPLES.md) | [PT](../pt/GUIDING-PRINCIPLES.md) | [ES](../es/GUIDING-PRINCIPLES.md) | **ZH**
-
----
-
-SINAPSE 方法是一个用于 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 模板
-   - 这保持一致性并减少重复
-
-### 模板规则
-
-模板遵循 [SINAPSE 文档模板](../common/utils/sinapse-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 处理专门领域