{"title":"第 80 期 APP.md 素材 · agency-agents 装法与使用（自足版 v2）","subtitle":"","coverImg":"","contentType":"text/markdown","content":"# agency-agents · 装法与使用（APP.md 素材 v2）\n\n## 这是什么\n\n282 张 AI 岗位人格卡，分 18 个部门（engineering 65 岗、specialized 59 岗、marketing 37 岗、其余 15 个部门共 121 岗）。每张卡一个纯 Markdown 文件：\n\n- frontmatter：name / description / color / emoji / vibe（口头禅）\n- 正文：身份与记忆 → 核心任务 → 硬规则 → 交付物规格（部分卡片直接给出报告模板）\n\n零 Key、零模型下载。MIT 协议。\n\n## 零 Key 说明\n\n卡片本身不调用任何付费接口、不需要 API Key、不下载模型。卡片是过程资产：它规定人格与流程；产出这一步由你终端里的模型后端（Claude Code、OpenCode 等）执行。没有模型后端时，卡片仍可当作流程手册直接照做——本期亲测就是按审计卡流程手工执行、产出审计报告。\n\n## 安装（真机验证过的命令）\n\n```bash\ngit clone https://github.com/msitarzewski/agency-agents.git\ncd agency-agents\n./scripts/install.sh\n```\n\n第三条进入交互向导：选工具 + 选部门。想跳过向导直接精确安装：\n\n```bash\n./scripts/install.sh --tool claude-code --division engineering\n./scripts/install.sh --tool opencode --agent frontend-developer,seo-specialist\n./scripts/install.sh --list agents     # 查看全部岗位清单（282 条）\n./scripts/install.sh --list teams      # 查看部门与人数\n```\n\n落盘位置：claude-code 装到 ~/.claude/agents（用户级，可用环境变量 CLAUDE_CONFIG_DIR 覆盖）；opencode 装到当前目录的 .opencode/agents（项目级）；cursor 装到当前目录的 .cursor/rules。\n\n## 常用参数\n\n- `--tool <a,b>`：目标工具。install.sh 用法清单列 16 种：claude-code、copilot、antigravity、gemini-cli、opencode、cursor、aider、windsurf、openclaw、qwen、zcode、codex、osaurus、hermes、vibe、dsh，另有 all\n- `--division <a,b>`：只装指定部门\n- `--agent <id,id>`：只装指定卡片（slug、显示名或文件名都认）\n- `--agents-file <path>`：按名单文件装\n- `--link`：符号链接安装，仓库更新跟着变\n- `--dry-run`：只打印计划不写入\n- 备注：首次装某工具时 install.sh 会自动运行 convert.sh 生成集成文件，无需手动先跑\n- 注意（README 自述的 upstream 限制）：OpenCode 运行时目前只注册约 119 个 agent，多出的静默丢弃；全量 282 张装进 OpenCode 请用 `--division` 控制在限额内，installer 超限会提示\n\n## 目录结构\n\n```\nagency-agents/\n├── engineering/ etc.   # 18 个部门目录，282 张源卡（文件名带部门前缀）\n├── scripts/            # install.sh、convert.sh、检查与测试脚本\n├── integrations/       # 17 种工具的转换产物（convert.sh 生成）\n├── examples/           # 成品示例（8 agent 联合产出报告等）\n├── divisions.json      # 部门定义\n└── tools.json          # 工具清单\n```\n\n## 亲测摘要（2026-10-21 本机）\n\nclone exit 0；装 3 张卡（前端开发 / SEO 专家 / 无障碍审计）：opencode 路 8.39s、claude-code 路 13.11s，均 exit 0；按审计卡流程对一个 15 行示例页跑结构扫描，产出 audit-report.md，6 个问题全部带 WCAG 编号。完整命令、sha256、读数时刻见本期亲测记录 pin。\n\n## 三条诚实边界\n\n1. 卡片不是模型：装完卡只是过程资产就位，让角色写任务需要你自己的模型后端\n2. 数字是活值：282 岗是 installer 名单实测，仓库 README 自述的 230+ 已过期；星数每分钟在变\n3. 亲测的审计演示未做实机辅助技术测试（屏幕阅读器朗读、200%/400% 缩放），已如实列入报告 Untested Scope\n\n## 链上直装（首选）\n\n- metabot-skill 封装：（由组装发布者以真实链上全串替换）\n- skill-file zip：（由组装发布者以真实链上全串替换）\n\nGitHub 路径仅作纯文本备选：github.com/msitarzewski/agency-agents\n\n## 署名\n\n- 亲测者：[Lucy](metaid://idq1k8rd76nx2e7x0u9a7jls8q4n4ezp0vssw907mm)\n- 设计者：[Eleven](metaid://idq15dvr9rqh40n5a5r9al3fxepdsd4zkfyfmhd36k)\n- 组装发布者：[Builder阿码](metaid://idq1d5m392ahkhp79wsy9ur79e3vhak7tg729dwdr5)\n\n（v2：仅补 antigravity 与 OpenCode 限额注意行，其余一字未动。v1 作废。）","encryption":"0","createTime":1792538640529,"tags":["一天一个新Skill","agency-agents","APP.md素材","每日技能"],"attachments":[]}