personal-arsenal-lifecycle-doctor

# Personal Arsenal Lifecycle Doctor 帮助个人 power user 长期维护自己的技能集合，防止时间腐烂、升级失效、外部依赖僵尸化。 ## 触发场景（严格按真实用户语言） 当用户说以下任意一句话时，立即激活本技能： - “我的技能失效了”“升级后老技能不认了” - “技能腐烂了”“外部依赖坏了”“我的个人 Arsenal 乱了” - “帮我检查技能健康”“技能生命周期”“长期维护技能” - “我 1-2 年前超好用的 Skill 现在 Claude 完全不认了” - “我的部署类技能现在执行不了了，外部项目下线了” - “Claude Code 升级后好多技能都不触发了” 特别适合维护 1 年以上个人技能集合（Arsenal 符号链接 + 自定义 + 社区拷贝混合）的重度用户。 ## 工作流程（诊断优先 + 用户门控） ### 阶段 1：只读发现（绝不擅自修改） 1. 扫描 `~/.claude/skills` 目录 2. 区分每个技能的**来源**： - Arsenal 官方符号链接（`ln -s` 指向本仓库） - 纯自定义（用户自己写的） - 社区拷贝 / fork（历史快照） 3. 提取 frontmatter 元数据（特别关注新增的 version、last_verified、external_deps、provenance） 4. 扫描技能内容中的硬依赖： - GitHub 仓库 URL（尤其是未 pin commit 的） - `pip install` / `npm install` 无版本锁定 - 特定文件路径假设 ### 阶段 2：多维度健康诊断 按以下 4 个维度打分 + 证据： - **时间腐烂风险**（last_verified 距今 >6 个月 / >12 个月） - **触发描述失效风险**（description 过时、缺少当前 Claude 真实用户痛点语言、与已知机制变化冲突） - **外部依赖僵尸化风险**（仓库 404、API 变更、包消失） - **结构健康风险**（缺少健康自检模块、过度复杂、无 graceful degrade、违反 progressive disclosure） ### 阶段 3：输出结构化健康报告 必须包含： - 总体健康评分（🔴严重 / 🟡警告 / 🟢健康） - 按风险分级的**问题清单**（每条带具体证据：文件路径 + 行号 + 最后验证时间） - 每个问题的**最小可执行修复建议**（优先“更新元数据”而非“大改”） - 一键可运行的命令（用户说“执行”后才真正运行） - 与 `codex-retrospective` 的协同建议（把本次发现的模式提炼成 AGENTS.md 规则） 完整报告模板见 `references/健康报告模板.md`。 ### 阶段 4：安全执行（任何写操作都必须过用户确认） - 所有修改前必须先 dry-run + 明确展示 diff - 提供 rollback 方案 - 绝不碰用户 CLAUDE.md / AGENTS.md（除非用户明确说“帮我写进 AGENTS.md”） - 严重问题优先建议“先备份整个 ~/.claude/skills” ## 推荐的健康自检模块（所有长期 Skill 都应该内置） **核心原则**（来自长期健康研究）： - 声明当前版本 + last_verified + tested_on（claude_version...