Cloudrun Development
TencentCloudBase/CloudBase-AI-Toolkit
CloudBase Run backend development rules (Function mode/Container mode).
基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。
$ npx skills add thkhxm/tgf --skill tgf-server-dev -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install thkhxm/tgf tgf-server-dev --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/thkhxm/tgf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tgf-server-dev .claude/skills/tgf-server-dev && rm -rf skills-srcUse ~/.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/
Install the "tgf-server-dev" agent skill from https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-dev into .claude/skills/tgf-server-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tgf-server-dev", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-devType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add thkhxm/tgf --skill tgf-server-dev -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install thkhxm/tgf tgf-server-dev --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thkhxm/tgf.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/tgf-server-dev .agents/skills/tgf-server-dev && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tgf-server-dev" agent skill from https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-dev into .agents/skills/tgf-server-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tgf-server-dev", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add thkhxm/tgf --skill tgf-server-dev -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install thkhxm/tgf tgf-server-dev --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thkhxm/tgf.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/tgf-server-dev .cursor/skills/tgf-server-dev && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tgf-server-dev" agent skill from https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-dev into .cursor/skills/tgf-server-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tgf-server-dev", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/thkhxm/tgf.git --path .claude/skills/tgf-server-dev--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add thkhxm/tgf --skill tgf-server-dev -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install thkhxm/tgf tgf-server-dev --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thkhxm/tgf.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/tgf-server-dev .gemini/skills/tgf-server-dev && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tgf-server-dev" agent skill from https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-dev into .gemini/skills/tgf-server-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tgf-server-dev", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install thkhxm/tgf tgf-server-devInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add thkhxm/tgf --skill tgf-server-dev -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/thkhxm/tgf.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/tgf-server-dev .github/skills/tgf-server-dev && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tgf-server-dev" agent skill from https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-dev into .github/skills/tgf-server-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tgf-server-dev", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add thkhxm/tgf --skill tgf-server-dev -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install thkhxm/tgf tgf-server-dev --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thkhxm/tgf.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/tgf-server-dev .opencode/skills/tgf-server-dev && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tgf-server-dev" agent skill from https://github.com/thkhxm/tgf/tree/master/.claude/skills/tgf-server-dev into .opencode/skills/tgf-server-dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tgf-server-dev", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
tgf-server-dev基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。
Tgf Server Dev is an agent skill from thkhxm/tgf. 基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。 当用户要创建 tgf 项目、生成 tgf 脚手架、搭建单进程或分布式游戏服、HTTP REST、HTTP+RPC、 TCP/WebSocket/KCP 网关、Redis/MySQL write-behind、Docker Compose/K8s 部署,或排查 tgf 使用问题时使用。
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/api-reference.md` and `references/generator-contract.md`).
It sits in Databases, covering Container orchestration, Realtime and WebSockets and Containers. It works with GitHub, Redis, Kubernetes and MySQL. The repository describes itself as: tgf框架是使用golang开发的一套游戏分布式框架.项目采用了rpcx做为底层rpc的通讯,consul提供服务注册发现.定义了一整套的模块开发规范. The licence is MIT.
9 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit ff52796. It shows what the files ask for, not the result of running them.
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.
Ships 2 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
goghFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Tgf Server Dev loads about 1.3k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 363 words of instructions outside code blocks.
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.
The automated check noted patterns worth knowing about, such as sudo or a known installer.
enerated` / `external` | 前者用 CSPRNG 写本地 `.env.dev`;后者只留外部注入占位 |- `.env.dev`、`.env.test`、`.env.release`、日志和可执行产物必须被 `.gitignore` 忽略;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); the scripts in this folder are not scanned.
The full file from thkhxm/tgf at commit ff52796, republished under its MIT licence (© thkhxm). 363 words, ~1,264 tokens.
.claude/skills/tgf-server-dev/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.用“问答决策 → tgfctl 原子生成 → 来源验证 → 构建/冒烟 → 有界修复”交付一致的业务项目。
模板的唯一权威来源是 github.com/thkhxm/tgf/v2/cmd/tgfctl 内嵌资源;禁止由模型复制或临场改写模板。
go 1.26.0,推荐 toolchain go1.26.4;先执行 go version。github.com/thkhxm/tgf/v2 的公开版本,不手写 rpcx/rpcx-consul,也不加本地 replace。@latest 是默认且受支持的输入;tgfctl 必须先解析它,再把精确版本写入 go.mod。go.work。不要全局或无条件设置 GOWORK=off;它只适合发布隔离检查。SIGINT/SIGTERM。业务 main 只等待 Run() 返回,禁止再写 signal.Notify 抢占信号。框架调用不确定时,先读 API 速查,再读对应版本源码,禁止凭记忆杜撰。
用户已说明的项不要重复问;缺少会改变产物的项才询问。
| 决策 | 值 | 约束 |
|---|---|---|
| module | 合法 Go module path | 分布式项目内部 import 依赖它 |
| profile | single / distributed / http-rest / http-rpc | 四种一等项目形态 |
| data | none / redis / redis-mysql | distributed 最低为 redis |
| protocol | none / tcp / websocket / kcp / all | HTTP 两种 profile 必须为 none;游戏网关始终含 TCP,其他值增加 WS/KCP |
| deploy | local / compose / k8s | compose、k8s 都生成 Dockerfile |
| security | dev-generated / external | 前者用 CSPRNG 写本地 .env.dev;后者只留外部注入占位 |
安全默认:游戏网关必须有 LoginTokenSecret;admin 不用时保持 fail-closed;KCP 必须使用 32 字节 AEAD key。
不要让用户在聊天、命令行参数或 Git 文件中提供真实密钥。
优先使用 PATH 中的 tgfctl。未安装时使用公开模块运行。
已安装工具的入口是 tgfctl init ...;下面的 go run 形式与它等价:
go run github.com/thkhxm/tgf/v2/cmd/tgfctl@latest init \
--module github.com/acme/mygame \
--dir ./mygame \
--profile single \
--data none \
--protocol tcp \
--deploy local \
--security dev-generated \
--tgf-version latest仅框架维护者测试尚未发布的 CLI 时,才可从明确的 tgf checkout 执行 go run ./cmd/tgfctl;
生成项目本身仍必须是 GitHub module consumer,并通过下一节的来源检查。
生成器默认执行 go mod tidy、go build ./...、go vet ./... 和来源验证。目标目录默认必须不存在;
--force 也只接受空目录,绝不合并或删除用户文件。--git-init 必须由用户明确要求才传。
完整命令、参数交叉约束、原子生成和退出行为见 生成器契约。
生成完成后再次运行:
tgfctl verify --dir ./mygame如果使用 go run,保持同一来源:
go run github.com/thkhxm/tgf/v2/cmd/tgfctl@latest verify --dir ./mygame通过条件:
go.mod 直接 require github.com/thkhxm/tgf/v2 v2.x.y,版本非 latest、非空;go.mod 不含指向 tgf/rpcx/rpcx-consul 的本地 replace;go list -m -json github.com/thkhxm/tgf/v2 有固定 Version,没有 Replace,也不是 workspace 主模块;go.work 可以存在,但不能 use 本地 tgf 源码或把 tgf 替换成本地目录。发现父目录 workspace 污染时,移动到该 workspace 之外重新生成或修正项目 workspace;不要把
GOWORK=off 写成所有项目的永久规则。
cmd/<process>/main.go 只做装配;多进程或多 module 项目使用 internal/api、internal/service、
internal/dao 分层。Startup() == (true, nil) 时才可被发现/本地分发;失败服务仍由框架清理。ServiceAPI 和指针 reply;客户端帧直达使用 rpc.Args[T] / rpc.Reply[T]。WithGatewayOptions,不与 deprecated WithGateway* 混用;网关端口与 rpcx 内部端口错开。config.Current() 读取;框架配置禁止散落 os.Getenv,否则热更新失效。_ = err、空错误分支和把上游敏感错误原样返回客户端。.env.dev、.env.test、.env.release、日志和可执行产物必须被 .gitignore 忽略;
只提交 .env.example,生产密钥走 Secret/环境注入。WithoutLoginCheck() 只允许明确的内网联调,生产禁止。redis-mysql 时使用 write-behind 失败队列和启动重放;外部 Redis/MySQL 未实际运行时,
只能报告“未验证”,不能当作通过。目录、编码、安全、数据与部署细则见 项目规范。
四个 profile 覆盖项目骨架;其余能力作为受测扩展加入,不能另起不一致模板。
| 场景 | 入口 |
|---|---|
| 单进程游戏服 | profile=single |
| 分布式 gateway + game | profile=distributed |
| HTTP REST | profile=http-rest |
| HTTP → RPC | profile=http-rpc |
| TCP / WebSocket / KCP | 游戏 profile 的 protocol |
| Redis / MySQL write-behind | data,并按项目规范接 DAO |
| Docker Compose / K8s | deploy |
| config reload / game config / logging / metrics+trace / RPC policy / robot / util / platform SDK | 先生成最近的 profile,再按 场景指南 和框架 example/ 加入 |
先保存基线,再执行:
go mod tidy
go test ./...
go build ./...
go vet ./...
tgfctl verify --dir .然后按 profile 做真实冒烟:HTTP 必须实际请求 /health 和业务路由;游戏服至少启动并验证端口/robot;
分布式、Redis/MySQL、Consul 只有在依赖真实启动后才能标记 integration 通过。验证优雅停机时,向进程发
SIGINT/SIGTERM,不要在业务代码重复注册信号。
失败时最多修复 3 轮。每轮记录失败命令、根因、修改和重跑结果;同一根因连续失败、缺凭据/外部服务、 需要扩大授权或第 3 轮仍失败时停止并明确报告,不伪造通过。
交付必须包含:精确 tgf 版本、生成参数、通过的命令、未运行的外部集成、运行方式和下一步扩展建议。
先用最小业务项目确认不是配置/API 误用。确认框架缺陷后收集 tgf/Go 版本、形态、最小复现、期望/实际、
脱敏日志;删除 token、密码、AEAD key、内网地址和真实玩家数据。只有用户授权且 gh auth status 可用时
才创建 issue,否则输出可复制的 issue 正文。
修改本 Skill 后必须同步仓库源与安装副本,并依次运行 skill-creator/quick_validate.py、
t-sys-skill/lint_skill.py、静态契约检查和外部 consumer 前向测试。
© thkhxm, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 7 other files (scripts, references) in .claude/skills/tgf-server-dev of thkhxm/tgf.
Open the folder on GitHubat commit ff52796
Tgf Server Dev 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Tgf Server Dev this skillthkhxm/tgf | 128 | — | ~1.3k | Automated safety check: Notes | MIT | |
| Cloudrun DevelopmentTencentCloudBase/CloudBase-AI-Toolkit | 1.1k | 1 repos | ~7.2k | Automated safety check: Pass | MIT | |
| Redis Test Image Updateredis/go-redis | 22k | — | ~1.5k | Automated safety check: Pass | BSD-2-Clause | |
| Supercheck Infrastructure Deploymentsupercheck-io/supercheck | 215 | — | ~1.4k | Automated safety check: Notes | AGPL-3.0 | |
| Project Referencesaiskillstore/marketplace | 430 | — | ~2.3k | Automated safety check: Notes | None | |
| GitHub Runnermagnus919/agent-skills | 113 | — | ~1.7k | Automated safety check: Pass | MIT |
TencentCloudBase/CloudBase-AI-Toolkit
CloudBase Run backend development rules (Function mode/Container mode).
redis/go-redis
Keeps every reference to the redislabs client-libs-test image tag in sync across the Makefile, compose file, GitHub workflows and docs when a Redis test version changes.
supercheck-io/supercheck
Work on Supercheck Docker Compose, K3s, Kubernetes manifests, gVisor, OpenTofu/Hetzner, secrets, external services, autoscaling, backups, disaster recovery, DNS/TLS, or production deployment.
aiskillstore/marketplace
Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/.
magnus919/agent-skills
Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.
chmonitor/chmonitor
Work on chmonitor's Cloud (SaaS) vs self-hosted (OSS) behaviour from ONE codebase.
Categories
基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。. Tgf Server Dev is an agent skill from thkhxm/tgf.
Tgf Server Dev fits situations like: tasks that involve Container orchestration; tasks that involve Realtime and WebSockets; tasks that involve Containers.
Run `npx skills add thkhxm/tgf --skill tgf-server-dev -a claude-code`. Or copy the skill folder (.claude/skills/tgf-server-dev in thkhxm/tgf) into .claude/skills/tgf-server-dev in your project. Claude Code loads it when a task matches its description.
Run `npx skills add thkhxm/tgf --skill tgf-server-dev -a codex`. Or copy the skill folder (.claude/skills/tgf-server-dev in thkhxm/tgf) into .agents/skills/tgf-server-dev in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thkhxm/tgf --skill tgf-server-dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tgf-server-dev, .gemini/skills/tgf-server-dev, .github/skills/tgf-server-dev and .opencode/skills/tgf-server-dev in your project.
Going by SKILL.md and its folder, Tgf Server Dev needs Python for the scripts in its folder and the command-line tools its instructions call (go and gh). Our summary lists: Python 3; Docker.
SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Tgf Server Dev is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.3k tokens (SKILL.md is roughly 5.1k 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 5.3k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Tgf Server Dev: Cloudrun Development (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars), Redis Test Image Update (redis/go-redis, 22k stars), Supercheck Infrastructure Deployment (supercheck-io/supercheck, 215 stars) and Project References (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
thkhxm (a GitHub user) maintains it in thkhxm/tgf, which has 128 GitHub stars. The repository was last updated on July 24, 2026.
Source: thkhxm/tgf on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.