mcpField
G
google-styleguides-skills

google-styleguides-skills

github.com/testdino-hq开发1264 次安装35 周前更新
代码仓库

关于 google-styleguides-skills

面向 AI 编码 Agent 的技能包,收录 Google 官方的 17 种编程与标记语言风格指南。指南安装到项目中,供 Agent 在生成代码时参考。

主要功能

  1. 01涵盖 17 种语言的风格指南
  2. 02覆盖前端、后端和移动开发
  3. 03命名与格式规范指导
  4. 04文档和代码质量指导
  5. 05可安装完整包或单项指南

适用场景

  1. 01让生成的代码遵循 Google 风格规范
  2. 02检查命名和格式实践
  3. 03查阅特定语言的文档规范

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/testdino-hq/google-styleguides-skills --skill google-styleguides-skills

安装后在 Claude Code 中输入/google-styleguides-skills确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE
README.md
angularjs/
angularjs.md
common-lisp/
common-lisp.md
cpp/
cpp.md
csharp/
csharp.md
go/
go.md
html-css/
html-css.md
java/
java.md
javascript/
javascript.md
json/
json.md
markdown/
markdown.md
objective-c/
objective-c.md
python/
python.md
r/
r.md
shell/
shell.md
swift/
swift.md
typescript/
typescript.md
vim-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 - 帮助用户理解接口
  • 解释原因,而非内容 - 代码展示内容,注释解释原因
  • 保持更新 - 过时的文档比没有文档更糟
代码质量
  • 优先考虑清晰度 - 可读代码胜过巧妙代码
  • 处理错误 - 不要忽略错误条件
  • 测试代码 - 自动化测试可以发现回归问题

工作原理

安装此技能后:

  1. 风格指南会复制到项目中的 .kiro/skills/
  2. 生成代码时,AI 编码 Agent 会读取这些指南
  3. 生成的代码会自动遵循 Google 官方风格规范

许可证

此项目根据 MIT License 授权。

Copyright (c) 2026 TestDino

来源

所有内容均源自 Google 官方风格指南:
https://google.github.io/styleguide/

评论

支持 Markdown