Community写作与编辑github.com

Dev-PGVAA/skills

编写聚焦且可验证的代码变更,或对差异、提交、拉取请求进行缺陷优先审查。适用于实现纪律、重构和代码审查;仅在要求时选择审查模式。新名称保持简短易读;注释解释原因,而非内容。

skills 是什么?

该技能旨在通过聚焦变更或缺陷优先审查来提升代码质量。它支持两种模式:实现/重构模式,要求开发者定义可观察的验收标准,并使用仓库的实际工具;审查模式则保持只读,除非同时要求修复。技能强调以具体证据而非抽象规则进行审查。该技能适用于 Claude Code、Cursor 等 AI 代理工具,通过遵循仓库架构、用户编辑和读写范围来确保变更的精准性。它鼓励在不确定性较高时委托子代理(如契约侦察员、验证者或按风险分区的审查者),但强调在上下文传递成本高于任务本身时避免委托。最终输出需报告实际运行检查、行为变更或可操作的发现,并明确限制,不要求无意义的测试或抽象设计。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/code-quality

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

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

文档

代码质量

使请求的行为正确,进行聚焦变更;使用具体证据审查缺陷。尊重仓库指令、现有架构、用户编辑以及请求的读写范围。

选择模式

  • 实现/重构: 阅读指南。定义可观察的验收标准,并使用仓库的实际工具。
  • 审查: 阅读审查。保持只读,除非同时要求修复。在得出结论前确认比较对象。
  • 小编辑需要小工作流。不要仅仅为了满足本技能而创建计划、抽象、测试或额外文件。

有用的委托

使用可用的子代理进行独立工作,以实质性减少不确定性。当上下文传递成本超过任务本身时,跳过委托;如果代理不可用,则顺序使用相同的角色。

  • 实现: 契约侦察员读取调用方、接口和现有测试,同时父代理进行实现;验证者在稳定补丁后执行更改行为。仅在真正独立的文件之间拆分实现,每个文件有一个所有者,父代理拥有集成文件。
  • 审查: 按风险分区,例如授权/数据处理与状态/并发,或不相交的模块。为每个审查者提供相同的 base/head 和所需的用户行为。父代理追踪跨模块路径,检查每个建议的发现,删除重复项,并分配最终严重性。
  • 委托的任务需明确目标、允许的路径、读写范围、假设、停止点以及期望的证据。返回更改的文件或 path:line 的发现、实际复现/测试结果以及未解决的问题。除非有有用的限定理由,否则不要递归委托。

完成

报告行为变更或可行动的发现、实际运行的检查以及实质性限制。“无发现”是有效的;通过类型检查并不能证明运行时行为或部署。

Individual skills in this repo

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

相关技能