Communitygithub.com

Xerrion/agent-skills

在实施或审查代码、研究技术事实、编写文档或代理指令以及设计架构或UI时应用工程原则。按需选择实现、审查、研究、编写、代码、架构和前端工作的指导。

agent-skills 是什么?

该技能是一个工程哲学路由指南,旨在帮助AI代理根据当前任务类型动态选择最相关的工程原则。它区分了活动纪律(实现、审查、研究、编写)和结果纪律(代码、架构、前端),并支持两者组合以确保全面覆盖。该技能适用于Claude Code等AI代理,通过读取指定的参考文件来提供具体指导,而无需应用所有七项纪律。它强调职责分离、权限控制,并防止代理自动生成全纪律合规报告。该技能的主要价值在于避免过度工程化,确保每次只使用必要的原则,从而提高代理协作的效率和准确性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Xerrion/agent-skills/tree/HEAD/skills/engineering-philosophy

在你喜欢的 AI 中提问

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

文档

工程哲学

根据当前任务选择所需的学科。此技能是一个路由指南,而非通用清单。 即使多个学科同时适用,也应保持职责分离。

权限与范围

活动代理和任务定义了权限、范围、Git策略、委托和输出格式。 本技能及其引用均不扩展该权限。

阅读实现指南并不授权编辑、测试、提交或发布。 只读审查保持只读。研究或编写任务不会变成实现任务。 在采用风格默认值之前,先应用项目合同。这些原则不授权无关的工作。

选择并阅读参考

  1. 确定当前活动和受影响的行为。
  2. 包含活动代理明确要求的参考。
  3. 当条件适用时,从下表中选择额外的参考。
  4. 在相应工作开始前阅读每个选定的参考。不要仅仅将其列为已加载。
  5. 如果任务发生变化,重新考虑选择。如果参考内容未变,则重复使用已读过的参考。

以下所有路径均相对于 engineering-philosophy 技能目录。 生成的指令副本不会改变该基础目录。 这些是参考文件,而非可独立加载的技能。

必要时加载多个参考,但不要自动加载全部七个。 一个参考可以链接到另一个学科,而无需为每个任务都要求该学科。 仅在需要其指导时阅读链接的参考,而不是仅仅因为存在链接就阅读。

工作的执行方式

学科何时阅读参考
实现实现或验证软件变更,包括配置和代理指令。实现
审查审查代码、补丁、文件或先前的发现。审查
研究解决外部事实、API行为、兼容性或技术选择。研究
编写编写或修订持久性技术文档或面向代理的指令。编写

结果应满足的标准

学科何时阅读参考
代码实现或检查逻辑、转换、验证、状态转换或错误路径。代码
架构设计或检查边界、所有权、依赖关系、接口或跨组件影响。架构
前端设计或检查UI、样式、可访问性、交互或响应行为。前端

活动和结果学科可以组合。例如,UI实现可能需要实现、代码和前端。 代码审查使用审查和相关结果学科,而不继承实现职责。 仅限文档的任务可以使用编写,而无需加载代码或前端。

所有权与报告

每个参考拥有其学科的所有权。不要将其规则复制到本入口点或代理定义中。 code-review 仍然是审查程序、严重性阈值、裁决和报告格式的独立所有者。 asd-ste100 保持独立,并拥有其适用的受控语言规则。

仅使用实际已读参考中的相关原则。不要默认生成七学科合规报告。 遵循活动代理的报告格式。区分观察到的证据、提供的结果和未经核实的假设。 如果所需参考不可用,请说明并解释由此产生的限制。不要声称应用了未读过的指导。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能