Solid Skills — AI 编程代理的资深工程师级编码技能
通过 SOLID 原则、TDD 与整洁架构,把初级水准的代码改造成资深工程师品质的软件。
- Star 数
- ★ 612
- 最近更新
- 1 个月前
- FA 评分
- 41/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- TypeScript/NestJS 开发者在实现新功能(如用户注册)时,希望代理按 TDD 流程先写测试再写实现。
- 不适合
- 主要使用非 TypeScript/NestJS 或非面向对象语言的团队
- 需要可审计的测试、基准或发布证据来评估效果的团队
- 使用不支持 Agent Skills 格式的宿主代理的环境
这个 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?
在支持 Agent Skills 格式的 AI 编码代理环境中运行:
npx skills add ramziddin/solid-skills需要已安装 Node.js(提供 npx 命令)。仓库未说明其他凭据或运行时要求。
如何使用这个 Agent?
安装后技能自动可用,无需手动配置。代理在检测到相关任务时自动调用。可直接下达指令,例如:“实现一个用户注册功能”、“把这个服务重构为符合 SOLID 原则”、“评审这段代码的质量问题”、“为这个模块添加测试”、“设计支付系统的架构”。
这个 Agent 有哪些优点和局限?
- 内置九份结构化参考文档(含 GoF 模式、整洁架构、复杂度管理等),知识密度高于单文件提示词技能。
- 给出可执行的具体约束(方法 <10 行、类 <50 行、值对象、迪米特法则),而非泛泛的“写好代码”。
- 强制 TDD 先行工作流,可改变代理默认“先写实现”的习惯。
- 主要针对 TypeScript 与 NestJS 设计,用于其他语言或范式的代码库需自行评估适配效果。
- 仓库未提供测试、发布版本或实际效果基准,宣称的质量提升缺乏可审计证据。
- 依赖宿主代理支持 Agent Skills(anthropics/skills)格式,不兼容该格式的环境无法直接使用。
这个 Agent 与同类方案有什么区别?
仓库遵循 Anthropic 官方 skills 仓库(anthropics/skills)定义的 Agent Skills 格式,可作为该生态中的第三方技能安装,但未在 README 中点名其他同类竞品。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Solid Skills — AI 编程代理的资深工程师级编码技能 当前 | 41 · 缺口较多 | Agent 插件 / 技能免费 | ★ 612 | 1 个月前 | — | — |
| AutoBE | 35 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.4k | 4 个月前 | TypeScript | — |
| Agent 规则 / 技能库:从编程书籍提炼 | 45 · 缺口较多 | 命令行工具免费 | ★ 3.1k | 1 个月前 | — | Codex · Claude Code |
| Jev Review | 81 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 245 | 1 个月前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
该技能为纯指令型内容,未见脚本或网络访问,攻击面有限,故各信任项给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分。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 仅审阅了README,SKILL.md与九份参考文档未在证据中提供,实际技能质量与体积无法核实。
- 技能声称自动修改代码,但无用户确认或回滚机制说明,建议在生产使用前人工审查每次代码修改。
- 无版本号、无变更日志、无维护承诺,更新与回归风险由使用者承担。
- 许可仅以README文字声明MIT,建议确认仓库含LICENSE文件。