用途:审计项目目录结构,使其符合统一约定,并将被取代的内容归档到 _archive/ 下;适用于清理文件夹、标准化布局或为提交做准备。
主要能力:检测文档与磁盘的结构漂移、标记过时或孤立内容、提出可回滚的清理操作;执行磁盘与文档对齐、子文件夹命名大小写对齐、归档旧版本、移动孤立文件、将本机/用户级状态移出版本控制并扩展 .gitignore。
使用方式:先解析仓库根(git rev-parse --show-toplevel),枚举文件并解析项目级文档中的结构图;运行四类检测器(大小写漂移、新旧代内容并存、孤立文件、被跟踪的本机状态);将计划写入 ~/.claude/plans/organize-<repo>-<YYYYMMDD>.md;对模糊决策使用 AskUserQuestion;经确认后执行移动。移动使用 shutil.copytree 加重试以保证云同步路径安全,禁止使用 os.rename / mv,也不使用 git mv。对已跟踪的本机状态使用 git rm --cached <path>(文件保留在磁盘,仅移出索引)。完成后刷新文档结构图,用 git status --short 与 git ls-files --others --ignored --exclude-standard 验证,并提示运行 /commit 或 /ship 完成提交。
目标结构:数据/源码、脚本、输出、参考资料、素材、文档、归档等角色目录,目录仅在至少两项内容归属时才创建;命名遵循大小写、连字符、下划线、日期 ISO 格式等约定;被取代的内容移入同级 _archive/。
限制:默认保守,仅涉及命名、文档与归档,不重构管线、脚本或生成产物;不删除文件(除非用户明确确认);不执行 /commit 或 /ship;不在未明确要求时更改磁盘上的大小写命名。具体收费、平台与效果暂未提供。