用途：诊断既有 .claude/ 体系与理想形的差距，列出缺口清单并在用户批准后仅做增量补全。适合已存在 .claude/ 目录的仓库；若没有 .claude/，需改用 init-claude。
主要能力：诊断 Agents（分类、技术层 builder、model 配分、最小权限、委派 Agent）、Rules（delegation、delegation-impl、编码/安全/日文风格/提交规范/注释风格/范围外追踪）、Skills（对比 skills-lock.json 缺失项）、hooks（SessionStart、PostToolUse）、CLAUDE.md（委派表、Sub-agents 表、Rules 表、Current Skills）以及 implement-issue-tree 前提（gh 认证、sub_issues API、workflow js 符号链接）。
使用方式：执行 update-claude [目标仓库路径]，省略路径时以当前目录为目标。前提为仓库存在 .claude/、gh CLI 已认证、可用 npx、readlink 可用。流程为：调查现状 → 诊断差距 → 向用户展示差距并获得批准 → 按已批准项补全 → 报告结果与前提满足情况。补全 Skills 使用固定版本命令 npx --yes "skills@${SKILLS_CLI_VERSION}" add Fandhe-AI/agent-cli-skills，固定失败即报错退出，不回落至未固定版本。
限制：不擅自覆盖既有 Agent、Rules、CLAUDE.md，必须逐项获得批准；不向 settings.json 的 command 写入密钥；不把用户输入直接展开进 command；hooks 中不夹带 --no-verify；发现密钥混入或注入风险时中断并警告。workflow js 用相对符号链接而非 cp，stale 或 dangling 时重挂，实体文件不覆盖；readlink 不可用时中断自动重挂。skills CLI 版本固定与更新步骤及与其他技能已知版本差异见原文说明。