通用技能使用

Nexus 除 spec-* 工作流外，还提供一组面向具体任务的技能。它们适合处理启动工程、新建模块、补充翻译、扩展主题、安全检查和构建镜像等边界清晰的工作。

本页同时面向产品经理和开发人员。产品经理可以直接复制示例，把业务目标交给 AI，再按“验收重点”确认结果；开发人员可以继续查看命令、文件位置和技术边界。你不需要先学会编程，才可以使用这些技能。

这些技能的说明文件位于 Nexus 工程的 .claude/skills/<技能名>/SKILL.md。AI 会根据说明检查条件、修改工程并验证结果，最终结果由发起任务的人验收。

先认识几个词

名词	通俗解释
Agent	能读取和修改整个工程、执行命令并反馈结果的 AI 编程助手
Skill（技能）	给 Agent 的标准操作手册，用来约束它按固定流程完成一类任务
项目根目录	Nexus 工程最外层目录，可以看到 package.json、app/、server/ 等内容
Provider	提供 AI 模型服务的厂商或平台，例如 DeepSeek、OpenAI
镜像	打包好的 Nexus 运行环境，可交给服务器直接启动
数据库迁移	记录数据库表结构变化的文件，让新旧环境保持一致

如何调用技能

Claude Code

在 Nexus 项目根目录启动 Claude Code，然后输入斜杠命令。命令名与 .claude/skills/ 下的目录名一致：

/quick-start

需要补充参数或业务要求时，直接写在命令后面：

/new-module 新建一个“活动报名”模块，需要报名表单、报名记录和后台导出功能

Codex、Trae 和 GitHub Copilot

由技术人员先按照开发工具链完成一次技能接入。接入后，产品经理和开发人员都可以用自然语言明确指定技能名和任务：

请使用 new-module 技能，新建一个活动报名模块，需要报名表单、报名记录和后台导出功能。

如果当前 Agent 不支持自动发现技能，应让它先读取对应的 SKILL.md：

请先读取 .claude/skills/security-scan/SKILL.md，再按其中流程扫描当前工程，只输出报告，不自动修复。

技能不是普通的 shell 命令。/quick-start 等写法用于触发 Agent，真正执行哪些命令由技能说明和当前工程状态决定。

技能速查

技能	你能用它完成什么	最直观的验收结果
quick-start	第一次在本地打开 Nexus	浏览器可以访问首页和管理后台
new-module	用业务描述开发一个独立功能	页面可以操作，数据能够保存，测试通过
i18n-translate	为已有中文功能补英文	切换英文后文案完整、布局正常
theme-extend	新增品牌主题或参考网站配色	可以切换新主题，亮色和暗色都清晰
models-update	在后台增加新的 AI 厂商或模型选项	模型出现在正确的厂商下且配置可保存
security-scan	提交或发布前检查常见风险	得到按风险等级整理的检查报告
build-image	把当前版本打包给服务器部署	本地生成名称和版本正确的 Docker 镜像
migration-baseline	正式发布前整理开发期数据库变更记录	新数据库和已有数据库都能正常升级

快速启动工程

使用 quick-start 把“拿到源代码”推进到“浏览器可以访问”。它会检查本机开发环境、工程配置和数据库连接，然后启动 Nexus。

/quick-start

需要验证生产构建时：

/quick-start --mode=prod

你需要提供：可用的数据库地址，以及 .env 中需要填写的账号、域名和密钥。不了解某个配置时，可以要求 Agent 解释它的用途，但不要把真实密码或密钥发到公开对话中。

验收重点：浏览器可以打开首页和管理后台，并能使用管理员账号登录。执行过程中如果数据库不可访问或端口 3000 被占用，技能会报告问题并停止，不会自行结束其他程序。

新建业务模块

使用 new-module 从一句业务描述开始开发新功能。为了减少返工，Agent 会先询问功能给谁使用、解决什么问题、包含哪些页面，以及是否涉及积分或 AI 能力；确认设计摘要后才会实施。

/new-module 新建“简历诊断”模块。用户上传简历后使用 AI 给出评分和改进建议，每次分析扣除 20 积分，并保留历史记录。

产品经理需要提供：目标用户、核心使用流程、必须包含和明确不做的功能、计费方式，以及可判断成功的验收标准。

验收重点：从真实用户视角走完一次完整流程，例如“上传简历 → 扣除积分 → 得到结果 → 在历史记录中再次打开”。同时检查异常提示、空数据状态和移动端显示。

开发人员可进一步核对以下技术产出：

• modules/resume-review/ 下的页面、API、迁移和中英文语言包；
• config/modules.ts 中的模块注册；
• OpenAPI 接口登记、结构测试和功能测试；
• .oms/ 下的规格、验收标准和归档记录。

首次对话中先回答 Agent 的范围确认问题。不要在设计摘要尚未确认时要求它跳过规划直接生成代码。

为已有功能补充英文

使用 i18n-translate 为已有功能补充英文版。它会找出没有翻译的中文、缺失的英文内容和仍按中文显示的日期，再逐项补齐。

/i18n-translate 为最近新增的线索管理和活动报名功能补充英文版

也可以限定范围：

请使用 i18n-translate 技能，只处理 modules/event-registration 和对应的公共组件，完成后切换到英文界面检查按钮及表格是否溢出。

你需要提供：要翻译的功能范围，以及产品名、业务专有名词是否需要保留原文。

验收重点：切换英文后逐页操作，确认没有遗漏中文，按钮、表格和弹窗没有因为英文较长而挤压或溢出。技能不会翻译商品名、用户输入、网址和第三方协议参数。

扩展站点主题

使用 theme-extend 新增一套可切换的品牌外观。可以提供品牌主色，也可以给出参考网站，让 Agent 分析其配色关系。

按主色创建：

/theme-extend 新增 ocean-green 主题，品牌主色使用 #0F766E，整体清爽克制，同时支持暗色模式。

参考网站创建：

/theme-extend 参考 https://example.com 的配色气质创建主题，只复刻颜色关系，不复制布局和字体。

你需要提供：品牌主色、希望呈现的气质、参考网站，以及是否必须支持暗色模式。参考网站只用于理解配色，不会复制对方的布局和品牌元素。

验收重点：分别查看首页、表单、表格、弹窗和错误提示，确认亮色与暗色模式都清晰，默认主题也没有受到影响。开发人员可核对 app/themes/<name>/ 主题包、自动生成的主题注册表和 useTheme.ts 的运行结果。

更新 AI 模型注册表

使用 models-update 在 Nexus 的 AI 配置中增加新模型，或者接入新的模型服务厂商。最好提供官方文档地址和准确的模型编码，避免模型名称或能力已经过时。

/models-update 为 deepseek 增加 deepseek-chat 和 deepseek-reasoner，能力均为 text。请以官方文档 https://api-docs.deepseek.com/ 为准。

新增 Provider 时应尽量提供协议和接口地址：

请使用 models-update 技能新增 example-ai Provider：协议为 openai-compatible，Base URL 为 https://api.example.com/v1，并注册 example-chat 模型。

你需要提供：厂商名称、模型编码、模型用于文本/图片/视频中的哪一种，以及官方文档地址。新增厂商时还需要提供接口地址和兼容协议。

验收重点：管理后台能在正确的厂商下看到模型，保存配置后能够完成一次真实调用。该技能只增加模型注册信息；如果厂商使用特殊协议，仍需要单独开发接入代码。

运行安全扫描

使用 security-scan 在提交或发布前检查常见风险，例如密码或密钥被写入代码、数据库查询存在攻击风险、敏感配置被误提交等。

/security-scan

只检查某次改动时，可以明确扫描范围：

请使用 security-scan 技能检查当前未提交的改动，按高、中、低严重度输出文件位置、判断依据和修复建议，先不要修改代码。

验收重点：报告应说明风险等级、文件位置、为什么有风险以及怎样修复。扫描命中不一定都是真实漏洞，Agent 会排除示例和已知设计后再形成报告；涉及密钥和数据库的高风险结果必须由开发人员复核。

构建生产镜像

使用 build-image 把当前 Nexus 版本及运行环境打包成一个 Docker 镜像，之后可以把同一份镜像部署到测试或生产服务器。

构建默认标签：

/build-image

指定版本标签：

/build-image v1.4.0

明确要求推送时：

/build-image v1.4.0 --push

你需要提供：版本号，以及是否需要推送到镜像仓库。只有明确要求 --push 时才应上传镜像。

验收重点：Agent 应报告完整镜像名称、版本标签、架构、镜像 ID 和大小。不带 --push 时只在本机构建。该技能只负责打包，不会自动发布到服务器或修改生产数据库。

重新生成数据库迁移基线

migration-baseline 用于正式版本发布前，整理开发过程中多次修改数据库留下的变更记录。它会删除并重建迁移文件，属于高风险维护操作，不适合日常功能开发。

/migration-baseline 在 v1.0.0 发布前整理主应用迁移。先检查工作区、现有 journal 和 seed，列出执行计划，确认后再修改。

产品经理不需要理解 journal、when 等数据库内部细节，但必须确认“已有数据不能丢失”和“升级失败可以恢复”。具体执行应由熟悉数据库的开发人员复核。

使用前必须满足：

• 当前分支已经提交，工作区干净且可通过 Git 回退；
• server/database/schema.ts 包含最终完整结构；
• 已记录旧迁移中最小的 journal when；
• 已准备临时全新数据库和存量数据库用于双重验证。

验收重点：用一个全新数据库验证首次安装，再用一个包含历史数据的数据库副本验证升级；两种情况都应正常启动，原有数据完整。基线生成后，开发人员不能继续修改已经发布的 0000_*.sql，后续变化必须创建新的迁移文件。

组合使用示例

通用技能可以与 Spec 工作流配合，但每个技能仍只负责自己的任务边界。例如开发并交付一个新模块时，可以这样安排：

1. /quick-start
2. /new-module 新建“活动报名”模块，需要报名表单、记录管理和 CSV 导出
3. /i18n-translate 检查活动报名模块的中英文完整性
4. /security-scan 检查本次模块改动，只输出报告
5. /build-image v1.2.0

若需求不属于这些专用技能，或会同时改变多个核心领域，应使用 Spec 工作流完成规划、实施、测试和评审。