开发与工程 solid-principlestddclean-codedesign-patternstypescriptnestjscode-qualityarchitecture

Solid Skills — AI 编程代理的资深工程师级编码技能

通过 SOLID 原则、TDD 与整洁架构,把初级水准的代码改造成资深工程师品质的软件。

FollowAgents 评估 · FARS-2.1
不推荐
41/ 100 五分制 2.1 / 5
1 2 3 4 5 6
1信任安全10 / 29 · 1.7/5

该技能为纯指令型内容,未见脚本或网络访问,攻击面有限,故各信任项给1分而非0分;但README声称'自动检测并修复代码坏味道',未说明修改代码前是否征求用户确认,也无回滚指引,rollback为0。来源署名方面给出Academind课程致谢并声明MIT,得2分。

2可靠稳定6 / 14 · 2.1/5

README内部自洽(技能名、目录结构、安装命令一致),得2分;但依赖外部Agent Skills运行时且安装路径仅一条npx命令,失败行为无任何说明,各得1分。

3适用触发8 / 18 · 2.2/5

明确面向TypeScript/NestJS并给出使用场景,得2分;但触发条件过宽('writing any code'均触发),能力边界与不适用环境未说明,各扣分得1分。

4规范维护8 / 18 · 2.2/5

目录结构、命名、安装说明、MIT许可声明均清晰,得2分;但未提供LICENSE文件证据、无变更日志、无已知限制说明、无维护者/更新路径说明,均为扣分点。

5有效结果6 / 13 · 2.3/5

打包九份参考文档具有一定边际价值,得2分;但SKILL.md与参考文档内容未在证据中提供,输出可用性只能推测;参考文档体积对上下文成本的影响未讨论,得1分。

6证据核验3 / 8 · 1.9/5

所有核心声明(方法<10行、自动修复坏味道等)均无随附证据且引用文件未提供,事实与推断未分离,仅Academind致谢可外部对照,各得1分。

证据充分度: 评估于 2026年9月7日 审查版本 94978c9cb06d
源码中未见的安全控制:回滚或恢复路径
使用前请注意
  • 仅审阅了README,SKILL.md与九份参考文档未在证据中提供,实际技能质量与体积无法核实。
  • 技能声称自动修改代码,但无用户确认或回滚机制说明,建议在生产使用前人工审查每次代码修改。
  • 无版本号、无变更日志、无维护承诺,更新与回归风险由使用者承担。
  • 许可仅以README文字声明MIT,建议确认仓库含LICENSE文件。
评估证据 [1]
查看完整评分方法 →

这个 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 示例的详细参考。

  1. TypeScript/NestJS 开发者在实现新功能(如用户注册)时,希望代理按 TDD 流程先写测试再写实现。
  2. 维护旧代码库的工程师,让代理把不符合 SOLID 的服务重构为职责单一、依赖倒置的结构。
  3. 团队评审者在代码评审时让代理检测代码异味并提出修复建议。
  4. 架构师在为支付系统等模块做架构设计时,借助垂直切片与整洁架构原则获得设计方案。
  5. 为现有模块补充测试的开发者,需要测试策略与模式方面的指导。

这个 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 中点名其他同类竞品。

常见问题

它支持哪些语言?
主要为 TypeScript 和 NestJS 项目设计,但声明适用于任何面向对象的代码库;函数式或脚本类项目效果未经验证。
需要什么运行环境?
安装使用 npx 命令,需要 Node.js;宿主代理需支持 Agent Skills 格式。仓库未说明其他依赖。
安装后需要配置吗?
不需要。README 说明技能安装后自动可用,代理在检测到相关任务时自动使用。
它是免费/开源的吗?
是,仓库采用 MIT 许可证;其中 clean-code.md 部分概念来自 Academind 的 Clean Code 课程摘要(已署名)。
效果有保障吗?
README 未提供测试、基准或用户反馈,质量提升属于作者主张,建议在自身代码库上试用验证。

相关 Agents