| name | eo-project-update |
| description | 更新项目进度、阶段状态、决策记录，并同步项目看板（若配置）。通过 .eo-project.json 定位项目。触发：更新项目 / 同步进展 / 记录决策 / 阶段完成 / /eo-project-update。 |
eo-project-update
功能
更新项目的进度、阶段状态、决策记录，同步刷新项目日志；若 .eo-project.json 配了 kanban_path，同步看板。
配置与目录约定见 eo-project-init/references/config.md。
前置
必须能找到 .eo-project.json（cwd 或父目录）。找不到时报错退出，提示运行 /eo-project-init。
输入
- 进度更新："D6 完成了"、"任务 X 搞定"
- 阶段切换："phase 1 完成，进入 phase 2"
- 决策记录："决定用 Vue 而不是 React"
- 阻塞标记："被 XX 卡住了"
- 自由更新：其它情况追加 log
路径解析
从 .eo-project.json 读取：
project_root — 项目管理侧绝对路径，所有项目侧文件均在此目录下kanban_path — 看板绝对路径；为 null 时全程不碰看板
所有 skill 内部操作一律通过这两个字段定位，不硬编码。
执行步骤
1. 解析更新类型
| 类型 | 信号词 | 操作 |
|---|
| 任务完成 | "完成"、"搞定"、"done" | 勾选 phase 中的任务 |
| 阶段切换 | "阶段完成"、"进入下一阶段" | 切换 phase status |
| 决策记录 | "决定"、"选择"、"决策" | 创建 decisions/ 文件（目录不存在时 lazy 建） |
| 阻塞标记 | "卡住"、"blocked"、"阻塞" | 更新看板阻塞字段（若有看板） |
| 自由更新 | 其他 | 追加 log |
2. 执行对应操作
任务完成
- 读取当前活跃 phase（
<project_root>/phases/phase-N-*.md 中 status: active）
- 找到匹配的
- [ ] 改为 - [x]
- 更新 phase frontmatter 的
updated
阶段切换
- 当前 phase
status: done
- 下一个 phase
status: active
- 更新
<project_root>/roadmap.md 阶段概览
- 若全部完成，提示是否归档
决策记录
<project_root>/decisions/ 若不存在则创建- 读取最大编号 +1，创建
decisions/{NNN}-{决策简述}.md：
---
type: decision
project: "项目名"
date: YYYY-MM-DD
status: accepted
---
# {决策简述}
## 背景
{为什么要做这个决策}
## 选项
1. **{选项A}** — {优劣}
2. **{选项B}** — {优劣}
## 决定
选择 {选项X}，因为 {理由}。
## 后果
{预期影响}
- 从用户输入提炼填充，推断不了的标 "待补充"
阻塞标记
记录阻塞原因，更新看板（若有）。
3. 追加项目日志
在 <project_root>/log.md 顶部追加：
## [YYYY-MM-DD] {update_type} | {简述}
- {具体变更}
4. 刷新项目看板（仅 kanban_path 非空）
读取 kanban_path，更新对应项目条目：
### 项目名
- 状态：`active`
- 当前阶段：[[phase-N-xxx]] — 进度描述
- 下一步：{下一个待办任务}
- 阻塞：{阻塞原因 或 无}
- 决策记录：[[NNN-最新决策]]
- 经验教训：N 条
字段更新规则：
- 当前阶段：活跃 phase 完成比例（
[x] 数 / 总数）
- 下一步：活跃 phase 第一个
- [ ]
- 决策记录：最近一条（多条用
等 N 条）
- 经验教训：读
<project_root>/lessons/ 中条目数
kanban_path: null 时跳过本步。
5. 输出摘要
向用户展示：
- 更新了什么
- 当前项目状态（阶段 + 进度 + 下一步）
输出
- Phase 文件更新：
<project_root>/phases/phase-N-*.md
- 决策文件（按需）：
<project_root>/decisions/NNN-*.md
- 项目日志：
<project_root>/log.md
- 看板刷新（可选）：
kanban_path 指向文件
约束
- 不修改
roadmap.md 的目标和阶段划分（只更新状态标记）
- 决策记录一旦
accepted 不可修改内容，只能新建覆盖
- 所有路径通过
.eo-project.json 解析，不硬编码
project_root 不可达 → 报错提示检查配置kanban_path: null 时全程不碰看板- lazy 创建
decisions/（本 skill 首次写决策时建）
