用途:autonomous-common 是 autonomous-dev-team 技能集的共享基础设施层,集中存放工作流强制钩子(hooks)与智能体可调用的工具脚本(scripts),被 autonomous-dev、autonomous-review、autonomous-dispatcher 等技能引用。当这些技能引用的路径失效时,通常需要检查本技能。
主要能力:hooks/ 目录包含工作流强制钩子,如 block-push-to-main、block-commit-outside-worktree、check-pr-review、check-shellcheck、verify-completion 等。scripts/ 目录提供智能体可调用工具,包括 session-knowledge.sh / session-knowledge.py(私有共享任务回执、可选已验证候选、本地知识与隔离文档提交)、install-project-hooks.sh(IDE 无关的项目侧引导)、lib-installer.sh、lib-installer-translate.sh,以及针对 Claude Code、Qoder、Antigravity、Cursor、Kiro CLI、Gemini CLI、Codex CLI、Windsurf、Kimi CLI 的各自安装脚本,另有 gh-as-user.sh、mark-issue-checkbox.sh、reply-to-comments.sh、resolve-threads.sh 等。
使用方式:通过 npx skills add 安装后,从项目根目录运行对应编码智能体的安装脚本一次,例如 Claude Code 使用 bash .claude/skills/autonomous-common/scripts/install-claude-hooks.sh,写入 .claude/settings.json;其他智能体各有对应脚本与写入位置。项目侧脚本与 hooks 符号链接由 IDE 无关的引导脚本管理:bash .agents/skills/autonomous-common/scripts/install-project-hooks.sh,该脚本将 dispatcher 的 *.sh 符号链接到项目 scripts/,不覆盖项目本地真实文件,清理悬空链接,并安装 git pre-push 钩子,可重复运行。
适用场景:需要为自主开发/评审工作流配置或修复共享钩子与工具脚本时;在 npx skills 更新后重新引导项目侧链接时;为不同编码智能体安装钩子时。
限制:Claude Code 需要启用 code-simplifier 与 pr-review-toolkit 插件;Cursor、Windsurf 等不支持钩子的 IDE 会跳过安装与符号链接,工作流步骤需手动执行;Codex CLI 安装脚本要求 Python 3.11+;Kimi CLI 默认写入用户级配置,使用 --project 才写入项目级;Antigravity 的钩子契约由社区观察得出,Google 未提供文档。旧版目录级符号链接方式已弃用。其余细节以各 README 与源码为准。