Skip to content

BREAKING removal 后的存量文档迁移体验:旧 CLAUDE.md 段继续教已删除的命令 #177

Description

@dreamlx

(由误判的 #176 修正而来——post-commit 移除本身是 #167/#169 的有意决策,无异议。)

Dogfood 实证(BlueHawkLock,v0.33.3 → v0.37.0)

升级后旧 CLAUDE.md 的 codeindex 段仍在教 AI/用户使用已删除的机制

  • 「已安装的 post-commit hook 在每次 commit 后为变更目录重新生成 README_AI.md」——机制已移除,README_AI 全量 stale(本仓实测 7+ commit 无再生,新函数零 README_AI 命中)
  • codeindex hooks rerun post-commit——命令已删(实测 No such command 'rerun'
  • AI agent 忠实执行 CLAUDE.md 就会撞不存在的命令;README_AI 的 stale 会让 agent 高估索引新鲜度

做得好的:版本漂移 hint(CLAUDE.md has codeindex v0.33.3, current is v0.37.0)每次命令都触发,本次问题正是靠它暴露的。

建议

BREAKING removal 的迁移路径里加一步「文档迁移提示」:检测到 CLAUDE.md/README 仍含已删除命令(hooks rerunhooks install post-commit)时,hint 从「run claude-md update」升级为明确警告「检测到已删除机制的文档描述(post-commit hook / rerun),升级后刷新策略已改为 X,请跑 claude-md update」。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions