# 工作流编排

## 1. 任务分级与计划

- 对于非平凡任务（ 3 个以上步骤、跨文件修改、涉及架构/数据流/接口调整），先进入计划模式
- 在开始实现前，先输出简明且可执行的计划；必要时写入 `tasks/todo.md`
- 对于小型、直接、低风险的修改，可以跳过完整计划，直接执行
- 如果执行过程中发现前提不成立、问题扩大或方案有明显风险，立即暂停并重新规划

## 2. 理解优先于修改

- 修改代码前，先阅读并理解现有实现、调用链和相关约束
- 优先遵循项目已有结构、风格和约定，而不是引入新的个人偏好
- 如果一个问题表面简单，但可能牵涉根因，先定位根因再修改
- 不在理解不足时仓促下手；宁可多读几处关键代码，也不要盲改

## 3. 执行策略

- 优先做影响范围最小、可验证、可回滚的修改
- 简单问题用简单方案解决，不为“小问题”引入不必要抽象
- 对于非小改动，先思考是否存在更优雅、更稳定的实现，再决定是否采用
- 如果一个修复只是临时补丁，但问题位于关键路径，应尽量解决根本原因
- 尽可能减少用户来回补充上下文的负担，能自行推进的就直接推进

## 4. 子代理使用原则

- 在复杂任务中使用子代理处理研究、搜索、并行分析和可明确切分的子问题
- 每个子代理只负责一个边界清晰的任务，避免职责重叠
- 只有在“确实能减少主上下文负担或提升并行效率”时才使用子代理
- 不为了形式而拆分；如果沟通成本大于收益，则由主代理直接完成

## 5. 代码变更要求

- 遵循项目现有代码风格，保持实现简洁，避免过度工程化
- 修改应只触及必要部分，避免顺手重构无关代码
- 为关键逻辑补充必要注释，注释应解释“为什么这样做”，而不只是“代码做了什么”
- 在未明确需要的情况下，不主动引入大型依赖、复杂抽象或额外基础设施
- 如果改动涉及行为变化，应确保调用方、边界条件和失败路径都被考虑到

## 6. 验证与质量门槛

- 在未验证有效前，不要标记任务完成
- 根据任务类型选择合适验证方式，例如：
- 单元测试
- 集成测试
- 构建或类型检查
- 日志检查
- 手动验证关键路径
- 变更前后行为对比
- 如果项目已有测试体系，优先复用现有验证方式
- 如果无法运行某项验证，要明确说明原因、影响范围和剩余风险
- 在提交结果前，自查一次：这个改动是否足够清晰、可靠、可维护，是否会被资深工程师接受

## 7. 错误与缺陷处理

- 收到错误报告、失败测试或 CI 问题时，优先直接定位并修复
- 先说明观察到的现象、报错或失败点，再说明修复思路和结果
- 不把本可以自行完成的排查转嫁给用户
- 如果问题存在多种修复路径且影响差异明显，再向用户确认选择
- 若发现当前问题与已有改动冲突，应暂停并说明冲突点，而不是强行继续

## 8. 任务管理

1. 对于非平凡任务，先在 `tasks/todo.md` 中写下计划和可检查项
2. 实现前检查计划是否与目标一致
3. 过程中更新任务状态，保持进度可追踪
4. 每一步提供高层级变更说明，重点解释原因和影响
5. 完成后在 `tasks/todo.md` 记录审查结论、验证结果和剩余风险（如有）

## 核心原则

- 简洁优先：用最直接、最稳妥的方式解决问题
- 根因优先：尽量解决根本原因，而不是只掩盖症状
- 最小影响：只改必要部分，降低回归风险
- 一致性优先：遵循现有项目结构与风格
- 验证闭环：没有验证，就不算真正完成
- 以交付为目标：流程服务于结果，不制造额外负担

# 工作流编排

## 1. 计划节点默认设置

- 对于任何非平凡任务（ 3 个以上步骤或架构决策），进入计划模式
- 如果出现问题，立即停止并重新规划——不要继续推进
- 在验证步骤中使用计划模式，而不仅仅是构建
- 提前编写详细规格说明以减少歧义

## 2. 子代理策略

- 大量使用子代理以保持主上下文窗口整洁
- 将研究、探索和并行分析任务委托给子代理
- 对于复杂问题，通过子代理投入更多计算资源
- 每个子代理专注于一个任务以执行

## 3. 自我提升循环

- 在用户进行任何修正后：使用该模式更新 `tasks/lessons.md` 文件
- 为自己制定规则，防止重复犯同样的错误
- 无情地迭代这些教训，直到错误率下降
- 在会话开始时回顾与项目相关的经验教训

## 4. 完成前验证

- 不要在未证明其有效之前就标记任务完成
- 在相关情况下，比较主分支与你所做的更改之间的行为差异
- 问问自己："资深工程师会批准这个吗？"
- 运行测试，检查日志，演示正确性

## 5. 需求优雅（平衡）

- 对于非小改动：暂停并问"有没有更优雅的方法？"
- 如果修复感觉很临时补丁："知道我现在所掌握的一切，就实现优雅的解决方案"
- 对于简单、显而易见的修复，跳过此步骤——不要过度工程化
- 在展示自己的作品前先对其提出质疑

## 6. 自主缺陷修复

- 当收到错误报告时：直接修复它。不要要求指导。
- 指出日志、错误和失败的测试——然后解决它们
- 用户无需进行任何上下文切换
- 在未被告知如何操作的情况下，自行修复失败的 CI 测试

## 任务管理

1. **先计划**：将计划写入 `tasks/todo.md`，并包含可检查项
2. **验证计划**：在开始实现前检查
3. **跟踪进度**：在进行中标记任务完成状态
4. **解释变更**：每一步提供高层级总结
5. **记录结果**：向 `tasks/todo.md` 添加审查部分
6. **记录经验教训**：修改后更新 `tasks/lessons.md` 文件

## 核心原则

- **简洁优先**：让每次更改尽可能简单，影响最小化代码。
- **拒绝偷懒**：找出根本原因，不要使用临时修复，遵循高级开发者的标准。
- **最小影响**：更改应仅触及必要部分，避免引入错误。

是美刀啊

来自站点：bestaigate.top ，我的 id 是:1722

来自站点：bestaigate.top ，我的 id 是:1722

厉害了

看了半天也没看到你托举了啥

可以用中转站吗

支持

他们太会炒作了

kiro Claude opus

怎么回事？ API Error: 400 Invalid API key format, expected 'sk-hongmacc-' prefix

HONGMACC-E77BA965

刚买了 4 代降噪版，太舒服了，后悔没有早点买

一人吃饱 全家不饿，还担心个锤子裁员啊

有代购的吗？

蹲一个，有没有有渠道的