Imported from vitoliu93/harness-dev-plugins (
AGENTS.md). Install upstream withnpx skills add vitoliu93/harness-dev-plugins. Copyright stays with the author.
项目规则
本仓库为 Claude Code 和 Codex 提供同一套插件与技能。AGENTS.md 是唯一的项目规则文件，CLAUDE.md 只写一行 @AGENTS.md 把它引入，不要复制成两份内容。
配置目录
- Claude Code：
$HOME/.claude - Codex：
$HOME/.codex - Cursor：
$HOME/.cursor
技能设计原则
- 模型本身已经很强。写技能时相信它的能力，只写它自己想不到的关键点。
- 技能要轻。优先只放一个
SKILL.md；不做模板，不列清单式规范，不写多种模式。description一两句话说清用途和什么时候用。 - 迭代先做减法。能删的先删，合并优于新增。
- 参照
skills/use-html这种一个短文件的写法。
双端兼容
-
skills/是 Claude Code 和 Codex 共用的唯一技能来源。不要为两个客户端复制SKILL.md。 -
技能需要运行自带脚本或读取自带文件时，使用有名称的
*_SKILL_DIR。模型根据已载入的SKILL.md路径填写绝对路径，并在同一次 shell 调用中赋值和使用：EXAMPLE_SKILL_DIR="<absolute path of the directory containing the loaded SKILL.md>"; bun "$EXAMPLE_SKILL_DIR/scripts/example.ts" -
不要在有效技能文档和引用文件中使用
${CLAUDE_SKILL_DIR}或${CLAUDE_PLUGIN_ROOT}。 -
hook 需要插件根目录时，使用
PLUGIN_DIR="${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}";，同时支持两端传入的变量。 -
客户端单独设置放在各自文件中，不要拆分共用技能：Claude Code 使用
.claude-plugin/plugin.json，Codex 使用.codex-plugin/plugin.json和可选的skills/*/agents/openai.yaml。 -
根目录
agents/只供 Claude Code 使用。可复用的做法必须放进skills/。 -
新建或修改技能时，必须检查 Claude Code 和 Codex 都能载入技能，并至少运行一个有脚本的技能来确认路径有效。
-
两端取文件的地方不一样。Claude Code 的 marketplace source 是
./，CLAUDE_PLUGIN_ROOT直接指向本仓库，所以这里没提交的改动在本机每个 Claude Code 会话里都是生效的；Codex 装到~/.codex/plugins/cache/。不要在正在使用 dev-kit 的 Codex 会话里运行codex plugin add dev-kit@vito-agents：更新会删掉该会话已载入的旧版本目录，余下 hook 会找不到脚本。先结束会话，再从另一个终端更新并开新会话。调试 hook 时先确认执行的是哪一份文件，别改缓存里的脚本。
检查
修改 skills/*/ 后，提交前运行：
bun test
bun skills/skill-forge/scripts/skill_style.ts --workspace-root skills --fail-on-issues
bun skills/skill-forge/scripts/build_skill_atlas.ts --workspace-root skills --fail-on-style
claude plugin validate --strict .
uv run --with pyyaml python "$HOME/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py" .如果一条 && 命令中的前一项失败，后面的命令不会执行。修好后要分别重跑。
发布
- 代码改完、
## 检查里的命令全部通过后，直接 commit 并 push 到 origin/main，不用等用户再单独说一次。 - 每次发布都把
.claude-plugin/plugin.json、.claude-plugin/marketplace.json和.codex-plugin/plugin.json改成同一版本，再提交和推送。否则客户端可能无法发现更新。 skills/只通过插件分发，不要在~/.agents/skills创建软链接。vito-agentsmarketplace 只托管dev-kit。study-kit已在 2026-07-28 合入本仓库，不需要跨仓库同步。- 本仓库公开。技能示例引用真实会话时，函数名、工单号、模块名和人名必须改成虚构内容，只保留示例结构。