关于 new-skill
面向 brooks-lint 的仓库专用技能,用于新增技能。它指导维护者创建技能与指南文件、接入共享资源、添加评测场景并测试结果。
主要功能
- 01创建技能脚手架和编号指南
- 02规定元数据与流程结构
- 03接入相关共享文件
- 04添加正例和误报评测
- 05验证结构并进行本地测试
适用场景
- 01根据指定用途创建仓库技能
- 02为新技能添加评测覆盖
- 03在本地检查技能结构与行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hyhmrright/ brooks-lint --skill new-skill安装后在 Claude Code 中输入/new-skill确认已加载。
附带文件agents/openai.yaml
详细介绍
brooks-lint — 新建技能脚手架
技能名称取自用户请求(kebab-case,例如 brooks-security)。如果为空,
先询问名称和一句话用途。
严格遵循仓库的“添加新技能”检查清单:
- 创建
skills/{name}/SKILL.md并添加 frontmatter —name、以Do NOT trigger for:子句结尾的description(已发布技能的验证会强制检查此项;省略会导致误触发)、包含opencode/slash: "true"的metadata:,以及包含 3–6 个 项目的Process部分,并在行内注明指南的步骤范围(例如扫描风险(指南中的步骤 1–6))。参照现有技能(例如skills/brooks-review/SKILL.md)的结构(Setup → Process → Mode 行)。 - 创建
skills/{name}/{name}-guide.md,步骤按顺序编号 — 不得跳号或重复。允许使用Step 2a之类的子步骤。指南负责详细步骤;SKILL.md 的 Process 只是概览框架。 - 接入框架。 新 SKILL.md 的 Setup 部分必须读取相关的
_shared/文件(Iron Law + Report Template 对应common.md,并按需读取decay-risks.md/test-decay-risks.md)—_shared/不会 自动加载。 - 添加 eval 覆盖到
evals/evals.json:追加至少一个包含下一个连续id的正常场景(在expected_output中包含相关风险代码),以及至少一个标记为no_risk_codes: true的误报场景。每个场景都需要包含id、name、prompt、expected_output、mode、files。 - 验证。 运行
npm run validate(结构 + 步骤连续性 + Process 部分 是否存在)和npm run evals(eval 架构)。修复问题,直到两项都通过。 - 本地测试。 将新的技能文件夹从
skills/链接到.agents/skills/,与_shared符号链接放在一起,然后在 Codex 会话中通过$<skill-name>调用它,并验证 Iron Law 输出。
Codex 可直接发现仓库技能;无需命令包装器。 报告创建的文件以及 validate/evals 的结果。
评论
支持 Markdown