前言¶
让 AI 直接改代码时，常见结果是：补丁叠补丁、风格与仓库不一致、安全问题在 diff 里悄悄混进来，交付前也没有固定自查步骤。单靠对话里的口头提醒，很难在每次「写代码、修 bug、加功能、重构」时都走同一套流程。
下面介绍 SkillHub 上的社区 Skill「软件开发规范与代码质量守卫」（坐标 @user_9608010a/dev-discipline）。它在产生代码输出的开发任务里被激活，用 SKILL.md 约束 Agent：先分析根因、设计方案并经用户确认后再写码，并覆盖安全基线、数据完整性与协作规范。
这是什么¶
软件开发规范与代码质量守卫是面向开发类请求的规范型 Skill，当前版本 v1.0.4，来源为 community，发布者为 user_9608010a，分类 dev-programming。页面标注 requires_api_key=false，安装与使用不依赖额外 API Key。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_9608010a/dev-discipline
- API 坐标页：https://api.skillhub.cn/user_9608010a/dev-discipline
它解决的是「开发任务触发后流程不可控」的问题：把根因分析、方案确认、重构优先、风格一致与完成前自查写成强制工作流，而不是每次临时口头约定。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面描述，无额外推断。
激活条件¶
当用户要求开发、修复、重构或修改任何代码时激活。常见触发表述包括：写代码、修 bug、加功能、重构，以及任何会产生代码输出的开发任务。
强制工作流¶
- 先分析根因，再动手改代码。
- 设计方案，在用户确认之后再写码。
- 重构优于打补丁：倾向从结构上解决问题，而不是局部堆叠修复。
- 保持代码风格一致：与当前仓库既有约定对齐。
- 完成前进行自查：交付前做规范内的自检。
规范范围¶
简介中明确涵盖三类基线：
- 安全基线
- 数据完整性
- 协作规范
Skill 本体遵循通用 SKILL.md 格式，由支持 Skills 的 Agent 读取后注入行为约束。
安装与启用¶
方式一：通过 SkillHub CLI 安装¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 官方安装文档执行（完整安装或仅 CLI）：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录；否则默认装到 ./skills/，Agent 可能无法识别。官方文档给出的常用路径如下：
| 环境 | Skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令示例（将 <skills 目录> 换成上表对应路径）：
skillhub install @user_9608010a/dev-discipline --dir <skills 目录>
更完整的 CLI 与优先源说明见：https://skillhub.cn/install/skillhub.md
方式二：让 AI 按官方提示安装¶
SkillHub 页面提供的安装提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_9608010a/dev-discipline`。
将上述内容发给当前 Agent，由其按文档完成 CLI 检查、目录选择与安装。
安装后若 Agent 未立即加载新 Skill，按你所用客户端的惯例重启或重新打开会话（以各客户端文档为准）。
典型用法¶
本 Skill 不绑定单一脚本命令，价值在于开发类对话中的默认流程。核实到的用法要点如下。
- 在已安装 Skill 的 Agent 中发起开发请求，例如修复缺陷、新增功能或重构模块。
- Agent 应在写码前说明根因与方案，并等待你确认后再改文件。
- 实现阶段遵循仓库既有风格；收尾时按 Skill 要求做自查，并兼顾安全与数据完整性。
若需验证 Skill 是否生效，可用一次小范围任务（如「修一个明确 bug」）观察是否出现「先方案、后确认、再写码」的步骤，而不是直接输出大段 diff。
适用场景与注意¶
适合谁
- 经常用 Cursor、Claude Code、Codex 等带 Skills 能力的客户端做日常开发的人。
- 希望团队或个人在 AI 辅助编码时，统一「分析 → 方案 → 确认 → 实现 → 自查」节奏的场景。
限制与注意
- 行为约束依赖 Agent 对 SKILL.md 的遵守，不能替代人工 Code Review 或 CI。
- 社区来源（community），规则细节以安装包内 SKILL.md 为准；升级时注意版本（当前页面为 v1.0.4）。
- SkillHub 抓取数据与页面展示可能存在统计差异；以 SkillHub 页面为准时，评分为 100000，下载 1744（截至资料抓取时）。
结尾¶
「软件开发规范与代码质量守卫」把开发类请求从「直接出码」拉回到可核对的工作流：根因、方案、确认、一致风格与交付前自查，并覆盖安全与数据完整性。若你希望在每次写码、修 bug、加功能或重构时默认走这套流程，可从 SkillHub 安装 @user_9608010a/dev-discipline。
官方地址：https://www.skillhub.cn/skills/user_9608010a/dev-discipline
