Wip Repo Init

为指定仓库生成标准 ai/ 目录结构（含 _sort、_trash、dev-updates、product 等分区及各自说明 README），支持 --dry-run 预览与 --yes 跳过确认；当 ai/ 已存在时先将旧内容移入 ai/_sort/ai_old/ 再重建结构，不删除文件。

parkertoddbrooks

热度 67.27

最近更新 2026-05-11 17:30:43

分类：开发依赖：代码执行 / 读写文件应用场景：模板 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add wip-repo-init

Metadata

name: wip-repo-init
description: Scaffold the standard ai/ directory structure in any repo.
license: MIT
interface: ["cli","skill"]
metadata: {"display-name":"Repo Init","version":"1.0.0","homepage":"https://github.com/wipcomputer/wip-ai-devops-toolbox","author":"Parker Todd Brooks","category":"repo-management","capabilities":["scaffold-ai-dir","template-copy"],"requires":{"bins":["node"]},"openclaw":{"requires":{"bins":["node"]},"install":[{"id":"node","kind":"node","package":"@wipcomputer/wip-repo-init","bins":["wip-repo-init"],"label":"Install via npm"}],"emoji":"📁"}}
compatibility: Requires node. Node.js 18+.

Repo Init

Scaffolds the standard ai/ directory structure in any repo.

Commands

wip-repo-init /path/to/repo              # scaffold ai/ in a repo
wip-repo-init /path/to/repo --dry-run    # preview without changes
wip-repo-init /path/to/repo --yes        # skip confirmation prompt

What happens

New repo (no ai/ folder): Creates the full standard structure with all READMEs explaining what goes where.

Existing repo (ai/ folder exists): Shows you what will happen and asks for confirmation. If you say yes:

Moves your current ai/ contents to ai/_sort/ai_old/
Scaffolds the new standard structure
You sort files from ai_old/ into the new structure at your own pace

Nothing is deleted. Your old files are all in ai/_sort/ai_old/.

The standard ai/ structure

ai/
  read-me-first.md          <- explains everything, links to all sections
  _sort/                    <- holding pen for files that need sorting
  _trash/                   <- archive (never delete, move here)
  dev-updates/              <- engineering changelog, auto-detected by wip-release
  product/
    readme-first-product.md <- the product bible
    notes/                  <- freeform notes, research
    plans-prds/             <- plans with lifecycle stages
      roadmap.md            <- prioritized roadmap
      current/              <- plans being built now
      upcoming/             <- plans that are next
      archive-complete/     <- plans that shipped
      todos/                <- per-agent todo files
    product-ideas/          <- ideas that aren't plans yet

Every folder has a _trash/ subfolder. Every section has a README explaining what it is, what goes in it, and how to maintain it.

Interfaces

CLI, Skill