seewis-hsl-ui/.claude/skills/athena-init/SKILL.md

name, description, effort, disable-model-invocation

name	description	effort	disable-model-invocation
athena-init	项目初始化。每个新项目首次使用 Athena 时运行。扫描项目、生成环境脚本、创建 .ai_state/ schema。	xhigh	true

/athena-init — 项目初始化

参考: https://code.claude.com/docs/en/skills

1. CC 原生初始化

无 CLAUDE.md → 运行 /init, 生成后追加: "本项目使用 VibeCoding Athena, 开发用 /athena-dev" 已有 CLAUDE.md → 跳过。

2. 项目扫描

ls package.json pyproject.toml Cargo.toml go.mod build.gradle pom.xml 2>/dev/null
cat package.json 2>/dev/null | grep -A5 '"scripts"'
ls jest.config* vitest.config* pytest.ini .eslintrc* ruff.toml biome.json 2>/dev/null

3. 创建 .ai_state/ 目录树 (v9.6 schema)

mkdir -p .ai_state/details/reviews
mkdir -p .ai_state/details/tasks-archive

4. 拷贝模板到 .ai_state/

从 ~/.claude/skills/pace/templates/ 复制 (必须全部, 缺一不可):

• _index.md → .ai_state/_index.md (单一入口, 铁律 8)
• details/tasks-current.md
• details/progress.md
• details/design.md
• details/handoff.md
• details/lessons.md
• details/review-report.md → .ai_state/details/reviews/template.md
• details/next.md
• details/proposals.md
• init.sh → .ai_state/init.sh

5. 填充 _index.md frontmatter

把扫描结果写入:

• tech_stack (检测到的: node/python/rust/go)
• test_cmd (从 package.json scripts.test 或 pytest 等)
• build_cmd
• lint_cmd
• dev_cmd

填充 platform_features (用 claude --version 和 codex --version 2>&1):

• cc_version
• cx_version
• goal_supported: 解析 cc_version, ≥ "2.1.139" 即 true
• batch_supported: ≥ "2.1.121"
• background_supported: ≥ "2.1.139"
• session_memory_active: 检测 ~/.claude/projects/ 是否含 session-memory 子目录
• cross_session_memory: 检测 ~/.claude/plugins/ 含 claude-mem 则 "claude-mem", 含 superpowers 则 "superpowers", 否则 "none"

6. 生成 init.sh

根据扫描结果定制 .ai_state/init.sh:

• 依赖安装命令 (npm install / pip install / cargo build)
• dev server 启动 (如有)
• 基线测试命令
• chmod +x .ai_state/init.sh

7. .gitignore

grep -q '.ai_state' .gitignore 2>/dev/null || echo '.ai_state/' >> .gitignore

8. 跨项目记忆推荐 (替代删除的全局 lessons)

# 检测 claude-mem 或 superpowers, 缺则软提示
if ! ls ~/.claude/plugins/ 2>/dev/null | grep -iE 'claude-mem|superpowers' > /dev/null; then
  echo "💡 推荐装 claude-mem (89k stars) 做跨项目记忆"
  echo "   /plugin install claude-mem (待加入官方 marketplace)"
  echo "   或: /athena-setup 走完整推荐流"
fi

9. Git commit

git add .ai_state/ .gitignore
git commit -m "athena: project initialized (v9.6 schema)"

10. 验证

运行 bash .ai_state/init.sh 确认脚本正常。 告知用户: "Athena 已就绪。用 /athena-dev <需求> 开始开发, 或 /athena-status 看面板。"

已有 .ai_state/ 但 schema_version != "9.6" → 提示运行 /athena-migrate 升级。 已有 .ai_state/ 且 schema_version == "9.6" → 提示用户是否重新初始化 (会重置 _index.md)。