Agent skill

Gs

by go-spring in go-spring/go-spring

Go-Spring 项目研发托管入口:一句话诉求经 规划(Plan)→ 执行(Execute)→ 交付(Settle)循环,从工具集(起骨架/加接口/重生成/接组件/补测试)中选取组合并落地。在 Go-Spring 项目中开展任一研发任务时触发;由 Plan 判定是否接管,超范围时放手。

Apache-2.0Auto-check passedBackend & APIs

Install Gs

skills CLI
$ npx skills add go-spring/go-spring --skill gs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install go-spring/go-spring gs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/go-spring/go-spring.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gs .claude/skills/gs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gs
GitHub stars
1.8k
Token cost
~1.1k tokens
SKILL.md length
290 words
Files
27 (incl. references)
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Go-Spring 项目研发托管入口:一句话诉求经 规划(Plan)→ 执行(Execute)→ 交付(Settle)循环,从工具集(起骨架/加接口/重生成/接组件/补测试)中选取组合并落地。在 Go-Spring 项目中开展任一研发任务时触发;由 Plan 判定是否接管,超范围时放手。

  • Tasks that involve gRPC and Protobuf
  • SKILL.md covers PES 控制环, 工具集(Execute 按 Plan 选用), 会话状态机 and 共用约定(所有环节与工具遵守), plus 1 more section
  • Runs Shell scripts from its folder; calls go

What it does

Gs is an agent skill from go-spring/go-spring. Go-Spring 项目研发托管入口:一句话诉求经 规划(Plan)→ 执行(Execute)→ 交付(Settle)循环,从工具集(起骨架/加接口/重生成/接组件/补测试)中选取组合并落地。在 Go-Spring 项目中开展任一研发任务时触发;由 Plan 判定是否接管,超范围时放手。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 31 other files, including reference files (for example `README.md`, `README_CN.md` and `execute/build-test.md`).

It sits in Backend & APIs, covering gRPC and Protobuf. It works with Spring Boot and gRPC. The repository describes itself as: 🔥 [released] 基于 IoC 的 IDLs-First 的 Go 后端一站式开发框架 ( All-in-One Development Framework on IoC and IDLs-First for Go ) 🚀. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve gRPC and Protobuf

Example prompts

  • “/gs”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 4e81262. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gs loads about 1.1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 37 tokens; SKILL.md has 290 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from go-spring/go-spring at commit 4e81262, republished under its Apache-2.0 licence (© go-spring). 290 words, ~1,062 tokens.

Download SKILL.mdSave it as .claude/skills/gs/SKILL.md (or your agent's skills folder). This skill also uses 26 other files; get the full folder from GitHub.
name
gs
description
Go-Spring 项目研发托管入口:一句话诉求经 规划(Plan)→ 执行(Execute)→ 交付(Settle)循环,从工具集(起骨架/加接口/重生成/接组件/补测试)中选取组合并落地。在 Go-Spring 项目中开展任一研发任务时触发;由 Plan 判定是否接管,超范围时放手。
version
v0.0.1

/gs Skill

Go-Spring 项目研发的 PES 控制环。不是 CLI 外壳,也不是按生命周期排好的流水线,而是:任何请求先规划,再从独立工具集里选取本次所需能力的组合,执行并验证,最后交付沉淀。

核心认知:一个请求往往需要多个工具的组合,所以无论大小,都先过 PES。工具集保持独立,由 Plan 编排。

PES 控制环

Plan ──确认──▶ Execute ──全绿──▶ Settle
  ▲              │
  └──失败按半径回环─┘
环节职责文档
Plan判定接不接 + 分解意图 + 选工具 + 排序 + 定验收plan/plan.md
Execute按序调用工具 + 内建验证 + 失败局部回环execute/execute.md
Settle交付说明 + 沉淀约定settle/settle.md

进入本 skill,一律先读 plan/plan.md(判定门在里面);不要凭记忆跳过 Plan 直接动手。

工具集(Execute 按 Plan 选用)

各工具逻辑独立、自带前置检查,可被自由组合。执行前先读对应文档,不凭记忆。标「待补充」的为占位工具,骨架已就位、流程待填。

工具关键词文档
起项目骨架新建 / 初始化 / gs init / 切换 layouttools/scaffold.md
新增业务模块(BC)加模块 / 新增业务域 / 新建 BC / 加 domaintools/add-module.md 待补充
新增 HTTP 接口加接口 / 新增 API / 改 IDL 加路由tools/add-http.md
新增 gRPC 接口加 gRPC / 改 proto 加 rpctools/add-grpc.md 待补充
新增 Thrift 接口加 Thrift / 改 thrift IDLtools/add-thrift.md 待补充
新增 WebSocket 入口加 ws / 长连接推送tools/add-ws.md 待补充
新增定时任务加 job / 加 cron / 后台任务tools/add-job.md 待补充
新增 MQ 消费/生产加 consumer / 加 producer / 收发消息tools/add-mq.md 待补充
新增 infra 防腐层 client调下游 / 接外部系统 / 加 clienttools/add-client.md 待补充
新增 infra 仓储 repo加 repo / 持久化聚合 / 存表tools/add-repo.md 待补充
重新生成代码重新生成 / IDL 改了 / gs-http-gen / gs-mocktools/gen.md
接入组件(消费 Starter)接 Redis / 接 MySQL / 接 Kafka / 加 Startertools/wire-starter.md
补测试 / 示例补测试 / 加用例 / 加 exampletools/add-test.md
文档润色润色文档 / 优化 README / 润色 / 改写文档 / polish doctools/polish-doc.md
创作新 Starter(框架侧)新建 starter / 集成新组件到 go-springtools/new-starter.md 待补充

构建/测试(execute/build-test.md)与报错定位(execute/fix-compile.md)是 Execute 的内建验证,不是可选工具——任何改动后自动执行,Plan 无需显式排入。通用编译/测试报错以 AI 自身调试能力为主;这两份文档只补 go-spring 生态特有的部分(多 module 定位、生成物过期回 gen 重生成而非手改、四层依赖边界)。

会话状态机

会话进入 PES 后,PES 状态是默认处理框架,但不是牢笼:

  • Plan 是可变状态:用户任何时候可回头调 Plan,调完重新对齐再继续;
  • 失败按爆炸半径回环,不推倒重来:局部失败只在当前步修复重试,已完成步骤不动;仅当失败证伪了 Plan 前提,才回整体重规划;
  • 离题旁问不破坏状态:执行中临时问无关问题,答完回到原进度;
  • 保真度可伸缩:阶段永远走,产物按需生——小需求的 Plan/Settle 可以只是一句话,别为琐事产出规划/交付文档。

共用约定(所有环节与工具遵守)

代码/布局规约(生产代码怎么写、目录怎么分)不在此重复,执行前按需查阅:

  • 编码风格与架构取向(错误包装 errutil、IoC 启动期注入、Bean 冲突显式化、Starter 优先、子进程 IO 等):coding-style.zh.md
  • 分层边界与目录划分(job/mqsvr、api/controller vs api/server/<proto>/handler 等):domain-rules.zh.md
  • 多 module 结构(仓库根无 go.mod;go build/test/gofmt 下钻到子 module):见项目 CLAUDE.md

以下是 skill 自身的执行约定:

  • 上下文优先:执行前先读 AGENTS.md / CLAUDE.md / CODING_STYLE.md / 目录约定,不凭记忆假设结构。
  • 前置检查:所需二进制在 PATH 中、目标目录状态符合预期、外部服务可达;不满足直接终止。
  • 入参校验:module path、layout、语言、接口名等参数在动手前完成合法性校验,非法值立即报错。
  • 冲突检测:目标目录/文件已存在等冲突直接终止,不覆盖不删除。
  • 改动收敛:每次代码改动后跑 gofmt + go test(必要时 go build),给出验证结论。
  • 变更摘要:代码/配置/接口/文档改动完成后,输出变更清单 + 验证命令 + 遗留风险。
  • 文档同步(动作,非态度):同步不靠记忆,靠可检测的触发条件——改了 X 必须动 Y,当轮完成不留事后补。由 Execute 的同步检测内建执行(见 execute/execute.md 第 3 步):
    • 改 .idl/.proto/schema 源 → 回 gen 重生成,禁手改生成物;
    • 改接口签名(method/path/字段)→ 同步接口文档;
    • 改配置键 → 同步配置文档/示例。
    • 理念见 references/doc-code-sync.zh.md。

参考文档(理念背书,非执行流程)

references/ 存放跨环节的方法论结论,供判断时查阅,不排进 PES 序列:

文档用途
references/dev-doc-chain.zh.md从需求到交付的四层文档链,与 PES 环的对应
references/doc-code-sync.zh.md文档与代码同步的三层机制,支撑 Execute 的同步检测

© go-spring, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 26 other files (references) in skills/gs of go-spring/go-spring.

  • SKILL.md
  • README.md
  • README_CN.md
  • execute/build-test.md
  • execute/execute.md
  • execute/fix-compile.md
  • install-local.sh
  • install.sh
  • plan/plan.md
  • references/dev-doc-chain.zh.md
  • references/doc-code-sync.zh.md
  • settle/settle.md
  • tools/add-client.md
  • tools/add-grpc.md
  • tools/add-http.md
  • tools/add-job.md
  • … and 11 more

Open the folder on GitHubat commit 4e81262

Compare with similar skills

Gs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gs this skillgo-spring/go-spring1.8k—~1.1kAutomated safety check: PassApache-2.0
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
Golang Proantoniopaya22/go-rest-template1723 repos~1.2kAutomated safety check: PassMIT
Debug Grpc ConnectionGetBindu/Bindu10k—~1.2kAutomated safety check: PassCustom licence
Aspnet Corefanslead/ReverseProxy.Store1632 repos~1.4kAutomated safety check: PassApache-2.0
Regenerate Grpc StubsGetBindu/Bindu10k—~810Automated safety check: PassCustom licence

Similar skills

  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Golang Pro

    antoniopaya22/go-rest-template

    Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with…

    172 GitHub starsUsed in 3 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Debug Grpc Connection

    GetBindu/Bindu

    Diagnose gRPC connection issues between the Bindu core and a language SDK.

    10k GitHub stars~1.2k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Aspnet Core

    fanslead/ReverseProxy.Store

    Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development.

    163 GitHub starsUsed in 2 repos~1.4k tokens
    Backend & APIsAuto-check passed
  • Regenerate Grpc Stubs

    GetBindu/Bindu

    Regenerate Python + TypeScript gRPC stubs after editing proto files.

    10k GitHub stars~810 tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Spider King

    aoyunyang/spider-king-skill

    Pure-web protocol reverse skill: turn hostile browser clients into browser-free Python collectors.

    507 GitHub stars~7.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from go-spring/go-spring

  • Doc Writer

    go-spring/go-spring

    用于编写、改写、审阅或扩展 Go-Spring 文档。写作前应核对源码、测试、示例和已有文档;当目标文档属于已约束范围时,遵守 Go-Spring 文档写作规范。

    1.8k GitHub stars~354 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Gs

What does Gs do?

Go-Spring 项目研发托管入口:一句话诉求经 规划(Plan)→ 执行(Execute)→ 交付(Settle)循环,从工具集(起骨架/加接口/重生成/接组件/补测试)中选取组合并落地。在 Go-Spring 项目中开展任一研发任务时触发;由 Plan 判定是否接管,超范围时放手。. Gs is an agent skill from go-spring/go-spring.

When should I use Gs?

Gs fits situations like: tasks that involve gRPC and Protobuf.

How do I install Gs in Claude Code?

Run `npx skills add go-spring/go-spring --skill gs -a claude-code`. Or copy the skill folder (skills/gs in go-spring/go-spring) into .claude/skills/gs in your project. Claude Code loads it when a task matches its description.

How do I install Gs in Codex?

Run `npx skills add go-spring/go-spring --skill gs -a codex`. Or copy the skill folder (skills/gs in go-spring/go-spring) into .agents/skills/gs in your project. Codex loads it when a task matches its description.

Can I use Gs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add go-spring/go-spring --skill gs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gs, .gemini/skills/gs, .github/skills/gs and .opencode/skills/gs in your project.

What does Gs need to run?

Going by SKILL.md and its folder, Gs needs a shell for the scripts in its folder and the command-line tools its instructions call (go). Our summary lists: A Bash shell.

Does Gs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gs use?

Gs is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gs use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 841 tokens, read only when the agent opens those files.

What are the alternatives to Gs?

Skills that share tags, products or a category with Gs: Use Yaak (mountain-loop/yaak, 19k stars), Golang Pro (antoniopaya22/go-rest-template, 172 stars), Debug Grpc Connection (GetBindu/Bindu, 10k stars) and Aspnet Core (fanslead/ReverseProxy.Store, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gs?

go-spring (a GitHub organization) maintains it in go-spring/go-spring, which has 1,803 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 6, 2026.

Source: go-spring/go-spring on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.