编码
使用此技能作为软件工作的入口点。请将本文件保留在上下文中,然后为当前任务加载最小的相关参考集。
路由
- 如需编写新代码或扩展行为,请阅读
./references/implementation.md。 - 如需重构、清理、简化、提取、重组或重写工作,请阅读
./references/refactoring.md。 - 如需代码审查、PR审查、差异分析或风险评估,请阅读
./references/review.md。 - 如需调试、失败的测试、回归问题、运行时错误、CI失败或错误修复,请阅读
./references/debugging.md。 - 如需架构、API设计、模块边界、依赖方向或仅设计讨论,请阅读
./references/design.md。 - 如需共享代码质量规则,每当编写或更改代码时,以及在审查/设计过程中根据需要,阅读
./references/standards.md。 - 如需断言策略(不变检查、调试与生产环境的断言决策、快速失败契约),在编写或审查验证内部假设的代码时,阅读
./references/assertions.md。
仅加载用户当前请求所需的参考材料。如果任务有多个阶段,则在该阶段开始时加载下一个参考文件。
基线规则
- 正确性、安全性和用户意图优先于样式偏好。
- 项目的格式化工具、链接器、测试、构建系统、框架约定和系统级局部模式优先于此技能的默认标准。
- 当一种局部模式跨越多个相邻文件出现、由工具强制实施、或者是明确框架/应用程序约定的一部分时,即为系统级模式。不要仅仅因为相邻就复制一次性的差劲代码。
- 如果没有系统级项目模式,请使用
./references/standards.md。 - 保留公共行为、API、数据契约、迁移和操作语义,除非用户明确要求更改它们。
- 保持编辑范围限于当前任务。对接触到的代码进行足够改进以实现连贯的结果,但不要规范化无关的遗留代码。
示例查找
仅在规则决定不清晰时使用示例。
./examples/README.md索引了重点示例。- 一次打开一个匹配的示例文件。