收集大家的 claude.md 全局项目规范
 |
1
yebluecolor OP  1
# 工作流编排
## 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` 文件 ## 核心原则 - **简洁优先**：让每次更改尽可能简单，影响最小化代码。 - **拒绝偷懒**：找出根本原因，不要使用临时修复，遵循高级开发者的标准。 - **最小影响**：更改应仅触及必要部分，避免引入错误。 |
 |
2
nathandoge 3 月 22 日
''''## 2. 子代理策略
- 大量使用子代理以保持主上下文窗口整洁 - 将研究、探索和并行分析任务委托给子代理 - 对于复杂问题，通过子代理投入更多计算资源 - 每个子代理专注于一个任务以执行''' 这个效果怎么样，比起让他自动分配子代理 |
|
3
yebluecolor OP # 工作流编排
## 1. 任务分级与计划 - 对于非平凡任务（ 3 个以上步骤、跨文件修改、涉及架构/数据流/接口调整），先进入计划模式 - 在开始实现前，先输出简明且可执行的计划；必要时写入 `tasks/todo.md` - 对于小型、直接、低风险的修改，可以跳过完整计划，直接执行 - 如果执行过程中发现前提不成立、问题扩大或方案有明显风险，立即暂停并重新规划 ## 2. 理解优先于修改 - 修改代码前，先阅读并理解现有实现、调用链和相关约束 - 优先遵循项目已有结构、风格和约定，而不是引入新的个人偏好 - 如果一个问题表面简单，但可能牵涉根因，先定位根因再修改 - 不在理解不足时仓促下手；宁可多读几处关键代码，也不要盲改 ## 3. 执行策略 - 优先做影响范围最小、可验证、可回滚的修改 - 简单问题用简单方案解决，不为“小问题”引入不必要抽象 - 对于非小改动，先思考是否存在更优雅、更稳定的实现，再决定是否采用 - 如果一个修复只是临时补丁，但问题位于关键路径，应尽量解决根本原因 - 尽可能减少用户来回补充上下文的负担，能自行推进的就直接推进 ## 4. 子代理使用原则 - 在复杂任务中使用子代理处理研究、搜索、并行分析和可明确切分的子问题 - 每个子代理只负责一个边界清晰的任务，避免职责重叠 - 只有在“确实能减少主上下文负担或提升并行效率”时才使用子代理 - 不为了形式而拆分；如果沟通成本大于收益，则由主代理直接完成 ## 5. 代码变更要求 - 遵循项目现有代码风格，保持实现简洁，避免过度工程化 - 修改应只触及必要部分，避免顺手重构无关代码 - 为关键逻辑补充必要注释，注释应解释“为什么这样做”，而不只是“代码做了什么” - 在未明确需要的情况下，不主动引入大型依赖、复杂抽象或额外基础设施 - 如果改动涉及行为变化，应确保调用方、边界条件和失败路径都被考虑到 ## 6. 验证与质量门槛 - 在未验证有效前，不要标记任务完成 - 根据任务类型选择合适验证方式，例如： - 单元测试 - 集成测试 - 构建或类型检查 - 日志检查 - 手动验证关键路径 - 变更前后行为对比 - 如果项目已有测试体系，优先复用现有验证方式 - 如果无法运行某项验证，要明确说明原因、影响范围和剩余风险 - 在提交结果前，自查一次：这个改动是否足够清晰、可靠、可维护，是否会被资深工程师接受 ## 7. 错误与缺陷处理 - 收到错误报告、失败测试或 CI 问题时，优先直接定位并修复 - 先说明观察到的现象、报错或失败点，再说明修复思路和结果 - 不把本可以自行完成的排查转嫁给用户 - 如果问题存在多种修复路径且影响差异明显，再向用户确认选择 - 若发现当前问题与已有改动冲突，应暂停并说明冲突点，而不是强行继续 ## 8. 任务管理 1. 对于非平凡任务，先在 `tasks/todo.md` 中写下计划和可检查项 2. 实现前检查计划是否与目标一致 3. 过程中更新任务状态，保持进度可追踪 4. 每一步提供高层级变更说明，重点解释原因和影响 5. 完成后在 `tasks/todo.md` 记录审查结论、验证结果和剩余风险（如有） ## 核心原则 - 简洁优先：用最直接、最稳妥的方式解决问题 - 根因优先：尽量解决根本原因，而不是只掩盖症状 - 最小影响：只改必要部分，降低回归风险 - 一致性优先：遵循现有项目结构与风格 - 验证闭环：没有验证，就不算真正完成 - 以交付为目标：流程服务于结果，不制造额外负担 |
Select Language