| name | upaseo-todo |
| description | 项目待办记录技能。用户提到 todo、TODO、待办、记一下、加入待办、backlog、 后续要做、ship 后关闭等场景时使用，把待办写入项目根目录 .paseo/todos.md， 并在需要时更新完成、延期或取消状态。 |
Upaseo Todo Skill
User's request: $ARGUMENTS
本技能只做一件事：把项目级待办沉淀到一个可审计的文件里，避免 todo 散落在对话、计划和 compact 摘要中。
Core Rule
只要用户明确提到 todo、TODO、待办、记一下、加入待办、backlog、后续要做 等表达，就必须更新：
<项目根目录>/.paseo/todos.md
不要只在对话里答应。.paseo/todos.md 是项目待办的 Source of Truth。
Step 0: 避障读取
执行标准避障前置读取，见 upaseo/references/learnings-precheck.md。本技能相关 category 为 command_error|tool_misuse。提炼与范围控制、重复记录、发布收尾、工作区安全相关的避障规则。
Step 1: 自愈 todo 文件
若 .paseo/ 不存在，先创建。若 .paseo/todos.md 不存在，创建以下模板：
# Upaseo Project Todos
This file is the Source of Truth for project-level todos captured by `/upaseo-todo`.
## Active
## Done
## Deferred
## Cancelled
## Change Log
Step 2: 记录或更新
根据用户意图选择最小动作：
- 新增：在
## Active 下追加一条未完成 todo。
- 完成：把对应条目标记为完成并移到
## Done，或在原条目上改为 [x]。
- 延期：移到
## Deferred，保留原因。
- 取消：移到
## Cancelled，保留原因。
- 查询：读取并概述当前 todo，不改文件。
新增条目格式：
- [ ] T-YYYYMMDD-HHMM-<slug> | <title> | source: <user/plan/ship/simplify> | type: <task|debt> | created: YYYY-MM-DD | links: <plan/file:line/none> | note: <short context>
type 字段缺省为 task。type: debt 用于登记精简阶梯（upaseo/references/simplify-ladder.md）为求简而取的延迟债务：note 写"捷径描述 + 被推迟的正确做法"，source 填 simplify，links 指向关联代码 file:line。debt 条目默认进 ## Active，由 upaseo-ship 发布前复核。
状态更新格式：
- [x] T-YYYYMMDD-HHMM-<slug> | <title> | source: <user/plan/ship/simplify> | type: <task|debt> | created: YYYY-MM-DD | completed: YYYY-MM-DD | shipped: <version/date/none> | links: <plan/file:line/none> | note: <short result>
Matching Rules
- 新增前先扫描
## Active，如果已有语义相同的 todo，只补充 note 或 links，不重复创建。
- debt 条目（
type: debt）同样进 ## Active，按捷径描述语义去重：若同一捷径已登记，只补充 links/note，不重复建条目。
- 如果用户说“这个 todo 完成了”“关闭上一个 todo”，优先匹配最近新增或标题最接近的 Active 条目。
- 如果无法安全匹配完成/取消对象，不要猜；先列出候选并问用户确认。
- 用户只随口提到普通英文单词
todo 但没有待办内容时，不写入文件，先问一句要记录什么。
Ship Integration
/upaseo-ship 必须读取 .paseo/todos.md。发布收尾时：
- 根据本次主计划、CHANGELOG、release notes 和实际 diff，找出与本次发布明确对应的 Active todo。
- 只关闭有证据证明已经交付的 todo。
- 将这些 todo 标记为
[x]，写入 completed: 和 shipped:。
- 无法确认的 todo 保持 Active，并在 ship 输出中报告“仍未关闭”。
Output Format
完成后简短输出：
已更新 todo：
<absolute path to .paseo/todos.md>
变更：
- <新增/完成/延期/取消/查询摘要>
验证：
- <文件存在、条目 id、必要状态>
Quality Bar
- 不丢上下文：待办必须包含来源、日期、短说明和相关文件/计划链接。
- 不制造噪音：语义重复的 todo 合并，不爆炸式追加。
- 不误关任务：ship 只能关闭有证据的项。
- 可恢复：新 Agent 只读
.paseo/todos.md 就知道还有哪些项目债务。
