Solid Skills — AI 编程代理的资深工程师级编码技能
通过 SOLID 原则、TDD 与整洁架构,把初级水准的代码改造成资深工程师品质的软件。
该技能为纯指令型内容,未见脚本或网络访问,攻击面有限,故各信任项给1分而非0分;但README声称'自动检测并修复代码坏味道',未说明修改代码前是否征求用户确认,也无回滚指引,rollback为0。来源署名方面给出Academind课程致谢并声明MIT,得2分。
README内部自洽(技能名、目录结构、安装命令一致),得2分;但依赖外部Agent Skills运行时且安装路径仅一条npx命令,失败行为无任何说明,各得1分。
明确面向TypeScript/NestJS并给出使用场景,得2分;但触发条件过宽('writing any code'均触发),能力边界与不适用环境未说明,各扣分得1分。
目录结构、命名、安装说明、MIT许可声明均清晰,得2分;但未提供LICENSE文件证据、无变更日志、无已知限制说明、无维护者/更新路径说明,均为扣分点。
打包九份参考文档具有一定边际价值,得2分;但SKILL.md与参考文档内容未在证据中提供,输出可用性只能推测;参考文档体积对上下文成本的影响未讨论,得1分。
所有核心声明(方法<10行、自动修复坏味道等)均无随附证据且引用文件未提供,事实与推断未分离,仅Academind致谢可外部对照,各得1分。
- 仅审阅了README,SKILL.md与九份参考文档未在证据中提供,实际技能质量与体积无法核实。
- 技能声称自动修改代码,但无用户确认或回滚机制说明,建议在生产使用前人工审查每次代码修改。
- 无版本号、无变更日志、无维护承诺,更新与回归风险由使用者承担。
- 许可仅以README文字声明MIT,建议确认仓库含LICENSE文件。
这个 Agent 能做什么,适合哪些场景?
Solid Skills 是 GitHub 仓库 ramziddin/solid-skills 提供的一套面向 AI 编码代理的技能包,遵循 Anthropic 的 Agent Skills 格式。它目前包含一个名为 solid 的技能,主张在编写、重构、评审、测试和架构设计等场景中强制执行 TDD 工作流和 SOLID 原则。技能主体是 SKILL.md 指令文件,并附带九份参考文档,覆盖 SOLID 原则、TDD、测试策略、整洁代码、代码异味、GoF 设计模式、整洁架构、对象设计与复杂度管理。它主要面向 TypeScript 与 NestJS 项目,但也声明适用于任何面向对象的代码库。安装后技能自动可用,当代理检测到相关任务时会自动调用。仓库采用 MIT 许可证。
安装后(npx skills add ramziddin/solid-skills),solid 技能注入一套编码规范指令:强制 TDD 的 Red-Green-Refactor 循环(先写失败测试)、对每个类和函数应用 SOLID 五原则、自动检测并修复代码异味、用值对象表示领域原语(ID、邮箱、金额)、遵循迪米特法则与“告诉,不要问”、方法保持在 10 行以内、类保持在 50 行以内。九份 references 文档(solid-principles.md、tdd.md、testing.md、clean-code.md、code-smells.md、design-patterns.md、architecture.md、object-design.md、complexity.md)为代理提供带 TypeScript 示例的详细参考。
- TypeScript/NestJS 开发者在实现新功能(如用户注册)时,希望代理按 TDD 流程先写测试再写实现。
- 维护旧代码库的工程师,让代理把不符合 SOLID 的服务重构为职责单一、依赖倒置的结构。
- 团队评审者在代码评审时让代理检测代码异味并提出修复建议。
- 架构师在为支付系统等模块做架构设计时,借助垂直切片与整洁架构原则获得设计方案。
- 为现有模块补充测试的开发者,需要测试策略与模式方面的指导。
这个 Agent 有哪些优点和局限?
- 内置九份结构化参考文档(含 GoF 模式、整洁架构、复杂度管理等),知识密度高于单文件提示词技能。
- 给出可执行的具体约束(方法 <10 行、类 <50 行、值对象、迪米特法则),而非泛泛的“写好代码”。
- 强制 TDD 先行工作流,可改变代理默认“先写实现”的习惯。
- 主要针对 TypeScript 与 NestJS 设计,用于其他语言或范式的代码库需自行评估适配效果。
- 仓库未提供测试、发布版本或实际效果基准,宣称的质量提升缺乏可审计证据。
- 依赖宿主代理支持 Agent Skills(anthropics/skills)格式,不兼容该格式的环境无法直接使用。
如何安装或部署这个 Agent?
在支持 Agent Skills 格式的 AI 编码代理环境中运行:
npx skills add ramziddin/solid-skills需要已安装 Node.js(提供 npx 命令)。仓库未说明其他凭据或运行时要求。
如何使用这个 Agent?
安装后技能自动可用,无需手动配置。代理在检测到相关任务时自动调用。可直接下达指令,例如:“实现一个用户注册功能”、“把这个服务重构为符合 SOLID 原则”、“评审这段代码的质量问题”、“为这个模块添加测试”、“设计支付系统的架构”。
这个 Agent 与同类方案有什么区别?
仓库遵循 Anthropic 官方 skills 仓库(anthropics/skills)定义的 Agent Skills 格式,可作为该生态中的第三方技能安装,但未在 README 中点名其他同类竞品。