前言¶

在存量项目里加页面、改需求、补组件时，常见问题是模型按「教科书写法」生成代码：组件库用法和仓库里不一致、目录层级对不上、命名和现有模块脱节。人工改风格往往比写功能还费时间。若你希望在对话里明确约束「和项目一致、不破坏原有规范」，下面介绍 SkillHub 社区 Skill「代码风格一致性 Skill」，它面向「生成代码必须与项目原有风格对齐」这一类任务。

这是什么¶

「代码风格一致性 Skill」是 SkillHub 上的社区 Skill（坐标 @user_3299e856/code-style-consistency，版本 1.0.0，分类 dev-programming）。发布者为 user_3299e856，来源标注为 community，标签 requires_api_key=false，安装与使用不依赖额外 API Key。

官方简介将其定位为：当用户需要在已有项目中新增功能、修改需求、添加组件、扩展页面，且要求生成代码与项目原有的代码风格、组件库使用方式、交互习惯、命名约定、文件结构保持一致时，应启用该 Skill。页面与 API 资料一致，无单独维护方说明 beyond 社区发布者。

核心功能¶

依据 SkillHub 公开说明，该 Skill 覆盖的能力边界可以概括为以下几类（均为官方表述的归纳，非额外承诺）：

1. 风格对齐：生成或修改的代码需贴合仓库既有写法，而非引入另一套风格。
2. 组件与交互：沿用项目中已有的组件库用法和交互习惯。
3. 结构与命名：文件组织、命名约定与现有代码保持一致。
4. 触发识别：通过中英文触发词让 Agent 在合适场景自动选用该 Skill（见下文列表）。

官方列出的触发词包括：保持代码风格、风格一致、和项目一致、不破坏原有规范、沿用现有组件、按照原来的写法、新增功能、新增页面、新增组件、修改需求、按照已有代码规范、仿照现有代码、代码规范统一、复刻项目风格、code style、style consistency、按原项目、以项目为准。英文说明为：This skill should be used when the user wants to generate code that must match the existing project’s coding style, component usage patterns, interaction conventions, and naming rules.

Skill 本身遵循通用 SKILL.md 格式；具体执行步骤以安装后包内 SKILL.md 为准，本文不展开未在公开页面出现的内部指令。

安装与启用¶

SkillHub 页面给出的安装方式是：让 AI 按官方安装文档处理，或直接通过 SkillHub CLI 安装到当前 Agent 的 skills 目录。

方式一：提示词交给 AI¶

将下面意图发给支持 Skill 的 Agent（与 SkillHub 页面原文一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3299e856/code-style-consistency`。

方式二：SkillHub CLI¶

先确认是否已安装 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（示例为官方推荐命令）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。常用路径示例（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

以 Cursor 为例，安装命令形如：

skillhub install @user_3299e856/code-style-consistency --dir ~/.cursor/skills/

也可先搜索再安装：

skillhub search code-style-consistency
skillhub install @user_3299e856/code-style-consistency --dir ~/.cursor/skills/

安装后若 Agent 未立刻加载新 Skill，按你所用客户端的说明重启或刷新会话。不同客户端目录不同，以你当前环境为准替换 --dir。

典型用法¶

公开资料未提供独立「教程仓库」或固定代码片段；可复现的用法主要来自场景描述与触发词。

1. 在已打开目标仓库的会话中安装并启用该 Skill（见上一节）。
2. 用自然语言说明要做的改动，并带上官方触发词，例如：「在现有用户列表页旁新增一个筛选面板，风格一致，沿用现有组件，按原项目目录放文件。」
3. 在需求里点明要对齐的维度（组件库、交互、命名、目录），便于与 Skill 简介中的约束一致。
4. 生成后仍建议按团队规范做 code review；Skill 约束的是 Agent 侧意图，不能替代项目的 lint、测试与合并流程。

适用场景与注意¶

适合谁

• 长期在单一或多模块存量仓库里做增量开发，且规范主要靠「看现有代码」传承的团队。
• 使用 Cursor、Claude Code、Codex 等支持 SkillHub Skills 的 Agent，并愿意把「风格一致」写成对话里的显式约束。

限制与注意

• 社区来源（community），质量与更新节奏依赖发布者；使用前可在 SkillHub 页面查看版本与说明。
• 公开统计（以 API 抓取为准）：评分 100000，下载 1810；页面展示版本 v1.0.0。数据会随时间变化，以 SkillHub 实时页面为准。
• 该 Skill 解决的是「生成侧对齐意图」，不能替代你在项目里已有的 ESLint、Stylelint、架构文档或设计系统说明；复杂规范仍建议在仓库内保留可检索的范例文件，并在提示中 @ 引用相关路径。
• 若 CLI 安装失败，按 SkillHub 安装与优先源配置 检查网络与 --dir 是否指向正确 skills 目录。

结尾¶

「代码风格一致性 Skill」把「新增功能也要像原团队写的」收敛成可安装的 Agent 能力，通过触发词和 SKILL.md 约束生成行为，适合在 SkillHub 上按需拉取、装进 Cursor 等环境的 skills 目录。官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_3299e856/code-style-consistency
• API 资料：https://api.skillhub.cn/user_3299e856/code-style-consistency