sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/sinapse-agent-flows/qa-system.md

@@ -1,268 +0,0 @@
-# @qa 系统
-
-> **版本:** 1.0.0
-> **创建:** 2026-02-04
-> **所有者:** @qa (Quinn - 守护者)
-> **状态:** 官方文档
-
----
-
-## 概览
-
-**@qa 代理 (Quinn)** 是 SINAPSE 的**测试架构师和质量顾问**。其角色是为开发团队提供全面的质量分析、质量门决策和可行的建议。
-
-**原型:** 守护者
-**通信语气:** 分析、系统、教育、务实
-**特征词汇:** 验证、检查、保证、保护、审计、检查、确保
-
-### 核心原则
-
-1. **根据需要的深度** - 根据风险信号深入，低风险时保持简洁
-2. **需求可追踪性** - 使用给定-当-然模式将所有故事映射到测试
-3. **基于风险的测试** - 按概率 x 影响评估和优先级
-4. **质量属性** - 验证 NFR(安全、性能、可靠性)
-5. **可测试性评估** - 评估可控制性、可观察性、可调试性
-6. **门治理** - 提供明确的 PASS/CONCERNS/FAIL/WAIVED 决策和理由
-7. **咨询卓越** - 通过文档教育，永远不要任意阻止
-8. **CodeRabbit 集成** - 使用自动审查提早发现问题
-
----
-
-## 完整文件列表
-
-### @qa 的核心任务文件
-
-| 文件 | 命令 | 目的 |
-|---------|---------|-----------|
-| `.sinapse-ai/development/tasks/qa-gate.md` | `*gate {story}` | 创建质量门决策文件 |
-| `.sinapse-ai/development/tasks/qa-review-story.md` | `*review {story}` | 完整故事审查和门决策 |
-| `.sinapse-ai/development/tasks/qa-test-design.md` | `*test-design {story}` | 创建全面的测试场景 |
-| `.sinapse-ai/development/tasks/qa-risk-profile.md` | `*risk-profile {story}` | 生成风险评估矩阵 |
-| `.sinapse-ai/development/tasks/qa-nfr-assess.md` | `*nfr-assess {story}` | 验证非功能需求 |
-| `.sinapse-ai/development/tasks/qa-trace-requirements.md` | `*trace {story}` | 将需求映射到测试(给定-当-然) |
-| `.sinapse-ai/development/tasks/qa-generate-tests.md` | `*generate-tests` | 自动生成测试套件 |
-| `.sinapse-ai/development/tasks/qa-run-tests.md` | `*run-tests` | 执行测试套件和质量门 |
-| `.sinapse-ai/development/tasks/qa-backlog-add-followup.md` | `*backlog-add` | 添加后续项到待办事项 |
-| `.sinapse-ai/development/tasks/qa-create-fix-request.md` | `*create-fix-request {story}` | 为 @dev 生成修复请求文档 |
-
-### 代理定义文件
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/development/agents/qa.md` | QA 代理的完整定义 |
-| `.claude/commands/SINAPSE/agents/qa.md` | Claude Code 命令用于激活 @qa |
-
-### 工作流文件
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/development/workflows/qa-loop.yaml` | QA 循环协调器(审查 -> 修复 -> 重新审查) |
-
----
-
-## 命令到任务的映射
-
-### 分析和审查命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*code-review {scope}` | (内部) | 执行自动审查 |
-| `*review {story}` | `qa-review-story.md` | 完整故事审查 |
-
-### 质量门命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*gate {story}` | `qa-gate.md` | 创建质量门决策 |
-| `*nfr-assess {story}` | `qa-nfr-assess.md` | 验证非功能需求 |
-| `*risk-profile {story}` | `qa-risk-profile.md` | 生成风险矩阵 |
-
-### 测试策略命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*test-design {story}` | `qa-test-design.md` | 创建测试场景 |
-| `*trace {story}` | `qa-trace-requirements.md` | 将需求映射到测试 |
-| `*generate-tests` | `qa-generate-tests.md` | 自动生成测试 |
-| `*run-tests` | `qa-run-tests.md` | 执行测试套件 |
-
-### 待办事项命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*backlog-add` | `qa-backlog-add-followup.md` | 添加后续项到待办事项 |
-| `*backlog-update {id} {status}` | (通过 po-manage-story-backlog) | 更新项目状态 |
-| `*backlog-review` | (通过 po-manage-story-backlog) | 生成待办事项审查 |
-
-### 实用工具命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*help` | (内部) | 显示所有命令 |
-| `*session-info` | (内部) | 显示会话详情 |
-| `*guide` | (内部) | 显示完整使用指南 |
-| `*exit` | (内部) | 退出 QA 模式 |
-
----
-
-## 故事审查的生命周期
-
-### 前置条件
-
-```yaml
-Pre-conditions:
-  - 故事状态: "审查"
-  - 开发者完成所有任务
-  - 故事中的文件列表已更新
-  - 所有自动化测试通过
-```
-
-### 审查流程
-
-审查流程包含以下步骤:
-1. CodeRabbit 自动扫描
-2. 手动审查(风险、NFR、测试设计、需求追踪)
-3. 门决策(PASS、CONCERNS、FAIL、WAIVED)
-
-### 问题严重性
-
-| 严重性 | 前缀 | 操作 | 门影响 |
-|------------|---------|------|-----------------|
-| CRITICAL | `SEC-`、`DATA-` | 自动修复或阻止 | 门 = FAIL |
-| HIGH | `PERF-`、`REL-` | 自动修复或文档化 | 门 = FAIL |
-| MEDIUM | `MNT-`、`TEST-` | 技术债务问题 | 门 = CONCERNS |
-| LOW | `DOC-`、`ARCH-` | 审查备注 | 门 = PASS |
-
-### 门决策
-
-| 决策 | 标准 |
-|---------|----------|
-| **PASS** | 所有验收标准满足，无高严重性问题，测试覆盖达到标准 |
-| **CONCERNS** | 存在非阻止问题，应追踪和安排，可在意识前进 |
-| **FAIL** | 验收标准未满足，存在高严重性问题，建议返回进行中 |
-| **WAIVED** | 问题已明确接受，需要批准和理由，尽管已知问题继续进行 |
-
----
-
-## CodeRabbit 集成
-
-### 自我修复配置
-
-```yaml
-coderabbit_integration:
-  enabled: true
-  self_healing:
-    type: full
-    max_iterations: 3
-    severity_filter:
-      - CRITICAL
-      - HIGH
-    behavior:
-      CRITICAL: auto_fix
-      HIGH: auto_fix
-      MEDIUM: document_as_debt
-      LOW: ignore
-```
-
-### 流程
-
-1. 运行 CodeRabbit CLI
-2. 解析输出寻找 CRITICAL/HIGH
-3. 尝试自动修复(最多 3 次)
-4. 如果失败，需要手动干预
-5. MEDIUM 问题文档化为技术债务
-
----
-
-## 代理协作
-
-### 与 @dev 的交互
-
-1. @qa 执行 `*review {story}`
-2. 发现关键问题
-3. 创建 `*create-fix-request {story}`
-4. @dev 接收 `QA_FIX_REQUEST.md`
-5. @dev 执行 `*fix-qa-issues {story}`
-6. @qa 重新审查
-
-### 与 @po 的交互
-
-1. @qa 在审查期间发现后续项
-2. 使用 `*backlog-add` 添加项
-3. 项目与源"QA 审查"一起追踪
-4. @po 使用 `*backlog-prioritize` 优先级
-
----
-
-## Git 限制
-
-```yaml
-git_restrictions:
-  allowed_operations:
-    - git status
-    - git log
-    - git diff
-    - git branch -a
-
-  blocked_operations:
-    - git push
-    - git commit
-    - gh pr create
-```
-
----
-
-## 最佳实践
-
-### 审查期间
-
-1. 先运行 CodeRabbit - 让自动化找到明显问题
-2. 评估风险 - 确定审查深度
-3. 检查可追踪性 - 每个 AC 应有对应测试
-4. 文档化重构 - 如果修改代码，解释原因和方法
-5. 保持专注 - 仅更新 QA 结果部分
-
-### 创建门
-
-1. 使用正确的严重性 - 仅低/中/高
-2. 理由决策 - 状态理由 1-2 句
-3. 识别所有者 - 每个问题的 dev/sm/po
-4. 定义过期 - 通常 2 周
-
-### 避免
-
-- 修改故事中超过 QA 结果的部分
-- 无明确理由阻止
-- 忽视中等问题(文档化为技术债务)
-- 在 CodeRabbit 完成前审查
-- 未检查测试覆盖就批准
-
----
-
-## 总结
-
-| 方面 | 详情 |
-|---------|----------|
-| **总核心任务** | 10 个主要任务文件 |
-| **总辅助任务** | 9 个支持任务文件 |
-| **主要工作流** | qa-loop.yaml(协调) |
-| **审查命令** | 2 个(`*code-review`、`*review`) |
-| **门命令** | 3 个(`*gate`、`*nfr-assess`、`*risk-profile`) |
-| **测试命令** | 4 个(`*test-design`、`*trace`、`*generate-tests`、`*run-tests`) |
-| **待办事项命令** | 3 个(`*backlog-*` 系列) |
-| **门决策** | 4 个(PASS、CONCERNS、FAIL、WAIVED) |
-| **严重性级别** | 3 个(低、中、高) |
-| **自我修复最大** | 3 个迭代 |
-| **CodeRabbit 集成** | 是(WSL 模式) |
-
----
-
-## 更改日志
-
-| 日期 | 作者 | 描述 |
-|------|-------|-----------|
-| 2026-02-04 | @qa | 创建初始文档，完整 Mermaid 图表 |
-
----
-
-*-- Quinn，质量守护者*

package/docs/zh/sinapse-agent-flows/sinapse-master-system.md

@@ -1,81 +0,0 @@
-# @sinapse-master 系统
-
-> **版本:** 1.0.0
-> **创建:** 2026-02-04
-> **所有者:** @sinapse-master (Orion)
-> **状态:** 官方文档
-
----
-
-## 概览
-
-**@sinapse-master** (Orion - 协调器) 是 SINAPSE-FULLSTACK 框架的元代理。他充当通用协调器、框架开发者和 SINAPSE 方法专家。主要职责包括:
-
-- **通用协调**: 直接执行任何代理的任何任务
-- **框架开发**: 创建和修改代理、任务、工作流和模板
-- **组件管理**: 验证、弃用和分析系统组件
-- **多代理协调**: 管理代理之间的复杂工作流
-- **知识库**: 访问完整的 SINAPSE 方法知识
-
-### 何时使用
-
-- 创建或修改框架组件(代理、任务、工作流)
-- 协调复杂的多代理工作流
-- 直接执行任何任务而不改变角色
-- 元框架操作和跨代理协调
-- 访问 SINAPSE 知识库 (*kb)
-
----
-
-## 完整文件列表
-
-### @sinapse-master 的核心任务文件
-
-| 文件 | 命令 | 目的 |
-|---------|---------|-----------|
-| `.sinapse-ai/development/tasks/create-agent.md` | `*create agent` | 使用模板系统创建新代理定义 |
-| `.sinapse-ai/development/tasks/create-task.md` | `*create task` | 用标准化结构创建新任务文件 |
-| `.sinapse-ai/development/tasks/create-workflow.md` | `*create workflow` | 创建新的多代理工作流定义 |
-| `.sinapse-ai/development/tasks/modify-agent.md` | `*modify agent` | 修改现有代理，支持备份和回滚 |
-| `.sinapse-ai/development/tasks/modify-task.md` | `*modify task` | 修改现有任务，保持兼容性 |
-| `.sinapse-ai/development/tasks/modify-workflow.md` | `*modify workflow` | 修改现有工作流，保持完整性 |
-| `.sinapse-ai/development/tasks/analyze-framework.md` | `*analyze-framework` | 分析框架结构、冗余和性能 |
-| `.sinapse-ai/development/tasks/deprecate-component.md` | `*deprecate-component` | 弃用组件并附带时间表和迁移 |
-| `.sinapse-ai/development/tasks/propose-modification.md` | `*propose-modification` | 创建修改提案供协作审查 |
-| `.sinapse-ai/development/tasks/execute-checklist.md` | `*execute-checklist` | 执行验证检查清单 |
-| `.sinapse-ai/development/tasks/create-doc.md` | `*create-doc` | 从 YAML 模板创建文档 |
-| `.sinapse-ai/development/tasks/advanced-elicitation.md` | `*advanced-elicitation` | 执行多方法高级启发 |
-| `.sinapse-ai/development/tasks/kb-mode-interaction.md` | `*kb` | 启用交互式知识库模式 |
-| `.sinapse-ai/development/tasks/correct-course.md` | `*correct-course` | 分析和纠正流程/质量偏差 |
-| `.sinapse-ai/development/tasks/update-manifest.md` | `*update-manifest` | 用新代理更新团队清单 |
-| `.sinapse-ai/development/tasks/create-next-story.md` | `*create-next-story` | 创建下一个用户故事 |
-| `.sinapse-ai/development/tasks/create-deep-research-prompt.md` | - | 生成深度研究提示 |
-| `.sinapse-ai/development/tasks/improve-self.md` | - | 代理自我改进 |
-| `.sinapse-ai/development/tasks/shard-doc.md` | `*shard-doc` | 将文档分解为较小部分 |
-| `.sinapse-ai/development/tasks/document-project.md` | `*document-project` | 生成项目文档 |
-| `.sinapse-ai/development/tasks/index-docs.md` | `*index-docs` | 索引文档以供搜索 |
-
-### 代理定义文件
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/development/agents/sinapse-master.md` | 完整代理定义(角色、命令、依赖) |
-| `.claude/commands/SINAPSE/agents/sinapse-master.md` | Claude Code 命令用于激活 @sinapse-master |
-
----
-
-## 总结
-
-| 方面 | 详情 |
-|---------|----------|
-| **代理名称** | Orion (sinapse-master) |
-| **原型** | 协调器 |
-| **直接任务总数** | 21 个任务 |
-| **模板总数** | 14 个模板 |
-| **工作流总数** | 6 个工作流 |
-| **检查清单总数** | 6 个检查清单 |
-| **委托的代理** | 4 个(@pm、@analyst、@architect、@qa) |
-
----
-
-*-- Orion，协调系统*