关于 google-styleguides-skills
面向 AI 编码 Agent 的技能包,收录 Google 官方的 17 种编程与标记语言风格指南。指南安装到项目中,供 Agent 在生成代码时参考。
主要功能
- 01涵盖 17 种语言的风格指南
- 02覆盖前端、后端和移动开发
- 03命名与格式规范指导
- 04文档和代码质量指导
- 05可安装完整包或单项指南
适用场景
- 01让生成的代码遵循 Google 风格规范
- 02检查命名和格式实践
- 03查阅特定语言的文档规范
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ testdino-hq/ google-styleguides-skills --skill google-styleguides-skills安装后在 Claude Code 中输入/google-styleguides-skills确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSEREADME.mdangularjs/angularjs.mdcommon-lisp/common-lisp.mdcpp/cpp.mdcsharp/csharp.mdgo/go.mdhtml-css/html-css.mdjava/java.mdjavascript/javascript.mdjson/json.mdmarkdown/markdown.mdobjective-c/objective-c.mdpython/python.mdr/r.mdshell/shell.mdswift/swift.mdtypescript/typescript.mdvim-script/vim-script.md详细介绍
Google 风格指南
面向 17 种语言的 Google 官方风格指南——为 AI 编码 Agent 打包。
此技能包包含来自 https://google.github.io/styleguide/ 的全部 17 份 Google 官方风格指南。
包含的风格指南
前端
- TypeScript - 类型、接口、命名、空值处理、枚举、导入
- JavaScript - ES6+、模块、命名、格式、JSDoc
- HTML/CSS - 格式、命名、语义、无障碍
- AngularJS - 控制器、服务、指令、模块
后端
- Python - PEP 8、类型提示、文档字符串、导入、推导式
- Java - 命名、格式、Javadoc、异常、最佳实践
- Go - 格式、命名、注释、错误处理、并发
- C++ - 头文件、命名、格式、类、内存管理
- C# - 命名、格式、LINQ、async/await、XML 文档
移动端
- Swift - 命名、可选值、协议、错误处理、格式
- Objective-C - 命名、格式、内存管理、协议
其他
- Shell - Bash 脚本、命名、错误处理、可移植性
- R - 命名、格式、函数、文档
- Common Lisp - 命名、格式、宏、文档
- Vim Script - 插件结构、命名、可移植性
- JSON - 格式、命名、结构、注释
- Markdown - 格式、结构、链接、列表
安装选项
安装全部内容(此技能)
npx skills add testdino-hq/google-styleguides-skills
安装单种语言
# Frontend
npx skills add testdino-hq/google-styleguides-skills/typescript
npx skills add testdino-hq/google-styleguides-skills/javascript
npx skills add testdino-hq/google-styleguides-skills/html-css
npx skills add testdino-hq/google-styleguides-skills/angularjs
# Backend
npx skills add testdino-hq/google-styleguides-skills/python
npx skills add testdino-hq/google-styleguides-skills/java
npx skills add testdino-hq/google-styleguides-skills/go
npx skills add testdino-hq/google-styleguides-skills/cpp
npx skills add testdino-hq/google-styleguides-skills/csharp
# Mobile
npx skills add testdino-hq/google-styleguides-skills/swift
npx skills add testdino-hq/google-styleguides-skills/objective-c
# Other
npx skills add testdino-hq/google-styleguides-skills/shell
npx skills add testdino-hq/google-styleguides-skills/r
npx skills add testdino-hq/google-styleguides-skills/common-lisp
npx skills add testdino-hq/google-styleguides-skills/vim-script
npx skills add testdino-hq/google-styleguides-skills/json
npx skills add testdino-hq/google-styleguides-skills/markdown
各语言通用黄金法则
命名
- 保持一致 - 遵循语言惯例
- 描述清晰 - 清晰优先于简短
- 符合惯例 - 使用成熟的模式
格式
- 自动化处理 - 使用语言专用格式化工具
- 保持一致 - 整个代码库使用相同风格
- 遵循标准 - 不要重新发明格式规则
文档
- 记录公共 API - 帮助用户理解接口
- 解释原因,而非内容 - 代码展示内容,注释解释原因
- 保持更新 - 过时的文档比没有文档更糟
代码质量
- 优先考虑清晰度 - 可读代码胜过巧妙代码
- 处理错误 - 不要忽略错误条件
- 测试代码 - 自动化测试可以发现回归问题
工作原理
安装此技能后:
- 风格指南会复制到项目中的
.kiro/skills/ - 生成代码时,AI 编码 Agent 会读取这些指南
- 生成的代码会自动遵循 Google 官方风格规范
许可证
此项目根据 MIT License 授权。
Copyright (c) 2026 TestDino
来源
所有内容均源自 Google 官方风格指南:
https://google.github.io/styleguide/
评论
支持 Markdown