Communitygithub.com

编码技能

此技能是软件工作的入口点,用于指导编码、重构、审查、调试及架构设计等任务。

编码技能 是什么?

该技能作为软件工程工作的统一入口点,通过参考文档路由,将用户请求引导至最具体的必备指南。它定义了一组基线规则,优先考虑正确性、安全性和用户意图,并强调尊重项目级工具(如格式化工具、链接器和测试)优于全局偏好。路由系统涵盖了实现新代码、重构、代码审查、调试、架构设计和代码质量标准的专门参考文件。该技能鼓励仅加载当前任务要求的最小集合,以避免不必要的上下文混乱。它还包括一个示例查找机制,用于演示边缘情况或当规则不明确时澄清歧义规则。该技能设计用于支持Claude Code和Cursor等AI代理平台。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add AnthonyPoschen/agent-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

编码

使用此技能作为软件工作的入口点。请将本文件保留在上下文中,然后为当前任务加载最小的相关参考集。

路由

  • 如需编写新代码或扩展行为,请阅读 ./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 索引了重点示例。
  • 一次打开一个匹配的示例文件。

相关技能