sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/architecture/utility-integration-guide.md

@@ -1,358 +0,0 @@
-<!-- 翻译: ZH-CN | 原文: /docs/en/architecture/utility-integration-guide.md | 同步: 2026-02-22 -->
-
-# 工具集成指南
-
-> 🌐 [EN](../../architecture/utility-integration-guide.md) | [PT](../../pt/architecture/utility-integration-guide.md) | **ZH** | [ES](../../es/architecture/utility-integration-guide.md)
-
----
-
-**版本:** 1.0.0
-**创建于:** 2025-10-29
-**作者:** Sarah (@po)、Winston (@architect)
-**目的:** 为在 SINAPSE 框架中集成工具脚本定义模式
-
----
-
-## 什么是工具集成?
-
-**定义:** 工具集成是使孤立工具脚本**可发现、文档化和可用**的过程，位于 SINAPSE 框架内。
-
-工具被认为**完全集成**当:
-1. ✅ **已注册** 在 core-config.yaml 中
-2. ✅ **被引用** 至少由一个代理或任务
-3. ✅ **已文档化** 包含目的和用法
-4. ✅ **已测试** 以确保正确加载
-5. ✅ **可发现** 通过框架机制
-
----
-
-## 集成模式
-
-### 模式 1: 代理辅助工具
-
-**何时使用:** 工具提供代理直接使用的辅助函数
-
-**集成步骤:**
-1. 将工具添加到目标代理的 `dependencies.utils` 数组
-2. 在代理文件中记录工具的目的
-3. 在 core-config.yaml 中注册 (如果还未注册)
-4. 测试代理是否成功加载工具
-
-**示例: util-batch-creator**
-
-```yaml
-# .sinapse-ai/agents/dev.yaml
-id: dev
-name: 开发代理
-dependencies:
-  utils:
-    - batch-creator  # 创建相关任务的批次
-    - code-quality-improver
-```
-
-**修改的文件:**
-- `.sinapse-ai/agents/{agent}.yaml` (添加到 dependencies.utils)
-- `.sinapse-ai/core-config.yaml` (如必要则注册)
-- `.sinapse-ai/utils/README.md` (记录工具)
-
----
-
-### 模式 2: 任务执行工具
-
-**何时使用:** 工具由任务在执行期间调用
-
-**集成步骤:**
-1. 识别或创建使用工具的任务
-2. 在任务的 `execution.utils` 部分添加工具引用
-3. 记录任务如何使用工具
-4. 在 core-config.yaml 中注册 (如必要)
-5. 使用工具测试任务执行
-
-**示例: util-commit-message-generator**
-
-```yaml
-# .sinapse-ai/tasks/generate-commit-message.md
-id: generate-commit-message
-name: 生成提交信息
-execution:
-  utils:
-    - commit-message-generator  # 该任务的主工具
-  steps:
-    - 分析暂存的更改
-    - 使用工具生成语义提交信息
-    - 向用户呈现信息以批准
-```
-
-**修改的文件:**
-- `.sinapse-ai/tasks/{task}.md` (添加 execution.utils)
-- `.sinapse-ai/agents/{agent}.yaml` (添加任务到 executes 列表)
-- `.sinapse-ai/core-config.yaml` (如必要则注册)
-- `.sinapse-ai/utils/README.md` (记录工具)
-
----
-
-### 模式 3: 框架基础设施工具
-
-**何时使用:** 工具由框架本身使用，而不是由代理/任务直接使用
-
-**集成步骤:**
-1. 在 core-config.yaml 的适当类别中注册
-2. 在 utils/README.md 中记录为 "框架工具"
-3. 添加到框架文档
-4. 测试工具在框架上下文中加载
-
-**示例: util-elicitation-engine**
-
-```yaml
-# .sinapse-ai/core-config.yaml
-utils:
-  framework:
-    - elicitation-engine  # 用于代理创建工作流
-    - sinapse-validator
-```
-
-**修改的文件:**
-- `.sinapse-ai/core-config.yaml` (在框架中注册)
-- `.sinapse-ai/utils/README.md` (记录为框架工具)
-- 框架文档 (如适用)
-
----
-
-### 模式 4: 文档/分析工具
-
-**何时使用:** 工具执行分析或文档生成
-
-**集成步骤:**
-1. 添加到相关代理的工具 (通常是 architect、qa 或文档代理)
-2. 创建或更新使用工具的任务
-3. 记录分析/输出格式
-4. 在 core-config.yaml 中注册
-
-**示例: util-documentation-synchronizer**
-
-```yaml
-# .sinapse-ai/agents/architect.yaml
-dependencies:
-  utils:
-    - documentation-synchronizer  # 保持文档与代码同步
-    - dependency-analyzer
-```
-
-**修改的文件:**
-- `.sinapse-ai/agents/{agent}.yaml`
-- `.sinapse-ai/tasks/{task}.md` (如创建任务)
-- `.sinapse-ai/core-config.yaml`
-- `.sinapse-ai/utils/README.md`
-
----
-
-## 集成工作流
-
-### 标准流程 (适用于所有模式):
-
-```
-1. 分析
-   ├─ 检查工具代码以理解目的
-   ├─ 识别工具类别 (辅助、执行器、分析器等)
-   └─ 确定适当的集成模式
-
-2. 映射
-   ├─ 识别应使用工具的目标代理
-   ├─ 识别或创建调用工具的任务
-   └─ 记录映射决策
-
-3. 集成
-   ├─ 将工具引用添加到代理/任务文件
-   ├─ 在 core-config.yaml 中注册 (如必要)
-   └─ 在 utils/README.md 中记录
-
-4. 测试
-   ├─ 加载工具以验证无错误
-   ├─ 加载代理以验证依赖解析
-   ├─ 如适用则测试任务执行
-   └─ 运行间隙检测以验证正确性
-
-5. 文档
-   ├─ 在 README 中添加工具描述
-   ├─ 记录用法模式
-   ├─ 注解使用它的代理/任务
-   └─ 更新架构图
-```
-
----
-
-## 工具分类
-
-工具应进行分类以便于集成:
-
-### 类别 1: 代码质量
-**目的:** 分析、改进、验证代码
-**模式:** 代理辅助工具 (代理 dev、qa)
-**示例:** sinapse-validator、code-quality-improver、coverage-analyzer
-
-### 类别 2: Git/工作流
-**目的:** Git 操作、工作流自动化
-**模式:** 任务执行 (代理 dev、github-devops)
-**示例:** commit-message-generator、branch-manager、conflict-resolver
-
-### 类别 3: 组件管理
-**目的:** 生成、管理、搜索组件
-**模式:** 代理辅助工具 + 任务执行
-**示例:** component-generator、component-search、deprecation-manager
-
-### 类别 4: 文档
-**目的:** 生成、同步、分析文档
-**模式:** 文档工具 (代理 architect、docs)
-**示例:** documentation-synchronizer、dependency-impact-analyzer
-
-### 类别 5: 批处理/辅助
-**目的:** 批量操作、框架辅助
-**模式:** 变化 (代理辅助工具或框架)
-**示例:** batch-creator、clickup-helpers、elicitation-engine
-
----
-
-## 测试要求
-
-### 对于每个集成的工具:
-
-**1. 加载测试**
-```javascript
-// 验证工具加载无错误
-const utility = require('.sinapse-ai/utils/{utility-name}');
-// 不应抛出错误
-```
-
-**2. 引用验证**
-```bash
-# 验证代理/任务引用有效
-node outputs/architecture-map/schemas/validate-tool-references.js
-```
-
-**3. 间隙检测**
-```bash
-# 验证间隙已解决
-node outputs/architecture-map/schemas/detect-gaps.js
-# 应显示 0 个工具间隙
-```
-
-**4. 集成测试** (如适用)
-```javascript
-// 验证代理加载工具依赖
-const agent = loadAgent('agent-name');
-// 应在解析的依赖中包含工具
-```
-
----
-
-## 文档要求
-
-### utils/README.md 中的模板条目:
-
-```markdown
-### util-{name}
-
-**目的:** 工具执行功能的简要描述
-
-**由以下使用:**
-- agent-{name} (用于 {目的})
-- task-{name} (在 {阶段} 期间)
-
-**集成模式:** {模式-名称}
-
-**位置:** `.sinapse-ai/utils/{name}.js`
-
-**使用示例:**
-\`\`\`javascript
-const util = require('./utils/{name}');
-// 代码示例
-\`\`\`
-```
-
----
-
-## core-config.yaml 中的注册
-
-### 将工具添加到适当的部分:
-
-```yaml
-utils:
-  # 代理辅助工具
-  helpers:
-    - batch-creator
-    - code-quality-improver
-
-  # 任务执行工具
-  executors:
-    - commit-message-generator
-    - component-generator
-
-  # 框架基础设施工具
-  framework:
-    - elicitation-engine
-    - sinapse-validator
-
-  # 分析/文档工具
-  analyzers:
-    - documentation-synchronizer
-    - dependency-analyzer
-```
-
----
-
-## 成功标准
-
-工具集成成功时:
-
-✅ **可发现:**
-- 在 core-config.yaml 中列出
-- 在 utils/README.md 中记录
-- 由代理/任务引用
-
-✅ **功能性:**
-- 加载无错误
-- 代理/任务可使用它
-- 测试通过
-
-✅ **已验证:**
-- 间隙检测显示 0 个间隙
-- 引用验证通过
-- 集成测试通过
-
-✅ **已文档化:**
-- 目的清晰表述
-- 提供使用示例
-- 已识别集成模式
-
----
-
-## 常见陷阱
-
-❌ **不要:** 添加工具到代理而不理解其目的
-✅ **要:** 首先检查代码，理解功能
-
-❌ **不要:** 如果现有任务可使用则创建新任务
-✅ **要:** 在适当时扩展现有任务
-
-❌ **不要:** 注册而不文档化
-✅ **要:** 始终添加 README 条目
-
-❌ **不要:** 跳过测试
-✅ **要:** 验证工具加载并解析
-
----
-
-## 快速参考
-
-| 模式 | 目标 | 修改的文件 | 测试 |
-|------|------|----------|------|
-| 代理辅助工具 | Agent YAML | agent.yaml、core-config、README | 加载代理 |
-| 任务执行 | Task MD + Agent | task.md、agent.yaml、core-config、README | 执行任务 |
-| 框架 | 框架 | core-config、README、文档 | 加载工具 |
-| 文档 | Architect/Docs | agent.yaml、core-config、README | 间隙检测 |
-
----
-
-**指南版本:** 1.0.0
-**最后更新:** 2025-10-29
-**维护者:** Winston (@architect)

package/docs/zh/code-of-conduct.md

@@ -1,113 +0,0 @@
-# 贡献者契约行为准则
-
-> 🇧🇷 [葡萄牙語版本](../CODE_OF_CONDUCT-PT.md)
-
-## 我们的承诺
-
-作为成员、贡献者和领导者，我们承诺使我们社区的参与是一个
-不受骚扰的体验，无论年龄、体型、可见或不可见的残疾、种族、
-性别特征、性别认同和表达、经验水平、教育、社会经济状况、
-国籍、个人外表、种族、种姓、肤色、宗教或性身份和性取向。
-
-我们承诺以有助于开放、热情、
-多样化、包容和健康社区的方式行动和互动。
-
-## 我们的标准
-
-有助于我们社区创建积极环境的行为示例包括：
-
-* 使用欢迎和包容的语言
-* 尊重不同的观点和经历
-* 优雅地接受建设性批评
-* 专注于对社区最有利的事情
-* 对其他社区成员表达同情
-
-不可接受的行为示例包括：
-
-* 使用性化的语言或意象，以及任何形式的性关注或性骚扰
-* 灵活的骂名、侮辱或贬损的评论，以及个人或政治攻击
-* 公开或私下骚扰
-* 未经明确许可发布他人的私人信息，如物理地址或电子邮件地址
-* 其他在专业环境中可以合理认为是不适当的行为
-
-## 执法职责
-
-社区领导者负责澄清和执行我们可接受行为的标准，并将
-采取适当和公平的纠正措施，以应对他们认为不适当、令人
-吓唬、令人反感或有害的任何行为。
-
-社区领导者有权利和责任删除、编辑或拒绝
-评论、提交、代码、wiki 编辑、问题和其他不符合本行为
-准则的贡献，并将在适当时交流审核决定的原因。
-
-## 范围
-
-本行为准则适用于所有社区空间内，也适用于
-当个人在公共空间中正式代表社区时。代表我们社区的
-示例包括使用官方电子邮件地址、通过官方社交媒体账户发布，
-或在在线或离线活动中充当任命的代表。
-
-## 执法
-
-可能向负责执法的社区领导者报告不当、骚扰或
-其他不可接受的行为实例，电子邮件地址为
-conduct@SinapseAI.com。所有投诉将被迅速和公平地审查和调查。
-
-所有社区领导者有义务尊重任何事件报告者的隐私和安全。
-
-## 执法指南
-
-社区领导者在确定任何违反本行为准则的行为的后果时
-将遵循这些社区影响指南：
-
-### 1. 纠正
-
-**社区影响**：使用不适当的语言或其他行为被认为
-是不专业的或在社区中不受欢迎的。
-
-**后果**：来自社区领导者的私人书面警告，
-澄清违规的性质并解释为什么该行为是不适当的。
-可能会要求提出公开道歉。
-
-### 2. 警告
-
-**社区影响**：通过单一事件或一系列行动的违规。
-
-**后果**：警告后果持续行为。在指定的时间段内，
-不与涉及的人进行互动，包括与执行行为准则的人的无意
-互动。这包括避免在社区空间以及社交媒体等外部渠道中的互动。
-违反这些条款可能导致临时或永久禁止。
-
-### 3. 临时禁止
-
-**社区影响**：严重违反社区标准，包括
-持续的不适当行为。
-
-**后果**：在指定的时间段内，禁止与社区进行任何形式的
-互动或公开交流。在此期间，不允许与涉及的人进行公开或
-私人互动，包括与执行行为准则的人的无意互动。
-违反这些条款可能导致永久禁止。
-
-### 4. 永久禁止
-
-**社区影响**：展示违反社区标准的行为模式，
-包括持续的不适当行为、骚扰个人或侵略或
-诋毁各类个人。
-
-**后果**：永久禁止在社区内进行任何形式的公开互动。
-
-## 归因
-
-本行为准则改编自 [贡献者契约][homepage]，
-版本 2.1，可在
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]
-
-社区影响指南受 [Mozilla 行为准则执法梯][Mozilla CoC]启发。
-
-有关本行为准则的常见问题的答案，请见
-[https://www.contributor-covenant.org/faq][FAQ]
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq

package/docs/zh/community/README-community-snippet-core.md

@@ -1,57 +0,0 @@
-# README 社区部分 - sinapse-ai
-
-> 🌐 [EN](../../en/community/README-community-snippet-core.md) | [PT](../../pt/community/README-community-snippet-core.md) | [ES](../../es/community/README-community-snippet-core.md) | **ZH**
-
-> **用途:** 将此代码段复制到 `SinapseAI/sinapse-ai` 仓库的 README.md 中。
-
----
-
-## 💬 社区与讨论
-
-此仓库托管了所有 SINAPSE 项目的**中央社区枢纽**。
-
-👉 **[加入讨论](https://github.com/SinapseAI/sinapse-ai/discussions)**
-
-### 讨论类别
-
-| 类别               | 目的                                         |
-| ---------------------- | -------------------------------------------------------------------- |
-| 📣 **公告**   | SINAPSE 团队的官方更新和新闻                             |
-| 💬 **常规**         | 关于 SINAPSE 的一般讨论                                           |
-| 💡 **创意**           | 提议新功能和改进                                    |
-| 🙏 **问答**             | 提问和获取帮助                                               |
-| 🙌 **展示和讲述**   | 分享用 SINAPSE 构建的项目                                      |
-| 🐛 **故障排除** | 获取问题和问题的帮助                                        |
-| 📦 **Squad**          | 关于 [SINAPSE Squads](https://github.com/SinapseAI/sinapse-squads) 的讨论 |
-| 🔧 **MCP 生态**   | 关于 [MCP 工具](https://github.com/SinapseAI/mcp-ecosystem) 的讨论 |
-
-### 快速链接
-
-| 操作               | 链接                                                                                                |
-| -------------------- | --------------------------------------------------------------------------------------------------- |
-| 🐛 报告错误      | [打开 Issue](https://github.com/SinapseAI/sinapse-ai/issues/new?template=bug_report.md)               |
-| 💡 请求功能 | [开始讨论](https://github.com/SinapseAI/sinapse-ai/discussions/new?category=ideas)            |
-| ❓ 提出问题    | [问答](https://github.com/SinapseAI/sinapse-ai/discussions/new?category=q-a)                           |
-| 📦 提议 Squad   | [sinapse-squads issues](https://github.com/SinapseAI/sinapse-squads/issues/new?template=squad-proposal.md) |
-| 🔧 MCP 问题      | [MCP 生态](https://github.com/SinapseAI/sinapse-ai/discussions/new?category=mcp-ecosystem)       |
-
-### 相关仓库
-
-| 仓库                                                 | 描述                      | 许可证        |
-| ---------------------------------------------------------- | -------------------------------- | -------------- |
-| [sinapse-ai](https://github.com/SinapseAI/sinapse-ai)         | 核心框架（你在这里）    | MIT            |
-| [sinapse-squads](https://github.com/SinapseAI/sinapse-squads)     | SINAPSE Squads (ETL, Creator, MMOS) | MIT            |
-| [mcp-ecosystem](https://github.com/SinapseAI/mcp-ecosystem) | Docker MCP 工具包和 IDE 配置 | Apache 2.0     |
-
-### 贡献
-
-欢迎贡献！查看我们的：
-
-- 📖 [贡献指南](../../CONTRIBUTING.md)
-- 📜 [行为准则](../../CODE_OF_CONDUCT.md)
-- 🏗️ [编码标准](../architecture/coding-standards.md)
-- 🏷️ [好的初始 Issue](https://github.com/SinapseAI/sinapse-ai/labels/good-first-issue)
-
----
-
-**标语:** _SINAPSE：用于全栈开发的 AI 编排系统_ 🚀

package/docs/zh/community/README-community-snippet-mcp.md

@@ -1,49 +0,0 @@
-# README 社区部分 - mcp-ecosystem
-
-> 🌐 [EN](../../en/community/README-community-snippet-mcp.md) | [PT](../../pt/community/README-community-snippet-mcp.md) | [ES](../../es/community/README-community-snippet-mcp.md) | **ZH**
-
-> **用途:** 将此代码段复制到 `SinapseAI/mcp-ecosystem` 仓库的 README.md 中。
-
----
-
-## 💬 社区与支持
-
-如需讨论、问题和社区互动，请访问我们的中央枢纽：
-
-👉 **[SINAPSE 社区讨论](https://github.com/SinapseAI/sinapse-ai/discussions)**
-
-| 需要                         | 前往位置                                                                                                    |
-| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| 🔧 **MCP 问题?**        | 使用 ["MCP 生态" 类别](https://github.com/SinapseAI/sinapse-ai/discussions/categories/mcp-ecosystem) |
-| 💡 **功能创意?**        | 在 ["创意" 中启动讨论](https://github.com/SinapseAI/sinapse-ai/discussions/categories/ideas)            |
-| 🐛 **发现错误?**          | [在此仓库中打开 issue](https://github.com/SinapseAI/mcp-ecosystem/issues/new/choose)            |
-| 🙏 **需要帮助?**            | 在 ["问答" 中提问](https://github.com/SinapseAI/sinapse-ai/discussions/categories/q-a)                               |
-| 🙌 **创建了什么酷的东西?** | 在 ["展示和讲述" 中分享](https://github.com/SinapseAI/sinapse-ai/discussions/categories/show-and-tell)         |
-
-### 此仓库中的内容
-
-| 组件                 | 描述                                                          |
-| ------------------------- | -------------------------------------------------------------------- |
-| 🐳 **Docker MCP 工具包** | 在 Docker 容器中运行的预配置 MCP 服务器              |
-| ⚙️ **MCP 预设**        | 为不同工作流策划的配置（开发、研究等）       |
-| 🖥️ **IDE 配置**        | VS Code、Cursor、Claude Code 的集成配置                 |
-| 🌐 **网关服务**    | 用于可靠 MCP 连接的 HTTP/SSE 网关                        |
-
-### 快速链接
-
-- [Docker MCP 工具包设置](../docker-mcp-setup.md)
-- [可用的预设](../../presets/)
-- [IDE 集成指南](../ide-integration.md)
-- [故障排除指南](../troubleshooting.md)
-
-### 提议新的 MCP 服务器
-
-有想要的新 MCP 服务器配置吗？
-
-1. 检查现有的 [MCP 提案](https://github.com/SinapseAI/mcp-ecosystem/labels/mcp-server)
-2. 使用 `mcp-server` 标签打开 issue
-3. 在 [MCP 生态类别](https://github.com/SinapseAI/sinapse-ai/discussions/categories/mcp-ecosystem) 中讨论
-
----
-
-**许可证:** Apache 2.0

package/docs/zh/community/README-community-snippet-squads.md

@@ -1,40 +0,0 @@
-# README 社区部分 - sinapse-squads
-
-> 🌐 [EN](../../en/community/README-community-snippet-squads.md) | [PT](../../pt/community/README-community-snippet-squads.md) | [ES](../../es/community/README-community-snippet-squads.md) | **ZH**
-
-> **用途:** 将此代码段复制到 `SinapseAI/sinapse-squads` 仓库的 README.md 中。
-
----
-
-## 💬 社区与支持
-
-如需讨论、问题和社区互动，请访问我们的中央枢纽：
-
-👉 **[SINAPSE 社区讨论](https://github.com/SinapseAI/sinapse-ai/discussions)**
-
-| 需要 | 前往位置 |
-|------|-------------|
-| 📦 **Squad 问题?** | 使用 ["Squad" 类别](https://github.com/SinapseAI/sinapse-ai/discussions/categories/squads) |
-| 💡 **功能创意?** | 在 ["创意" 中启动讨论](https://github.com/SinapseAI/sinapse-ai/discussions/categories/ideas) |
-| 🐛 **发现错误?** | [在此仓库中打开 issue](https://github.com/SinapseAI/sinapse-squads/issues/new/choose) |
-| 🙏 **需要帮助?** | 在 ["问答" 中提问](https://github.com/SinapseAI/sinapse-ai/discussions/categories/q-a) |
-| 🙌 **创建了什么酷的东西?** | 在 ["展示和讲述" 中分享](https://github.com/SinapseAI/sinapse-ai/discussions/categories/show-and-tell) |
-
-### 可用的 Squad
-
-| Squad | 描述 | 状态 |
-|-------|-------------|--------|
-| 🔄 **ETL Squad** | 数据收集、转换和管道自动化 | 活跃 |
-| ✍️ **Creator Squad** | 内容生成、博客文章、课程创建 | 活跃 |
-
-### 提议新的 Squad
-
-有新的 SINAPSE Squad 想法？我们很乐意听到！
-
-1. 检查现有的 [Squad 提案](https://github.com/SinapseAI/sinapse-squads/labels/new-squad)
-2. 打开 [Squad 提案 issue](https://github.com/SinapseAI/sinapse-squads/issues/new?template=squad-proposal.md)
-3. 在社区中讨论
-
----
-
-**标语:** *SINAPSE Squads：与你一起工作的 AI 代理团队* 🤖