Menu
以架构师视角分析并修复问题，强制 plan 模式，杜绝补丁式修复。涉及协议时严格按协议来，协议有问题则协议先行调整，代码再跟进。当遇到 Bug 反馈、错误日志或功能异常时使用。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
A2C-SMCP 体系新增功能的流程门控。强制协议先行——任何涉及协议的 Feature 必须先在协议仓库通过评审、合并、发布后，代码仓库才可跟进实现。当用户提出新功能需求或 Feature Request 时调用。
以架构师视角审查代码变更，关注模块边界、DRY 复用性、测试完整性、协议合规和长期可维护性。当需要审查 PR、工作区变更或提交代码时使用。
把一个较大的 A2C-SMCP Epic / Story / GitHub Issue（或 Jira / CNB Issue）科学拆成多个可独立交付的子任务，输出含依赖图与集成回归守护的拆分方案，并在对应平台用 sub-issue 能力下单。A2C 特有：涉及协议的拆分强制「协议先行」——协议子任务置于依赖图根，代码仓库子任务 blocked-by 它。当用户说「拆分这个任务」「把 Epic 拆成子任务」「分解 Story」「给个切刀方案」时触发。
指导第三方 MCP Server 开发者通过标准 MCP Resource 协议暴露 window://（桌面状态）与 skill://（能力包）资源，接入 A2C-SMCP Desktop / SKILL 通道。当为 MCP Server 增加 A2C-SMCP 集成、把服务实时状态暴露给 Desktop、或通过 MCP 分发 SKILL 时使用。
反馈 A2C-SMCP Marketplace Skill 的问题或改进建议。自动识别当前会话中使用的 Skill，提取优化点，收集版本信息，提交 GitHub Issue 到 a2c-smcp-skills 仓库。当使用某个 Skill 时发现步骤错误、分支遗漏、文档过时等问题时调用。
审查 enhance-skill 提交的 GitHub Issue，评估建议合理性，与用户商议后实施改进。用于 marketplace 维护者持续提升 Skill 质量。
| name | fix-issue |
| description | 以架构师视角分析并修复问题，强制 plan 模式，杜绝补丁式修复。涉及协议时严格按协议来，协议有问题则协议先行调整，代码再跟进。当遇到 Bug 反馈、错误日志或功能异常时使用。 |
| argument-hint | <问题描述、错误日志或 Issue 链接> [--review <block|all|discuss>] |
| model | opus |
以架构师视角系统性修复问题。核心原则：TDD 红绿灯 + 协议先行 + 杜绝补丁式修复。
使用 EnterPlanMode 进入计划模式。所有分析和方案设计必须在 Plan 模式内完成，审批后才可编码。
如果输入中包含可追踪系统的 Issue，立即推进状态至"开发中"：
| 平台 | 识别特征 | 推进动作 |
|---|---|---|
| Jira | PROJECT-N 或 Jira URL | 使用 mcp__atlassian__getTransitionsForJiraIssue 获取可用状态，然后 mcp__atlassian__transitionJiraIssue 推进至"开发中"或类似状态（如 In Progress / In Development） |
| GitHub | owner/repo#N 或 URL | 无内置状态机，跳过 |
目的：当前 Issue 若隶属于某个父 Issue（Epic / Tracking Issue / Parent），父 Issue 承载了整体设计意图、范围边界与验收标准。修复决策必须服从父 Issue 的北极星方向，避免局部修复偏离整体架构。
检测父 Issue（覆盖常见结构）：
| 平台 | 父子关系载体 | 检测方式 |
|---|---|---|
| GitHub | Sub-issues（原生）/ Parent: #N、Part of #N、Tracked by #N 等引用 / 同一 Milestone 下的 tracking issue / Task list checklist 反向引用 | gh issue view <N> --json body,milestone,parent,trackedInIssues,subIssuesSummary；再看正文中对父 Issue 的显式引用 |
| Jira | Epic Link / Parent Link / Sub-task 的 parent | mcp__atlassian__getJiraIssue 返回字段中的 parent / customfield_* Epic Link |
执行动作：
硬性规则：父 Issue 存在时，其已明确的设计决策优先级高于本 Issue 的局部修复直觉。如需偏离父 Issue 方向，必须显式与用户对齐。
根据当前项目类型追踪完整调用链。
按项目参见
{baseDir}/resources/<project>.md"调用链路追踪"章节。
明确问题出在哪一层：
| 层级 | 说明 |
|---|---|
| 协议层 | 事件定义、数据结构、序列化格式与协议规范不符 |
| 传输层 | Socket.IO 连接、重连、命名空间 |
| 业务层 | 各组件自身的逻辑错误 |
| 集成层 | 跨组件/跨项目的交互问题 |
当根因涉及协议时，此步骤为强制门控，不可跳过。
| 信号 | 判定 |
|---|---|
| 事件名/字段名/数据结构与协议规范不一致 | 涉及协议 |
| 错误码使用不符合协议定义 | 涉及协议 |
| 跨 SDK 行为不一致（Python vs Rust） | 可能涉及协议 |
| 纯业务逻辑 Bug | 不涉及协议 |
读取对应协议仓库的规范文档，与代码实现对比：
docs/specification/ 下相关文件docs/specification/ 下相关文件协议详情参见
skills/add-feature/resources/a2c.md和skills/add-feature/resources/oasp.md。
| 结论 | 后续动作 |
|---|---|
| 代码不符合协议 → 代码有 Bug | 继续 Step 4，按协议规范修复代码 |
| 协议本身有问题（设计缺陷/不完善） | 停止代码修复，引导用户走 /add-feature 流程先调整协议，协议发布后再回来修代码 |
| 协议模糊/未覆盖此场景 | 使用 AskUserQuestion 与用户确认：是按现有理解修复，还是先明确协议？ |
硬性规则：代码仅可实现协议已定义的行为。如果修复需要改变协议语义，必须协议先行。
当变更触及用户可感知的交互时，此步骤为强制门控。 触发信号：UI 状态、操作步骤、命令行为、可见能力（skill / tool）出现/消失时机、默认行为等；纯内核 / 协议内部、无用户可感差异的变更豁免（豁免须在计划中显式说明）。
未经用户对「体验 before/after」做出判断并接受，不得进入 Step 4（写测试）/ Step 5-6（动代码）。与协议门控、隔离审查门控同级。用 AskUserQuestion 把「舞台 / 现状走查 / 改后走查 / 跨场景权衡 / 决策取景框」交用户拍板。
触发 / 豁免细则与场景化产出模板见单一源：
{baseDir}/resources/ux-impact-gate.md。
在修改任何业务代码之前，必须先编写测试用例复现问题：
没有失败的测试，就不要开始修复。
测试命令按项目参见
{baseDir}/resources/<project>.md。
当根因在上游依赖时：不修改上游代码，输出 Bug Report；保留失败测试作为验收标准；仅在阻塞核心功能时添加临时适配（标注 // WORKAROUND: see #xxx）。
使用 ExitPlanMode 提交计划等待审批。未经用户确认不得开始编码。
项目特有的架构原则和验证命令参见
{baseDir}/resources/<project>.md。
验证命令按项目参见
{baseDir}/resources/<project>.md。
全量绿灯后，禁止自评通过直接收尾。用 Agent 工具拉起隔离上下文的 a2c-smcp-toolkit:code-reviewer 子代理客观复审，按 --review 等级走 /fix-review，🔴 未清零不算修复完成。子代理拉起时须传入「问题意图」（根因结论 / 验收标准 / 父 Issue 北极星），不传实现自评。
流水线、
--review分级、琐碎豁免（含--review none）见单一源：skills/code-review/resources/embedded-review-gate.md。
向用户汇报：根因、修复方式、变更文件、测试覆盖、架构影响。
如果输入中包含可追踪系统的 Issue，验证通过后同时完成回复和状态推进：
| 平台 | 回复工具 | 状态推进 |
|---|---|---|
| GitHub | gh issue comment | 如适用可 gh issue close |
| Jira | mcp__atlassian__addCommentToJiraIssue | mcp__atlassian__transitionJiraIssue 推进至"已完成"或类似状态（如 Done / Resolved） |
回复内容规范（≤300 字，面向外部用户，不暴露内部路径）：
## 修复说明
**根因**：[一句话描述问题的本质原因]
**修复内容**：
- [具体修改点 1]
- [具体修改点 2]
**验收方式**：
- [如何验证修复生效，如测试用例名、手动验证步骤]
- 新增测试 `[test_name]` 覆盖此场景，全量测试通过
**版本**：修复已合并至 `main`，将在 `vX.Y.Z` 中发布