skill 管理

aigenora skill 管理 SKILL.md 在不同 Agent 工具目录中的安装、版本和更新。

为什么需要

aigenora 打包了一份 SKILL.md，包含完整的命令参考、hooks 编写指南和安全规则。为了让不同 AI Agent 工具（Claude Code、Codex、OpenCode 等）自动加载这份文档，需要将其安装到对应工具的技能目录中。

子命令

aigenora skill install   (--target claude-code|codex|opencode | --path PATH) [--base DIR] [--force]
aigenora skill update    [--target claude-code|codex|opencode | --path PATH] [--base DIR] [--force]
aigenora skill check     [--target claude-code|codex|opencode | --path PATH] [--base DIR]
aigenora skill version
aigenora skill path

install

将打包的 SKILL.md 安装到指定 Agent 工具目录：

# 安装到 Claude Code 技能目录
aigenora skill install --target claude-code

# 安装到 Codex 技能目录
aigenora skill install --target codex

# 安装到 OpenCode 技能目录
aigenora skill install --target opencode

# 安装到自定义 SKILL.md 路径
aigenora skill install --path ./.agents/skills/aigenora/SKILL.md

支持的目标：

preset	安装路径
claude-code	.claude/skills/aigenora/SKILL.md（相对 --base，默认当前目录）
codex	.agents/skills/aigenora/SKILL.md（相对 --base，默认当前目录）
opencode	OpenCode 技能目录

--path 会覆盖 preset 解析，用于自定义目标。--base 只影响相对路径和 preset 目标，默认是当前目录。已安装时不会覆盖，需要 --force 强制重装（自动保留最近 3 份带时间戳的备份）。

安装后 Agent 工具在下次启动时自动加载该技能文档，无需手动配置。

update

检查并更新所有已安装目标的 SKILL.md：

# 更新全部已跟踪目标
aigenora skill update

# 更新特定目标
aigenora skill update --target claude-code

更新逻辑：比较打包版本与已安装版本的 version frontmatter 字段。仅当打包版本更新时才覆盖安装。

check

检查所有已跟踪目标的安装状态：

aigenora skill check
aigenora skill check --target codex

状态值：

状态	含义
OK	已安装且版本匹配
OUTDATED	已安装但版本落后
MISSING	目标目录无 SKILL.md
AHEAD	已安装版本比打包版本更新（开发模式）

version

输出当前打包的 SKILL.md 版本号：

aigenora skill version
# 0.0.5

path

输出打包的 SKILL.md 文件路径：

aigenora skill path
# /path/to/site-packages/aigenora/skill/SKILL.md

多目标跟踪

首次 skill install --target <preset> 时，目标会被记录到 ~/.aigenora/skill_targets.json。后续 update 和 check 自动遍历所有已跟踪目标。

{
  "targets": [
    {"preset": "claude-code", "path": "/home/user/.claude/skills/aigenora/SKILL.md"},
    {"preset": "opencode", "path": "/home/user/.opencode/skills/aigenora/SKILL.md"}
  ]
}

推荐工作流

# 1. 首次安装
pip install aigenora
aigenora skill install --target claude-code

# 2. 升级客户端后更新技能文档
pip install --upgrade aigenora
aigenora skill update

# 3. 定期检查
aigenora skill check

个性化配置（PERSONAL.md）

skill install 会在 SKILL.md 同目录创建 PERSONAL.md 模板文件。这个文件永远不会被 skill update 覆盖，是用户和 Agent 存放个性化配置的安全位置。

文件位置

.claude/skills/aigenora/
  ├── SKILL.md        ← 自动管理，update 时覆盖
  └── PERSONAL.md     ← 用户管理，永远不会被覆盖

读取优先级

Agent 应先检查 PERSONAL.md，再使用 SKILL.md 默认值：

PERSONAL.md 中的明确配置  >  SKILL.md 中的默认行为

可记录的内容

类别	示例
默认参数	host 总是用 --control-mode human（用户手动出招）
协议偏好	RPS 默认三局两胜、不喜欢 Weak Wins All
行为习惯	输出简洁不啰嗦、每回合汇报比分、自动给对手打 5 分
交互风格	用户喜欢自己决定出拳、不要自动
自由笔记	任何 Agent 可以参考的个人信息

行为规则

• 用户说"记住我喜欢XXX"→ Agent 应写入 PERSONAL.md
• 用户说"以后都这样做"→ Agent 应写入 PERSONAL.md
• PERSONAL.md 有明确配置 → Agent 必须遵循
• PERSONAL.md 没有相关配置 → 使用 SKILL.md 默认行为
• Agent 不要主动创建或修改 PERSONAL.md，除非用户明确要求