朱子纯 / erp-workflow-plugin

---

name: project-init description: A0 项目初始化——从插件模板幂等地复制 CLAUDE.md / docs/01-需求清单/index.md / docs/04-技术规范.md / docs/08-模块任务管理.md（已存在则跳过），并初始化 Git（如未初始化）。session-start 在 docs/08 缺失时派发本 skill。 user-invocable: false

allowed-tools: Glob Edit Skill Bash(mkdir ) Bash(cp -n *) Bash(git init) Bash(command -v *) Bash(uname *) Bash(brew *) Bash(apt *) Bash(apt-get *) Bash(yum *) Bash(apk *) Bash(export PATH=) Bash(echo *) Bash(cat *)

所有输出必须使用中文。

你负责在项目目录中创建初始文件结构，已存在的文件不覆盖。

执行步骤

步骤 0：打印当前位置流程图

用 Bash 执行 cat 命令向用户展示当前位置流程图（stdout 即 ASCII 框图）：

cat "${CLAUDE_PLUGIN_ROOT}/skills/project-init/banners/flow.txt"

A. 幂等复制模板文件

用 Bash 一次性完成。cp -n 表示"不覆盖已存在的文件"：

mkdir -p docs/01-需求清单
cp -n "${CLAUDE_SKILL_DIR}/templates/CLAUDE-template.md" CLAUDE.md
cp -n "${CLAUDE_SKILL_DIR}/templates/docs-01-index-template.md" docs/01-需求清单/index.md
cp -n "${CLAUDE_SKILL_DIR}/templates/docs-04-stack-template.md" docs/04-技术规范.md
cp -n "${CLAUDE_SKILL_DIR}/templates/docs-08-initial-template.md" docs/08-模块任务管理.md

完成后，用 Edit 在 docs/08-模块任务管理.md 中勾选：

• - [ ] 项目文件骨架已创建（CLAUDE.md + docs/01-需求清单/index.md + docs/04-技术规范.md）

B. 依赖检查 + 自动安装（命令行工具）

对 git、mysql 两个工具依次执行以下流程。

1. 如果缺失，尝试自动安装。
2. 如果检测到不在 PATH，尝试添加进 PATH，并加载。

全部通过后打印单行汇总再进入步骤 C：

[project-init] 依赖检查: git ✓  mysql ✓

完成后，用 Edit 在 docs/08-模块任务管理.md 中勾选：

• - [ ] 依赖检查通过

C. 初始化 Git（如尚未初始化）

用 Glob 检查 .git/ 目录是否存在。

• 不存在 → 用 Bash 执行 git init。
• 已存在 → 跳过。

完成后，用 Edit 在 docs/08-模块任务管理.md 中勾选（A0 子项 + A0 顶层）：

• - [ ] Git 已初始化
• - [ ] A0 项目初始化 — project-init

D. 打印完成横幅并进入 A1

向用户输出：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 [project-init] 项目初始化完成

 已创建：
   ✓ CLAUDE.md（从插件模板复制）
   ✓ docs/01-需求清单/index.md（待人工填写模块索引）
   ✓ docs/04-技术规范.md（默认技术栈，A1 让用户确认）
   ✓ docs/08-模块任务管理.md（全流程进度跟踪）
 已勾选：A0 项目初始化

 下一步：A1 scope-lock（填写项目概述 + 技术栈 + 需求索引 + REQ 卡片）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

立即调用 Skill(scope-lock) 进入 A1，不等用户手动输入。

参考

• ${CLAUDE_SKILL_DIR}/templates/CLAUDE-template.md（项目级 CLAUDE.md 模板）
• ${CLAUDE_SKILL_DIR}/templates/docs-01-index-template.md（需求索引初稿）
• ${CLAUDE_SKILL_DIR}/templates/docs-04-stack-template.md（默认技术栈）
• ${CLAUDE_SKILL_DIR}/templates/docs-08-initial-template.md（A 阶段进度初始化）
• 下游：scope-lock（A1，自动派发）