feat: add skill install scripts and move skill into htsy/

2026-07-01 15:53:37 +08:00
parent 3212e64776
commit 1f4a00a0b0
15 changed files with 465 additions and 0 deletions
@@ -0,0 +1,71 @@
+# htsy-skill instructions for AI agents
+
+Purpose: install the portable agent skill located in this repository's `htsy/` directory.
+
+Important rules:
+- Install only the `htsy/` directory as the skill.
+- Do not install the repository root as a skill.
+- Do not move or rewrite `htsy/SKILL.md` or `htsy/references/*`.
+- This installs the agent skill only. It does not log in to htsy-cli and does not call business APIs.
+- Do not assume the current agent is Codex. Choose the destination for the active agent.
+- If the target already has an `htsy` skill, updating it by replacing that target directory is expected.
+
+Known targets:
+- Claude Code user skill: `~/.claude/skills/htsy`
+- Claude Code project skill: `./.claude/skills/htsy`
+- Codex user skill: `${CODEX_HOME:-$HOME/.codex}/skills/htsy`
+- Other agents that support `SKILL.md` directory skills: use that agent's documented skills directory and install as `<skills-dir>/htsy`.
+
+Choose the install target:
+- If the user is using Claude Code and did not request project-local install, use `--agent claude`.
+- If the user wants the skill checked into the current project for Claude Code, use `--agent claude-project`.
+- If the user is using Codex, use `--agent codex`.
+- If the agent type is different or unclear but its skills directory is known, use `--dest /absolute/path/to/skills/htsy`.
+- If the agent type and skills directory are both unknown, ask the user for the target skills directory.
+
+If this repository is already present locally and `htsy/SKILL.md` exists, run the installer from the repository root.
+
+macOS/Linux examples:
+
+```bash
+bash ./scripts/install-htsy-skill.sh --agent claude
+bash ./scripts/install-htsy-skill.sh --agent claude-project
+bash ./scripts/install-htsy-skill.sh --agent codex
+bash ./scripts/install-htsy-skill.sh --dest /path/to/agent/skills/htsy
+```
+
+Windows PowerShell examples:
+
+```powershell
+PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent claude
+PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent claude-project
+PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Agent codex
+PowerShell -ExecutionPolicy Bypass -File .\scripts\install-htsy-skill.ps1 -Dest C:\path\to\agent\skills\htsy
+```
+
+If this repository is not present locally, clone it first:
+
+macOS/Linux:
+
+```bash
+git clone --depth 1 https://git.ikuban.com/server/htsy-skill.git
+cd htsy-skill
+bash ./scripts/install-htsy-skill.sh --agent claude
+```
+
+Windows PowerShell:
+
+```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
+```
+
+Verification after install:
+- Confirm the installed file exists at the target path: `skills/htsy/SKILL.md`.
+- Tell the user to reload or start a new agent session if the current session does not list the skill yet.
+
+When installation fails:
+- If `git clone` fails, ask the user for an accessible checkout or archive.
+- If `CODEX_HOME` is set and installing for Codex, respect it.
+- If the operating system is unknown, ask before choosing commands.