dcsunny
2.8 KiB
2.8 KiB
htsy agent skill
本仓库提供海豚私域 htsy 通用 agent skill。真正需要安装到 agent skills 目录的内容只有 htsy/ 目录。
安装后，agent 读取到该 skill 时，会按 htsy/SKILL.md 的说明使用 htsy-cli 调用海豚私域接口。
安装
不同 agent 的 skills 目录不同。常见目标：
- Claude Code 用户级：
~/.claude/skills/htsy - Claude Code 项目级：
./.claude/skills/htsy - Codex 用户级：
${CODEX_HOME:-$HOME/.codex}/skills/htsy - 其他支持
SKILL.md目录格式的 agent：使用该 agent 文档指定的 skills 目录
如果已经 clone 了本仓库，在仓库根目录执行：
# Claude Code 用户级
./scripts/install-htsy-skill.sh --agent claude
# Claude Code 项目级
./scripts/install-htsy-skill.sh --agent claude-project
# Codex 用户级
./scripts/install-htsy-skill.sh --agent codex
# 其他 agent，传入完整目标 skill 目录
./scripts/install-htsy-skill.sh --dest /path/to/agent/skills/htsy
Windows PowerShell：
# Claude Code 用户级
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent claude
# Claude Code 项目级
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent claude-project
# Codex 用户级
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent codex
# 其他 agent，传入完整目标 skill 目录
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Dest C:\path\to\agent\skills\htsy
如果还没有 clone 本仓库：
git clone --depth 1 https://git.ikuban.com/server/htsy-skill.git
cd htsy-skill
./scripts/install-htsy-skill.sh --agent claude
Windows PowerShell：
git clone --depth 1 https://git.ikuban.com/server/htsy-skill.git
Set-Location htsy-skill
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent claude
重新执行安装脚本可更新本地 skill。脚本会替换目标位置的 htsy skill 目录。
手动安装
也可以手动把仓库里的 htsy/ 目录复制到目标 agent 的 skills 目录。
Claude Code 用户级：
~/.claude/skills/htsy
Claude Code 项目级：
./.claude/skills/htsy
Codex 用户级：
~/.codex/skills/htsy
Windows Claude Code 用户级：
%USERPROFILE%\.claude\skills\htsy
Windows Codex 用户级：
%USERPROFILE%\.codex\skills\htsy
确认目标目录里存在 SKILL.md：
<agent-skills-dir>/htsy/SKILL.md
安装完成后，重新打开或刷新对应 agent 会话，让 skill 列表重新加载。
给 agent 的说明
面向 AI/agent 的最短安装指令放在 llms.txt。如果 agent 正在读取本仓库，请优先读取 llms.txt，判断当前 agent 类型后按其中步骤安装 htsy/。