关于 ns-skill-creator
ns-skill-creator 将上游 skill-creator 工作流用于已配置 harness 的项目技能创建与改进。它把文件保存到 `.agents/skills/`，并在重要更新后运行 `harness sync`。
主要功能
- 01创建和编辑项目本地技能
- 02采用上游 skill-creator 工作流
- 03将技能保存在 `.agents/skills/`
- 04整理参考资料、脚本和评估文件
- 05更新后运行 `harness sync`
适用场景
- 01为配置了 harness 的项目添加技能
- 02改进现有项目技能
- 03更改后更新 Claude 技能符号链接
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/ns-skill-creator确认已加载。
附带文件evals/evals.jsonreferences/project-layout.md
详细介绍
技能创建器（harness 项目）
在当前 harness 项目中创建和改进项目本地技能。评测循环、描述优化和捆绑脚本来自上游 skill-creator（anthropics/skills）——此技能仅覆盖文件的保存位置，并在每次创建/更新后运行 harness sync。
Harness 发现
按照 ../ns-harness/references/harness-discovery.md 解析路径：
| 变量 | 值 |
|---|---|
{product_root} | 仓库或单仓库中的产品文件夹（AGENTS.md 所在位置） |
{skills_canonical} | {product_root}/.agents/skills/ |
如果缺少 {harness_root}，请告知用户先运行 npx @nextstage-brasil/harness——此技能要求项目已通过 harness 初始化。
步骤 0 — 加载上游 skill-creator
Harness 初始化会将 anthropics skill-creator 套件（脚本、eval-viewer）安装到 {skills_canonical}/skill-creator/，然后将此包装器安装为 ns-skill-creator。
如需完整的上游工作流，请阅读：
- 全局安装时的
~/.agents/skills/skill-creator/SKILL.md，或 - anthropics/skills — skill-creator
上游内容用于：意图捕捉、访谈、SKILL.md 结构、评测/基准测试循环、eval-viewer/generate_review.py、描述优化（run_loop.py），以及 {skills_canonical}/skill-creator/scripts/ 下的脚本。
在遵循上游说明的基础上，应用下文的路径覆盖和创建后同步要求。
路径覆盖（项目）
| 工件 | 路径 | 说明 |
|---|---|---|
| 新建/编辑的技能 | {skills_canonical}/<kebab-case-name>/ | frontmatter 中的 name 必须与目录名一致 |
SKILL.md | {skills_canonical}/<name>/SKILL.md | 使用英文，除非团队在 AGENTS.md 中另有规定 |
references/、scripts/、evals/ | 技能目录下 | 参见 references/project-layout.md |
| 评测工作区 | {product_root}/skill-creator-workspace/ | 按照上游约定使用 iteration-N/eval-<id>/ |
| 上游工具 | {skills_canonical}/ns-skill-creator/ | anthropics 套件中的 scripts/、eval-viewer/ |
绝不要将项目技能保存到仓库根目录下的 skills/（这种布局仅适用于 nextstage-brasil/skills 目录仓库）。
项目约定
起草时请阅读 references/project-layout.md。如果 {product_root}/AGENTS.md 规定了语言或技能约定，请遵循。
摘要：
- 按照上游指南，在 frontmatter 中使用有明确触发导向的
description。 - 将
SKILL.md控制在约 500 行以内；详细内容移至references/。 evals/evals.json— 当评测有帮助时，添加 2–3 个真实的提示词。- 仅当技能引用其他已安装技能（例如
ns-harness）时，才在 frontmatter 中声明depends:。
工作流
遵循上游 ns-skill-creator 阶段（捕捉意图 → 起草 → 评测 → 改进 → 重复）。每次写入时，都使用上述路径覆盖。
创建后 — harness 同步
写入或实质性更新技能文件后，在 {product_root} 中运行：
npx @nextstage-brasil/harness sync
此操作会重新生成 Claude 技能符号链接（.claude/skills/），让 Claude Code 能发现新技能。Cursor 会直接读取 .agents/skills/。
编辑规范规则后，在本地使用 npx @nextstage-brasil/harness sync --check，以验证磁盘上的适配器与提交前的状态一致，再提交 .nextstage-harness/ 更改。
向用户报告同步结果。同步成功完成前，不要声称该技能可被发现。
描述优化
技能稳定后，按照上游 ns-skill-creator（run_loop.py）提供描述优化。使用当前会话中的模型 ID。更新 {skills_canonical}/<name>/SKILL.md frontmatter，然后按需运行 harness sync。