openclaw/agent-skills

# OpenClaw Agent Skills  供在 OpenClaw 项目中工作的编程 Agent 使用的共享技能。 本仓库是常见工作流（例如 review closeout 和远程验证）的公开规范源。目标很简单：编写一次工作流， 到处复用，并避免在每个 仓库中手动复制冗长的 `SKILL.md` 文件。有关目录边界和准入原则，请参阅 [VISION.md](VISION.md)。 ## 包含的技能 - `agent-transcript`：仅限本地、经过脱敏处理的 PR/issue 对话记录溯源。 - `autoreview`：结构化的 closeout/code-review 工作流及辅助脚本。 - `behavior-validator`：根据 contract 对用户可见的行为进行源码无关的验证。 - `crabbox`：用于广泛或 CI-parity 验证的 Crabbox/Testbox 远程验证工作流。 - `handoff`：用于将任务委派给另一个 agent 的无路径 prompt 交接工作流。 - `session-viewer`：用于 agent session JSONL 的本地可搜索 HTML 查看器。 特定于仓库的产品技能应保留在它们所描述的仓库中。例如， `acpx` 使用技能应属于 `openclaw/acpx`；而通用的 review 辅助工具应放在 这里。 ## 快速开始 克隆仓库： ``` git clone https://github.com/openclaw/agent-skills.git cd agent-skills ``` 列出可用技能： ``` scripts/install-skills --list ``` 预览安装而不更改文件： ``` scripts/install-skills --dry-run ``` 将所有技能安装到默认的 agent 技能目录中： ``` scripts/install-skills ``` 仅安装选定的技能： ``` scripts/install-skills autoreview crabbox ``` 安装到其他位置： ``` scripts/install-skills --target ~/.codex/skills autoreview ``` 使用副本代替 symlinks： ``` scripts/install-skills --mode copy --target ~/.agents/skills ``` 替换已安装的现有技能： ``` scripts/install-skills --force autoreview ``` Symlinks 最适合本地开发，因为此检出版本中的更改会 立即可见。副本更适合便携或锁定的环境。 ## Codex 与 Claude 对于 Codex，请将此仓库 symlink 到 `~/.codex/skills`： ``` mkdir -p ~/.codex/skills ln -sfn "$(pwd)/skills" ~/.codex/skills/agent-skills ``` 对于 Claude Code，请将此仓库 symlink 到 `~/.claude/skills`： ``` mkdir -p ~/.claude ln -sfn "$(pwd)/skills" ~/.claude/skills ``` 如果 `~/.claude/skills` 已经指向另一个共享技能文件夹，请改为 在该文件夹内添加 symlinks： ``` ln -sfn "$(pwd)/skills/autoreview" /path/to/shared-skills/autoreview ln -sfn "$(pwd)/skills/crabbox" /path/to/shared-skills/crabbox ``` 推荐用于仓库 `AGENTS.md` 文件的单行命令： ``` Shared agent workflows: install or symlink https://github.com/openclaw/agent-skills for `autoreview`, `crabbox`, and other common skills; do not vendor shared skills here unless this repo intentionally needs a zero-setup snapshot. ``` ## 零设置仓库 该快照是一个分发产物，而不是事实来源： - 首先在此处编辑规范技能 - 在 review 后将快照同步到下游 - 保持下游副本数量少 - 当仓库引入快照时，添加溯源和偏移检查 `autoreview` 是旗舰仓库中进行零设置快照的良好候选者， 因为 review closeout 是贡献工作流的一部分。大型运营 技能应仅在仓库确实需要在不经过设置的情况下使用它们时才被引入。 ## 仓库布局 ``` skills/ agent-transcript/ SKILL.md scripts/ autoreview/ SKILL.md scripts/ behavior-validator/ SKILL.md references/ crabbox/ SKILL.md handoff/ SKILL.md session-viewer/ SKILL.md scripts/ scripts/ install-skills validate-skills ``` 每个技能都位于 `skills//` 中，并且必须包含 `SKILL.md`。辅助脚本 属于该技能的 `scripts/` 目录。 ## 验证 编辑后运行此命令： ``` python3 -m venv .venv . .venv/bin/activate python -m pip install -r requirements-dev.txt scripts/validate-skills python3 -m py_compile scripts/install-skills scripts/install-skills.test.py scripts/validate-skills scripts/validate-skills.test.py python3 scripts/install-skills.test.py python3 scripts/validate-skills.test.py bash -n skills/autoreview/scripts/test-review-harness python3 -m py_compile skills/autoreview/scripts/autoreview skills/autoreview/scripts/test-review-harness.py skills/autoreview/scripts/autoreview_test.py python3 skills/autoreview/scripts/autoreview --self-test-config-defaults python3 skills/autoreview/scripts/autoreview --self-test-fallback-scope python3 skills/autoreview/scripts/autoreview --self-test-engine-isolation python3 skills/autoreview/scripts/autoreview --self-test-json-array-parser python3 skills/autoreview/scripts/autoreview --self-test-opencode-jsonl-parser python3 skills/autoreview/scripts/autoreview --self-test-opencode-isolation python3 skills/autoreview/scripts/autoreview --self-test-cursor-jsonl-parser python3 -m unittest skills/autoreview/scripts/autoreview_test.py skills.autoreview.tests.test_autoreview_hardening node --check skills/agent-transcript/scripts/agent-transcript node --test skills/agent-transcript/scripts/agent-transcript.test.mjs skills/session-viewer/scripts/session-viewer.test.ts ``` 验证器会检查每个 `skills/*/SKILL.md` 是否包含 YAML frontmatter 以及必需的 `name` 和 `description`。 Session 导出可能包含敏感的对话数据。请将 `session-viewer` HTML 视为本地/私有输出，除非它已被单独脱敏并经过审查。 ## 编辑规则 - 保持描述简短且对路由有用。 - 保持技能正文具有可操作性，而不是像文章一样。 - 不要包含密钥、私有主机名、私有账户 ID 或私有 URL。 - 对于可重复的命令逻辑，首选辅助脚本。 - 不要手动更新引入的下游快照。更新此仓库，然后 同步。 ## License MIT。

标签：Cutter, MITM代理, 逆向工具