with one click
athena-dev
// Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.6.4 升级: 加 brainstorm + roadmap 分诊 (铁律 14), 加路由检测自动 ultrathink 提示.
// Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.6.4 升级: 加 brainstorm + roadmap 分诊 (铁律 14), 加路由检测自动 ultrathink 提示.
检查项目依赖 (库 / 包 / jar) 是否有可升级版本, 适配多生态: Maven / npm·pnpm·yarn·bun / PyPI / Cargo / Go / RubyGems / Composer / NuGet. 铁律: 版本号必须从官方 registry 在线查询, 不靠记忆/编造, 且区分 "声明的版本是否存在" 与 "是否最新". 用户要求"看有没有要更新的依赖"时使用.
维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).
Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.
Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).
PACE review stage 执行 skill. v9.6.4 升级: 6 维度 (并行 spawn 3 subagent: reviewer + spec-compliance + evaluator).
快速查看当前项目的 Athena 状态: stage / path / sprint / 进度 / 活动 worktree. 无副作用, 只读.
| name | athena-dev |
| description | Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.6.4 升级: 加 brainstorm + roadmap 分诊 (铁律 14), 加路由检测自动 ultrathink 提示. |
| effort | medium |
用户进任意项目, 说 "开始", "做个 X", "帮我 Y" 等. 主 agent 进入路由分诊.
def route(user_input, ai_state):
# 0. 检查是否在 Athena 项目中
if not has_ai_state_dir():
suggest("先跑 /athena-init 初始化项目")
return None
# 1. 显式信号优先 (用户直接说)
if explicit_kws(["想法不清楚", "先 brainstorm", "讨论", "聊聊"]):
return start_stage("brainstorm")
if explicit_kws(["路线图", "拆分", "分步推进"]):
return start_stage("roadmap")
if explicit_kws(["生产事故", "线上故障", "hotfix"]):
return start_stage("plan", path="Hotfix")
if explicit_kws(["bug", "缺陷", "修复"]):
return start_stage("plan", path="Bugfix")
if explicit_kws(["重构", "refactor"]):
return start_stage("plan", path="Refactor")
if explicit_kws(["系统级", "跨模块", "架构"]):
return start_stage("plan", path="System")
# 2. 隐式判断 (铁律 14)
if len(user_input.split()) < 8 and not has_concrete_verb(user_input):
# 单词级模糊 → brainstorm
return start_stage("brainstorm")
if mentions_modules(user_input) >= 3:
# ≥3 模块 → roadmap
return start_stage("roadmap")
# 3. 默认: 按改动量分类
estimated = estimate_scope(user_input)
if estimated == "tiny":
return start_stage("plan", path="Quick") # ≤3 文件
if estimated == "single_module":
return start_stage("plan", path="Feature")
if estimated == "multi_module":
return start_stage("plan", path="System")
return start_stage("plan", path="Feature") # fallback
# 创建 sprint 目录
slug="$(date +%Y-%m-%d)-$(slugify '$user_topic')"
mkdir -p ".ai_state/sprints/${slug}"
cp ~/.claude/skills/pace/templates/sprints/brainstorm.md ".ai_state/sprints/${slug}/"
# 更新 _index.md
update_field stage "brainstorm"
update_field current_sprint_slug "${slug}"
# 进 brainstorm skill
read ~/.claude/skills/brainstorm/SKILL.md
# 多轮对话
slug="$(slugify '$user_topic')"
mkdir -p ".ai_state/roadmap/${slug}/drafts"
cp ~/.claude/skills/pace/templates/roadmap/{roadmap.md,items.yaml} ".ai_state/roadmap/${slug}/"
update_field stage "roadmap"
update_field current_roadmap_slug "${slug}"
read ~/.claude/skills/roadmap/SKILL.md
slug="$(date +%Y-%m-%d)-$(slugify '$task_name')"
mkdir -p ".ai_state/sprints/${slug}/reviews"
cp ~/.claude/skills/pace/templates/sprints/{design.md,checklist.yaml} ".ai_state/sprints/${slug}/"
update_field path "${path_type}"
update_field stage "plan"
update_field current_sprint_slug "${slug}"
# 主 agent 在第一条 message 加 "ultrathink"
# 进 pace skill
主 agent 进 athena-dev 时, 先读 _index.next_action:
| next_action 值 | 动作 |
|---|---|
"" (空) | 正常路由 |
next_roadmap_item:{slug} | 自动进 plan stage 处理新 item, 跳过路由 |
roadmap_complete | 提示用户庆祝 + 触发 /compound add learning |
polish | 自动进 polish stage |
ship | 自动进 ship stage |
rework_impl | 回 impl stage, 提示 review findings |
进 plan/design stage 时, athena-dev 必须在主 agent 第一条 message 加 "ultrathink" 关键词. 这由 SessionStart hook (session-start.cjs) 通过 stage_hints 自动提示.
| 用户意图 | 进哪个 skill |
|---|---|
| 开始任务 | athena-dev (这个) |
| 想法不清楚 | brainstorm |
| 拆大需求 | roadmap |
| 全流程开发 | pace |
| 完成总结 | athena-status |
| 跨版本迁移 | athena-migrate |
| 项目初始化 | athena-init |
| 沉淀知识 | compound |
| 维护架构档 | architect-doc |
| review 复杂改动 | athena-review |
--skip-brainstorm → 跳过 brainstorm_index.md 确定当前状态