name: mpm-organize description: 通过智能合并组织项目文件 user-invocable: true version: “1.0.0” category: mpm-command tags: [mpm-command, system, pm-optional]

/mpm-organize

通过智能检测、合并和修剪来组织所有项目文件。

用法

/mpm-organize [--dry-run] [--force] [选项]

委托给项目组织代理进行全面的文件组织。

范围

默认： 组织所有项目文件

文档 (.md, .rst, .txt)
源代码（适当的模块结构）
测试（组织的测试套件）
脚本（scripts/ 目录）
配置（适当的位置）

受保护的文件（从不移动）： README.md, package.json, pyproject.toml, Makefile, .gitignore 等。

关键选项

安全：

--dry-run：预览而不做更改（推荐首次运行）
--force：继续未提交的更改
--no-backup：跳过备份（不推荐）

范围：

--docs-only：仅文档（旧版行为）
--code-only / --tests-only / --scripts-only：特定文件类型

操作：

--consolidate-only：仅合并重复项
--prune-only：仅删除陈旧文件
--no-prune：保留所有文件（不删除）

功能

模式检测： 扫描现有组织（PROJECT_ORGANIZATION.md，框架约定）
合并： 合并重复项（READMEs，指南，实用工具）
修剪： 存档/删除陈旧内容（>6个月旧，空文件）
分类： 将文档分类为研究/用户/开发者
安全移动： 使用 git mv 保留历史
备份： 创建 backup_project_YYYYMMDD_HHMMSS.tar.gz

标准结构

docs/
├── research/        # 探索、分析、笔记
├── user/            # 指南、教程、常见问题
└── developer/       # API 文档、架构、贡献指南

src/<package>/       # 适当的模块结构
tests/               # 镜像源代码结构
scripts/             # 自动化工具
config/              # 配置（如果需要）

示例

# 预览更改（推荐首次）
/mpm-organize --dry-run

# 组织所有内容并备份
/mpm-organize

# 仅文档
/mpm-organize --docs-only --dry-run

# 仅合并而不修剪
/mpm-organize --consolidate-only --no-prune

# 保存报告
/mpm-organize --report /tmp/organize-report.md

预期输出

🔍 分析项目结构...
✓ 检测到 PROJECT_ORGANIZATION.md - 使用项目标准
✓ 找到 23 个文档文件，15 个测试文件，8 个脚本

📁 建议更改：

  合并：
    → 合并 README_OLD.md + README_BACKUP.md → docs/user/README.md

  组织：
    docs/research/ ← spike-oauth.md（来自根目录）
    tests/unit/ ← test_auth.py（来自根目录）
    scripts/ ← deploy.sh（来自根目录）

  修剪：
    ✂ 删除 TODO_2023.md（陈旧 18 个月）

📊 摘要：8 个要移动，2 个要合并，3 个要修剪

安全特性

更改前完整项目备份
Git 集成（保留历史）
导入验证（确保移动不会破坏代码）
受保护文件从不触碰
保守修剪（不确定时存档）

查看 docs/commands/organize.md 获取完整文档。