用途:通过 agent-almanac 命令行把 agent-almanac 中的技能(skill)、智能体(agent)和团队(team)安装到受支持的智能体框架。适用于新项目初始化、按领域批量安装技能、同时面向多个框架(如 Claude Code、Cursor、Copilot 等)安装、用声明式清单实现可复现配置,以及审计已安装内容中的失效符号链接或过期引用。
必要用法:先运行 agent-almanac detect 扫描工作目录(如 .claude/、.cursor/、.github/copilot-instructions/、.agents/ 等)检测框架;用 agent-almanac search <keyword> 搜索内容,或用 agent-almanac list --domains、list -d <domain>、list --agents、list --teams 浏览。安装示例:agent-almanac install create-skill write-testthat-tests;agent-almanac install --domain devops;agent-almanac install --agent r-developer --with-deps;agent-almanac install --team r-package-review --with-deps。可选参数包括 --framework <id>、--with-deps、--dry-run、--global、--force、--source <path>。安装后可用 agent-almanac audit、audit --framework claude-code、audit --global 校验,用 list --installed 查看。
清单与团队:可用 agent-almanac init 生成 agent-almanac.yml,其中声明 source、frameworks、skills、agents、teams,再运行 agent-almanac install 安装,用 agent-almanac sync(可加 --dry-run)对齐已装状态。团队还可用 campfire 系列命令管理:campfire --all、campfire tending、campfire --map、gather <team>(--ceremonial、--only)、tend、scatter <team>,状态记录在 .agent-almanac/state.json。
限制与注意:为 agent 或 team 安装时若不加 --with-deps,只会装入定义而缺少其引用的技能;--global 装到全局作用域(如 ~/.claude/skills/),项目作用域装到当前目录;源路径变更会使清单和自动检测失效;新项目可能检测不到框架,需显式指定 --framework <id> 或回退到通用适配器。具体安装路径与框架支持列表以实际资料为准,其余细节暂未提供。