核心用法
wip-repo-init 是一个 Node.js CLI 工具，用于在任何代码仓库中快速搭建标准化的 ai/ 目录结构。基础命令为 wip-repo-init /path/to/repo，支持 --dry-run 预览模式与 --yes 自动确认。
显著优点
- 零数据丢失设计：迁移旧仓库时，原
ai/内容自动移至ai/_sort/ai_old/，绝不删除任何文件 - 完整文档体系：每个目录配备 README，明确文件归属与维护规范
- 产品生命周期管理：内置
plans-prds/目录，支持 current/upcoming/archive-complete 阶段流转 - 多接口兼容：同时支持 CLI 与 Skill 调用，方便集成到自动化工作流
潜在缺点与局限性
- Node.js 依赖：强制要求 Node 18+ 环境，对纯 Python/Go 项目引入额外依赖
- 结构刚性：强制采用固定目录层级，高度定制化需求的团队可能需要二次调整
- 迁移成本：现有非标准
ai/目录需人工从ai_old/重新分类，无法自动映射 - 生态锁定：与
wip-release等 WIP 系工具深度耦合（如dev-updates/的自动检测）
适合人群
- 希望快速统一多仓库 AI 工作区结构的开发团队
- 需要规范化产品文档与研发日志分离的产品型组织
- 正在从混沌状态向结构化 AI 协作迁移的中大型项目
常规风险
- 路径冲突：若目标路径存在符号链接或权限异常，可能导致移动操作失败
- 误覆盖：
--yes模式下若ai/_sort/ai_old/已存在同名文件，行为未明确说明 - 长期维护：标准结构更新后，历史仓库可能面临目录规范不一致问题