mcpField
N
new-work

new-work

github.com/posit-devAgent 工作流551339 次安装今天更新
代码仓库

关于 new-work

new-work 是用于管理会话工作事项的 Agent 技能，以带 YAML 状态信息的 Markdown 文件记录进度，便于后续恢复工作。

主要功能

  1. 01按日期命名待办文件
  2. 02用 YAML 记录状态和链接
  3. 03在待办与已完成目录间移动
  4. 04持续更新决策与进度

适用场景

  1. 01记录可供后续会话恢复的工作计划
  2. 02跟踪任务进度、问题和重要决定

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posit-dev/skills --skill new-work

安装后在 Claude Code 中输入/new-work确认已加载。

详细介绍

新建工作项

待办事项笔记以 Markdown 文件的形式跟踪工作项，并通过 YAML front matter 记录状态、背景和进度。

存储位置

如果仓库根目录中存在 _dev/todos/，请使用该目录；否则，在创建任何内容之前，先询问用户将待办事项笔记存放在哪里。该目录包含两个子目录：pending/（进行中）和 done/（已完成）。

文件命名

YYYY-MM-DD_short-kebab-slug.md，例如 2026-02-18_add-oauth-support.md。

文件内容

YAML front matter 加上 Markdown 正文。只有 status 是必填项。

---
status: pending   # pending | in progress | review | blocked | done
issue: https://github.com/org/repo/issues/123   # optional
pr: https://github.com/org/repo/pull/456        # optional
---

# Title

Overview of what this is about and why it matters.

## Key Files

- `src/relevant-file.ts` — what it does
- `src/other-file.ts:functionName()` — why it matters

## Work Items

- [ ] First thing to do
- [ ] Second thing to do

## Design Decisions

Context, constraints, or choices worth capturing.

## Decision Log

生命周期

  • 创建： 如有需要，创建 pending/；创建带日期前缀的文件并设置 status: pending，写入足够的背景信息，以便之后继续处理。
  • 进行中： 更新 status；有相关链接时添加 issue/pr 链接；勾选工作项（- [ ] → - [x]）；在决策日志中记录重要决策。
  • 完成： 设置 status: done，并将文件从 pending/ 移至 done/。

保持文档更新

在本次会话的其余时间里，将待办事项视为持续更新的记录。在作出任何决策、发现新的问题或要求、提出或解决问题、完成重要实现工作或提交代码后，都要更新文档。如有疑问，就更新文档。

制定计划时，无论是响应用户请求还是主动提出计划，都应将计划写入待办事项文档，而不应只在聊天中展示。文档是持久记录；聊天不是。

要在未来的会话中继续处理，请使用 /working-on <path-to-todo> —— 无需重新创建文件，即可继续使用同样的实时文档行为。

评论

支持 Markdown