Eo Project Update

eo-project-update

功能

更新项目的进度、阶段状态、决策记录，同步刷新项目日志；若 .eo-project.json 配了 kanban_path，同步看板。

配置与目录约定见 [eo-project-init/references/config.md](../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. 执行对应操作

任务完成

1. 读取当前活跃 phase（/phases/phase-N-*.md 中 status: active）
2. 找到匹配的 - [ ] 改为 - [x]
3. 更新 phase frontmatter 的 updated

阶段切换

1. 当前 phase status: done
2. 下一个 phase status: active
3. 更新 /roadmap.md 阶段概览
4. 若全部完成，提示是否归档

决策记录

1. /decisions/ 若不存在则创建
2. 读取最大编号 +1，创建 decisions/{NNN}-{决策简述}.md：

---
type: decision
project: "项目名"
date: YYYY-MM-DD
status: accepted
---

# {决策简述}

## 背景

{为什么要做这个决策}

## 选项

1. **{选项A}** — {优劣}
2. **{选项B}** — {优劣}

## 决定

选择 {选项X}，因为 {理由}。

## 后果

{预期影响}

1. 从用户输入提炼填充，推断不了的标 "待补充"

阻塞标记

记录阻塞原因，更新看板（若有）。

3. 追加项目日志

在 /log.md 顶部追加：

## [YYYY-MM-DD] {update_type} | {简述}
- {具体变更}

4. 刷新项目看板（仅 kanban_path 非空）

读取 kanban_path，更新对应项目条目：

### 项目名
- 状态：`active`
- 当前阶段：[[phase-N-xxx]] — 进度描述
- 下一步：{下一个待办任务}
- 阻塞：{阻塞原因 或 无}
- 决策记录：[[NNN-最新决策]]
- 经验教训：N 条

字段更新规则：

• 当前阶段：活跃 phase 完成比例（[x] 数 / 总数）
• 下一步：活跃 phase 第一个 - [ ]
• 决策记录：最近一条（多条用 等 N 条）
• 经验教训：读 /lessons/ 中条目数

kanban_path: null 时跳过本步。

5. 输出摘要

向用户展示：

• 更新了什么
• 当前项目状态（阶段 + 进度 + 下一步）

输出

• Phase 文件更新：/phases/phase-N-*.md
• 决策文件（按需）：/decisions/NNN-*.md
• 项目日志：/log.md
• 看板刷新（可选）：kanban_path 指向文件

约束

• 不修改 roadmap.md 的目标和阶段划分（只更新状态标记）
• 决策记录一旦 accepted 不可修改内容，只能新建覆盖
• 所有路径通过 .eo-project.json 解析，不硬编码
• project_root 不可达 → 报错提示检查配置
• kanban_path: null 时全程不碰看板
• lazy 创建 decisions/（本 skill 首次写决策时建）

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: SimpleEve
• Source: SimpleEve/eo-skills
• License: MIT

Install and usage instructions live in the source repository linked above.