核心功能
wip-repo-init 是一个轻量级 CLI 工具，旨在为任意代码仓库快速搭建标准化的 ai/ 目录结构，解决 AI 项目文件管理混乱、缺乏规范的痛点。
核心用法
- 全新仓库：执行
wip-repo-init /path/to/repo直接生成完整目录树 - 已有仓库：自动备份现有
ai/内容至ai/_sort/ai_old/，然后搭建新标准结构 - 安全预览：
--dry-run模式可零风险查看变更 - 静默执行：
--yes跳过确认，适合 CI/CD 集成
显著优点
1. 零数据丢失设计：采用"移动而非删除"策略，旧文件全部归档至 _sort/ai_old/
2. 自解释结构：每个目录附带 README，降低团队 onboarding 成本
3. 生命周期管理：内置 plans-prds/ 的分阶段子目录（current/upcoming/archive-complete），天然支持产品规划流程
4. 与工具链集成：dev-updates/ 目录可被 wip-release 自动识别
潜在局限
- Node.js 依赖：要求 Node 18+，对纯 Python/Rust 项目引入额外运行时
- opinionated 结构：强制采用特定组织方式，灵活性不足
- 仅目录脚手架：不提供模板文件内容生成（如 PRD 模板、技术方案模板）
- npm 分发：未提供 Homebrew、pip 等跨生态安装方式
适合人群
- 刚启动 AI 项目、希望建立工程规范的小型团队
- 现有项目
ai/目录混乱、需要重构归档的开发者 - 使用 WIP Computer 生态工具链的用户
常规风险
- 备份验证：虽有
_sort/ai_old/机制，建议首次使用前手动备份关键文件 - 权限问题：对受保护目录操作时可能因权限不足失败
- CI 集成注意：
--yes模式跳过确认，需确保路径参数正确避免误操作