




















英文上游 superpowers 解决的是通用 AI 编程工作流问题,但中文团队还有一些额外痛点:
superpowers-zh 新增的中国特色 Skills 正是为这些场景设计。
这个 Skill 的核心原则是:用「建议」代替「命令」,用「提问」代替「否定」,但绝不因为面子放过 Bug。
推荐使用优先级标记:
示例:
[必须修复] 并发安全问题
这里的 map 会在多个 goroutine 中同时读写,可能触发 panic。
建议加 sync.RWMutex,或改用 sync.Map。可以用 -race 跑测试复现。
这种表达既清楚说明严重性,又给出原因和建议。
需要避免两个极端:
不知道我理解得对不对,这里好像可能有一点点问题……
这种写法会让作者不知道是否必须修。
这里写错了,必须改。
这种写法虽然直接,但容易引发防御心理。
推荐写法:
[建议修改] 这里可能存在空值风险。
如果 user.Profile 为 nil,第 42 行会 panic。建议在进入分支前做空值判断,或在查询层保证 Profile 必填。
该 Skill 对比了 Gitee、Coding.net、极狐 GitLab、CNB 和 GitHub,并给出不同团队规模适用的工作流。
适合 2-8 人小团队、自动化测试完善、迭代快:
适合中大团队、固定发布节奏、需要多版本维护:
适合多数中小团队:
推荐:
feat/user-login
feat/TAPD-12345-order-refund
fix/payment-callback
hotfix/v2.0.1
release/v2.1.0
dev/zhangsan/feat-login
规则:
feat/、fix/、hotfix/、release/。该 Skill 基于 Conventional Commits 1.0.0,保留英文 type,scope 和 description 使用中文。
格式:
<type>(<scope>): <subject>
<body>
<footer>
示例:
feat(用户模块): 添加手机号一键登录功能
- 接入运营商一键登录 SDK
- 支持移动、联通、电信三网
- 登录失败自动降级到短信验证码
Closes #128
常用类型:
| type | 含义 |
|---|---|
feat |
新功能 |
fix |
Bug 修复 |
docs |
文档 |
style |
格式,不影响逻辑 |
refactor |
重构 |
perf |
性能优化 |
test |
测试 |
chore |
工具、依赖、杂项 |
ci |
CI/CD |
revert |
回滚 |
团队可以用 commitlint + husky 强制规范:
npm install -D @commitlint/cli @commitlint/config-conventional husky
关键配置思路:
subject-case。规范要靠工具,而不是靠每个人自觉。
这个 Skill 解决中文技术文档最常见的问题:
核心规则:
使用 Git 管理代码,配合 Jenkins 实现持续集成。
本次更新包含 3 个功能和 12 个 Bug 修复。
文件大小不超过 5 MB,CPU 使用率低于 80%。
中文语境使用全角标点,代码、命令和纯英文内容使用半角标点。
保留英文:
npm install、git commit。翻译中文:
首次出现可写中英对照:
本系统使用消息队列(Message Queue)实现异步通信。
好的中文技术文档应结构化:
# 标题
## 背景
说明为什么需要这篇文档。
## 快速开始
给出最短可运行路径。
## 核心概念
解释读者必须理解的模型。
## 操作步骤
按步骤说明如何使用。
## 常见问题
列出错误、原因和解决方式。
## 检查清单
提供发布或交付前自查项。
不要用长段落堆叠所有信息。能用列表、表格、步骤和代码块表达的内容,应优先结构化。
推荐按以下顺序落地:
中国特色 Skills 不是把英文规则翻译成中文,而是把中文团队真实协作环境纳入 AI 编程流程。它们能让 superpowers-zh 从个人效率工具变成团队工程规范的一部分。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。