projectlisted

# project：新工作项目文件夹初始化（原名 project-init，2026-08-24 更名） 一句话：**每个会被反复修改的工作目录都值得 git，但不是每个都值得配齐全套**——先盘点，再定档，再生成骨架，最后首提交。为什么是这套标准见 `references/rationale.md`（要向用户解释"为什么"时先读它）。 ## 流程（do-nothing 风格：每步先做再确认，不跳步） ### 0. 盘点（只读） ```bash python3 ~/.claude/skills/project/scripts/inventory.py <目录> ``` 看四件事：总大小与二进制占比、>10MB 文件、疑似可再生缓存、本机备份状态（Time Machine / iCloud）。**备份现状必须原话报给用户**——git 与文件同盘同灾，备份是 git 解决不了的事，用户不知道就等于没有。 ### 1. 三问定要不要 git 会不会被反复修改？是不是文本为主？出错要不要回得去？三问全否（纯归档、只进不改的导出堆、二进制素材库）→ 告诉用户不需要 git，建议放网盘/归档盘，结束。否则继续。 ### 2. 定档 先探测：`git -C <目录> rev-parse --show-toplevel`——若目录已在某个仓库**内部**，直接定**板块档**，一律不建嵌套仓。 | 档 | 内容 | 用于 | |---|---|---| | **最小档 minimal** | .gitignore + README + git init + quotepath | 所有项目无条件；一次性 campaign 到此为止 | | **流水线档 pipeline** | + CLAUDE.md、progress.md（当前进展，覆盖式 <50 行）、TODO.md、docs/decisions.md、docs/online_assets.md、snapshots/、auth.json.example | 任一触发即升：**月度重跑** / **往在线表（飞书表格・Base・云文档）写数据** / **第二个数据源** | | **板块档 board** | 不 git init（沿用母仓），按流水线档生成 README / progress.md / TODO.md / docs/decisions.md 等，另在**母仓** README 与 progress.md 各登记一行入口；commit 只暂存本板块路径 | 目录位于既有仓库内部（如 外链/medium工作流，2026-08-21 实例）| 拿不准就问用户一句（AskUserQuestion），把档位差异用一句话说清：流水线档多出来的东西全是"防在线表出事 + 防口径漂移"的，做一次性调研用不上。 **多智能体双文件约定**（用户并用 Claude Code 与 Codex）：守则正文只维护一份——主力工具的文件名放正文（CLAUDE.md），另一个文件名（AGENTS.md）只放一行指针 + 该工具特有差异；两边各写正文必然漂移（外链根目录 2026-08 已出现实例）。 ### 3. 生成骨架 ```bash python3 ~/.claude/skills/project/scripts/scaffold.py <目录> --tier minimal|pipeline \ --name <项目名> --purpose "<一句话用途>" \ [--c