new-work について
new-workは、YAMLのステータス情報を含むMarkdownファイルで作業を記録するエージェントスキルです。計画や進捗を残し、後のセッションで作業を再開できます。
主な機能
- 01日付付きのTodoファイル作成
- 02YAMLでステータスやリンクを記録
- 03完了項目をdoneフォルダーへ移動
- 04進捗や決定事項を継続して更新
活用シーン
- 01後のセッションで再開する計画の記録
- 02タスクの進捗、問題、重要な決定の追跡
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ posit-dev/ skills --skill new-workインストール後、Claude Code で/new-workを入力して読み込まれたか確認します。
詳細
新しい作業
Todo ノートでは、ステータス、コンテキスト、進捗を記録した YAML フロントマター付きの Markdown ファイルで作業項目を管理します。
保存場所
リポジトリのルートに _dev/todos/ が存在する場合は使用してください。存在しない場合は、Todo ノートを作成する前に、保存場所をユーザーに確認してください。このディレクトリには、pending/(進行中)と done/(完了済み)の 2 つのサブディレクトリがあります。
ファイル名
YYYY-MM-DD_short-kebab-slug.md。例:2026-02-18_add-oauth-support.md。
ファイルの内容
YAML フロントマターと 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のリンクがある場合は追加します。Work Items を完了としてチェックします(- [ ]→- [x])。重要な決定は Decision Log に記録します。 - 完了:
status: doneに設定し、ファイルをpending/からdone/にmvで移動します。
ドキュメントを最新の状態に保つ
このセッションの残りの間、Todo を随時更新する記録として扱ってください。決定、新たに発見した問題や要件、提起/解決された課題、重要な実装作業、またはコミットの後には更新してください。迷った場合は更新してください。
計画を立てたら、ユーザーの依頼に応じた場合でも、自発的に立てた場合でも、チャットで伝えるだけでなく Todo ドキュメントに記録してください。永続的な記録はドキュメントであり、チャットではありません。
次のセッションで作業を再開するには、/working-on <path-to-todo> を使用してください。ファイルを再作成せずに、同じようにドキュメントを随時更新する動作を適用します。