SuperAPI AI 工具集

init

智能体与模型

查看项目

更新于 10-29 06:18

技能介绍

用途

init 是 dev-team-for-codex 技能包中的仓库初始化技能,用于在用户指定的本地 Git 仓库中安装或刷新 dev-team 团队配置,而不是写入插件缓存。它会安装七个 Codex 代理并为每个代理指定显式模型,同时起草一份可审阅的仓库画像文件。

主要能力

  • 在目标仓库中安装项目级代理文件,仅影响该项目,不修改全局设置,也不安装或信任插件本身。
  • 安装前以 --check 方式运行安装脚本,展示任何代理文件所有权冲突;已定制的代理不会被覆盖。
  • 校验插件是否已启用、钩子是否受信任,并通过在主会话中运行 printf DEV_TEAM_GUARD_PROBE 确认守卫钩子生效(预期得到「dev-team: guard active for main」的拒绝提示,这是有意设计的无害拒绝,而非安装错误)。
  • 使用新的内置探索上下文调研仓库,收集测试、lint、类型检查、构建命令的来源依据,以及编码约定、受保护路径、发布/版本位置和提交信息约定;调研代理不得执行写入、安装、构建或发布操作。
  • 根据证据填写 dev-team.md 模板,证据缺失时标注未知项及已搜索范围,保留所有章节与接口标签;Engine 为 codex,Plan audit 为 auto。若存在 .claude/dev-team.md,可提供经过审阅的事实性章节导入,并保留该 Claude 文件;现有 .codex/dev-team.md 仅在用户接受前后差异后刷新。
  • 对每个安全检查命令各执行一次,限时十分钟;跳过需要网络服务、凭据、在线服务器或额外写入的命令,并记录日期、退出码和跳过原因,保留失败结果。
  • 保存 .codex/dev-team.md 后运行 doctor.mjs 校验设置与所声明的模型目录(不校验钩子信任与实际推理)。模型与推理强度选项保留在 .codex/agents/dev_team_*.toml 的 developer_instructions 之前,避免在 Markdown 画像中重复可编辑值;不可用的模型不会被静默更改。
  • 展示画像供审阅,尤其关注发布命令与受保护路径;提示用户打开新的 CLI 或桌面会话,以便在运行 dev-team:run 前发现新安装的代理。不执行提交或发布。
  • 移除时使用 --uninstall,仅删除未改动过的自有代理,定制文件与画像保留;插件移除属于独立的客户端操作。

使用方式

该技能通过命令行脚本执行:读取目标仓库的 AGENTS.md,运行 node "PACKAGE/scripts/install.mjs" --cwd "REPOSITORY" --check 检查冲突,无误后去掉 --check 正式安装;再按提示启用并信任插件、执行探测命令、调研仓库、填写模板、运行安全检查命令,最后运行 node "PACKAGE/scripts/doctor.mjs" --cwd "REPOSITORY"。其中 PACKAGE 为解析出的包根目录占位符(位于 SKILL.md 上两级),并非 Codex 提供的环境变量。

适用场景

适用于需要在本地 Git 仓库中快速建立 Codex 开发团队协作配置、统一代理模型设置、生成仓库画像的场景,也适用于刷新已有配置或安全移除未定制的代理。

限制

  • 不修改全局设置,不安装或信任插件本身。
  • doctor.mjs 不校验钩子信任与实际推理效果。
  • 需要联网、凭据或在线服务的检查命令会被跳过。
  • 不执行提交或发布;插件移除需在客户端单独操作。