# Work Buddy「拾光」操作澄心日记指南

## Skill 入口

澄心日记操作已安装为 `taskboard-manager` Skill：

- Work Buddy：`C:\Users\42537\.workbuddy\skills\taskboard-manager\`
- Codex：`C:\Users\42537\.codex\skills\taskboard-manager\`

可直接对拾光说“看看今天的任务”“新增一个论文任务”“把某任务改成进行中”等；在 Codex 中也可显式使用 `$taskboard-manager`。首次安装后如当前会话未发现 Skill，重新打开一个会话即可。

## 固定入口

```text
D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe
```

拾光必须通过 CLI 操作任务，禁止直接改写 `D:\拾光记忆\taskboard.json`。CLI 会统一处理跨进程锁、原子写入、备份、状态计时和自动归档；桌面看板会在修改后自动刷新。

## 查询任务

```powershell
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' list --date today
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' list --date all --project '论文'
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' list --status '已停滞'
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' list --search '评审老师'
```

更新任务前先查询并取得准确的任务 `Id`，不要仅凭名称猜测。

## 新建任务

```powershell
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' add `
  --name '联系评审老师' --project '论文' --priority P0 `
  --status '待开始' --previous-step '上周发了邮件' --next-step '周一上午电话联系' --date today
```

## 修改任务

```powershell
# 直接修改状态
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' status --id 35 --value '进行中'

# 直接修改优先级
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' priority --id 35 --value P1

# 同时修改多个字段（包括上一步/下一步备忘录）
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' edit `
  --id 35 --name '联系评审老师并确认时间' --previous-step '已发送微信' --date 2026-06-22
```

状态可使用：`待开始`、`进行中`、`已完成`、`已停滞`。优先级可使用：`P0`、`P1`、`P2`、`P3`。

## 删除、归档与恢复

```powershell
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' delete --id 35
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' archive
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' restore --id 35
```

## 项目统计与帮助

```powershell
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' projects
& 'D:\拾光记忆\任务看板\chengxin_app\TaskBoard.Cli.exe' help
```

## 返回约定

- 标准输出：UTF-8 JSON，可直接交给 Work Buddy 解析。
- 返回码 `0`：操作成功。
- 返回码 `2`：参数错误、任务不存在或数据暂时被占用；拾光应读取 `error` 字段并向曦说明。
- 所有包含空格或中文标点的参数必须使用引号包裹。
- 删除属于不可逆业务操作，拾光执行前必须先向曦确认任务名称和 ID。
