[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F53DP7985WDXX5111JSEMV":3,"skill-same:01M7F53DP7985WDXX5111JSEMV":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":45},"01M7F53DP7985WDXX5111JSEMV","skill-task-management",null,"Manage tasks with Claude Code native tools — use to track TODOs, delegate work, and monitor progress","lza6\u002FArmor-piercing-system-prompts","lza6","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F128880206?v=4","01M7EB3K7WPX5T28EJ2NVHE6EG","Chinese-tingfeng","01M7EB3K97E1KQ16QWKJMFNGX8",11,"MIT","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F05-技能与代理开发\u002Fskill-task-management\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: skill-task-management\ndescription: \"Manage tasks with Claude Code native tools — use to track TODOs, delegate work, and monitor progress\"\ndisable-model-invocation: true\n---\n\n> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.\n> Cross-reference commands use installed skill names in Codex rather than `\u002Focto:*` slash commands.\n> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.\n> For host tool equivalents, see `skills\u002Fblocks\u002Fcodex-host-adapter.md`.\n\n\n# Task Management & Orchestration (v7.23.0+)\n\n## Overview\n\nSystematic task orchestration for multi-step work, progress checkpointing, and seamless task resumption across sessions.\n\n**Core principle:** Track → Checkpoint → Resume → Complete.\n\n**v7.23.0 Migration:** This skill now uses native Claude Code host subagent tools:\n- `TaskCreate` - Create new tasks\n- `TaskUpdate` - Update task status\u002Fdetails\n- `TaskList` - View all tasks\n- `TaskGet` - Get specific task details\n\n**Benefits:**\n- ✅ Tasks show in native Claude Code UI\n- ✅ Better progress tracking and visualization\n- ✅ Consistent with Claude Code conventions\n- ✅ No dependency on external task plan tool tool\n\n\n## When to Use\n\n**Use this skill when user wants to:**\n- Add items to the todo list\n- Save current progress for later continuation\n- Resume previously saved work\n- Checkpoint progress in long-running tasks\n- Proceed to next steps in a workflow\n- Continue from where they left off\n\n**Do NOT use for:**\n- Creating git commits (use skill-finish-branch)\n- Simple todo list queries (\"what's on my list?\")\n- Task completion that involves pushing code\n\n\n## Core Capabilities\n\n### 1. Adding Tasks to Todo List\n\nWhen user says \"add to the todo's\" or similar:\n\n```markdown\n**What would you like to add to the todo list?**\n\nI'll help you capture this task. Please provide:\n- Task description (what needs to be done)\n- Any dependencies or prerequisites\n- Priority (if applicable)\n```\n\n**After getting details, use TaskCreate to add:**\n\n```javascript\nTaskCreate({\n  subject: \"[Brief task description]\",\n  description: \"[Detailed description including dependencies and context]\",\n  activeForm: \"Working on [task description]\"\n})\n```\n\n**Then confirm to user:**\n\n```\n✅ Task created: [Task description]\n\nView all tasks with TaskList or use \u002Ftasks command.\n```\n\n\n### 2. Saving Progress \u002F Checkpointing\n\nWhen user says \"save progress\" or \"checkpoint this\":\n\n#### Step 1: Assess Current State\n\n```bash\n# Check git status\ngit status\n\n# Check current branch\ngit branch --show-current\n\n# Check uncommitted work\ngit diff --stat\n```\n\n#### Step 2: Create Progress Checkpoint\n\n**Option A: Git-based checkpoint (if git repo)**\n\n```bash\n# Create a work-in-progress commit\ngit add .\ngit commit -m \"WIP: [description of current state]\n\nProgress checkpoint - work in progress\nNot ready for review or merge\n\nCurrent state:\n- [What's completed]\n- [What's in progress]\n- [What's next]\n\nCo-Authored-By: Claude Sonnet 4.6 \u003Cnoreply@anthropic.com>\"\n```\n\n**Option B: Task-based checkpoint (preferred for tracking)**\n\nCreate checkpoint task with detailed state:\n\n```javascript\nTaskCreate({\n  subject: \"Checkpoint: [Brief description]\",\n  description: `\n📍 CHECKPOINT: ${new Date().toISOString()}\n\nCompleted:\n✓ [Task 1]\n✓ [Task 2]\n\nIn Progress:\n⚙️ [Current task with details]\n\nNext Steps:\n- [ ] [Next task 1]\n- [ ] [Next task 2]\n- [ ] [Next task 3]\n\nContext:\n- Branch: ${branchName}\n- Last commit: ${lastCommit}\n- Files changed: ${filesChanged}\n  `,\n  activeForm: \"Checkpoint saved\"\n})\n```\n\n#### Step 3: Update Existing Tasks\n\nMark completed tasks as done:\n\n```javascript\n\u002F\u002F For each completed task\nTaskUpdate({\n  taskId: \"[task-id]\",\n  status: \"completed\"\n})\n```\n\nMark current task as in_progress:\n\n```javascript\nTaskUpdate({\n  taskId: \"[current-task-id]\",\n  status: \"in_progress\"\n})\n```\n\n#### Step 4: Provide Resume Instructions\n\n```markdown\n✅ Progress saved!\n\nTo resume this work:\n1. Run: git checkout [branch-name]\n2. View tasks: TaskList\n3. Say: \"resume tasks\" or \"pick up where we left off\"\n\nCurrent state:\n- Branch: [branch-name]\n- Tasks: [X completed, Y in progress, Z pending]\n- Last checkpoint: [timestamp]\n```\n\n\n### 3. Resuming Tasks\n\nWhen user says \"resume tasks\" or \"pick up where we left off\":\n\n#### Step 1: Load Task State\n\n```javascript\n\u002F\u002F Get all tasks\nconst tasks = TaskList()\n\n\u002F\u002F Filter by status\nconst completed = tasks.filter(t => t.status === 'completed')\nconst inProgress = tasks.filter(t => t.status === 'in_progress')\nconst pending = tasks.filter(t => t.status === 'pending')\n\n\u002F\u002F Find checkpoint task (if exists)\nconst checkpoint = tasks.find(t => t.subject.startsWith('Checkpoint:'))\n```\n\n#### Step 2: Check Git State\n\n```bash\n# Check for WIP commits\ngit log --oneline -10 | grep WIP\n\n# Check current branch\ngit branch --show-current\n\n# Check git status\ngit status\n```\n\n#### Step 3: Present Current State\n\n```markdown\n📋 **Resuming from last checkpoint**\n\n**Branch:** [branch-name]\n**Last checkpoint:** [timestamp from WIP commit or checkpoint task]\n\n**Completed:** (${completed.length} tasks)\n${completed.map(t => `✓ ${t.subject}`).join('\\n')}\n\n**In Progress:** (${inProgress.length} tasks)\n${inProgress.map(t => `⚙️ ${t.subject}`).join('\\n')}\n\n**Next Steps:** (${pending.length} tasks)\n${pending.map((t, i) => `${i + 1}. [ ] ${t.subject}`).join('\\n')}\n\n**Would you like me to:**\n1. Continue with the next task?\n2. Modify the plan?\n3. See more details about current state?\n```\n\n#### Step 4: Execute Based on Choice\n\n- If \"continue with next task\" → Get first pending task, mark as in_progress, and begin work:\n  ```javascript\n  const nextTask = pending[0]\n  TaskUpdate({ taskId: nextTask.id, status: 'in_progress' })\n  \u002F\u002F Begin working on nextTask\n  ```\n\n- If \"modify the plan\" → Use AskUserQuestion to understand changes, then update tasks\n\n- If \"see more details\" → Show git diff, file changes, recent commits, task descriptions\n\n\n### 4. Proceeding to Next Steps\n\nWhen user says \"proceed to next steps\":\n\n#### Step 1: Check Current Task Status\n\n```javascript\nconst tasks = TaskList()\nconst currentTask = tasks.find(t => t.status === 'in_progress')\n\nif (currentTask) {\n  console.log(`Current task: ${currentTask.subject}`)\n  console.log(`Status: ${currentTask.status}`)\n}\n```\n\n#### Step 2: Complete Current and Move Forward\n\n```javascript\n\u002F\u002F Mark current task as complete\nif (currentTask) {\n  TaskUpdate({\n    taskId: currentTask.id,\n    status: 'completed'\n  })\n  console.log(`✓ ${currentTask.subject}`)\n}\n\n\u002F\u002F Get next pending task\nconst nextTask = tasks.find(t => t.status === 'pending' && !t.blockedBy?.length)\n\nif (nextTask) {\n  \u002F\u002F Mark as in progress\n  TaskUpdate({\n    taskId: nextTask.id,\n    status: 'in_progress'\n  })\n  console.log(`\\n⚙️ ${nextTask.subject}`)\n  console.log(`\\nProceeding with: ${nextTask.description}`)\n}\n```\n\n#### Step 3: Execute Next Task\n\nBegin working on the next task immediately after marking it as in_progress.\n\n\n## Migration from task plan tool (v7.22.x → v7.23.0+)\n\n### For Users with Existing .md Todo Files\n\nIf you have existing `.claude\u002Ftodos.md` or similar files:\n\n#### Option 1: Automatic Migration\n\n```bash\n# Run migration script\n\"${HOME}\u002F.claude-octopus\u002Fplugin\u002Fscripts\u002Fmigrate-todos.sh\"\n```\n\nThis will:\n1. Parse existing .md todo files\n2. Convert to TaskCreate calls\n3. Preserve task order and status\n4. Archive old .md files to `.claude\u002Farchived-todos\u002F`\n\n#### Option 2: Manual Migration\n\nFor each todo item in your .md file:\n\n```markdown\n\u003C!-- Old format in todos.md -->\n- [ ] Implement user authentication\n- [x] Set up database\n- [ ] Create API endpoints\n```\n\nConvert to:\n\n```javascript\n\u002F\u002F New format using native tasks\nTaskCreate({\n  subject: \"Implement user authentication\",\n  description: \"Create auth system with JWT tokens\",\n  activeForm: \"Implementing authentication\"\n})\n\nTaskCreate({\n  subject: \"Set up database\",\n  description: \"Configure PostgreSQL and run migrations\",\n  activeForm: \"Setting up database\"\n})\n\u002F\u002F Mark as completed since it was [x]\nTaskUpdate({ taskId: \"...\", status: \"completed\" })\n\nTaskCreate({\n  subject: \"Create API endpoints\",\n  description: \"Build REST API for user operations\",\n  activeForm: \"Creating API endpoints\"\n})\n```\n\n### Backward Compatibility\n\n**Opt-out for users who prefer old system:**\n\nCreate `.claude\u002Fclaude-octopus.local.md` with:\n\n```yaml\nuse_native_tasks: false\n\n# Claude Octopus Local Configuration\n\nThis project uses legacy task plan tool tool instead of native Task management.\n```\n\nWhen `use_native_tasks: false`, skill falls back to task plan tool behavior.\n\n\n## Integration with Other Skills\n\n### With skill-finish-branch\n\n```\nUser: \"save progress and prepare for PR\"\n\n1. Use skill-task-management to checkpoint (create tasks for current state)\n2. Then use skill-finish-branch to prepare PR\n```\n\n### With flow-develop\n\n```\nUser: \"add implementation of auth system to todos\"\n\n1. Use skill-task-management to add high-level task\n2. Use flow-develop to break down and implement\n3. Update tasks as work progresses\n```\n\n### With skill-debug\n\n```\nUser: \"checkpoint this, I found a bug\"\n\n1. Use skill-task-management to save current progress (checkpoint task)\n2. Use skill-debug to investigate the bug\n3. Return to saved checkpoint after fix\n```\n\n\n## Best Practices\n\n### 1. Clear Task Subjects and Descriptions\n\n**Good task:**\n```javascript\nTaskCreate({\n  subject: \"Implement token refresh with 15-minute expiration\",\n  description: `\nCreate token refresh endpoint that:\n- Validates refresh token from secure HTTP-only cookie\n- Issues new access token with 15min expiry\n- Rotates refresh token for security\n- Returns 401 if refresh token invalid\u002Fexpired\n\nDependencies: OAuth provider setup must be complete\n  `,\n  activeForm: \"Implementing token refresh logic\"\n})\n```\n\n**Poor task:**\n```javascript\nTaskCreate({\n  subject: \"Do auth stuff\",\n  description: \"Fix things\",\n  activeForm: \"Working\"\n})\n```\n\n### 2. Use Task Dependencies\n\nFor tasks with prerequisites:\n\n```javascript\n\u002F\u002F First task\nTaskCreate({\n  subject: \"Set up OAuth provider configuration\",\n  description: \"Configure Auth0 application settings\",\n  activeForm: \"Configuring OAuth provider\"\n})\n\n\u002F\u002F Dependent task\nTaskCreate({\n  subject: \"Implement token refresh endpoint\",\n  description: \"Create \u002Fauth\u002Frefresh endpoint\",\n  activeForm: \"Implementing refresh endpoint\",\n  addBlockedBy: [\"1\"]  \u002F\u002F Blocked by task #1\n})\n```\n\n### 3. Context Preservation in Checkpoints\n\nWhen checkpointing, always include:\n- What's completed (prevents re-doing work)\n- What's in progress (enables quick resume)\n- What's next (provides clear path forward)\n- Why decisions were made (preserves reasoning)\n\nExample checkpoint task:\n\n```javascript\nTaskCreate({\n  subject: \"Checkpoint: Auth implementation 70% complete\",\n  description: `\n📍 CHECKPOINT: 2026-02-03T14:30:00Z\n\nCompleted:\n✓ OAuth provider configuration (Auth0)\n✓ Token exchange endpoint (\u002Fauth\u002Flogin)\n✓ User session middleware\n\nIn Progress:\n⚙️ Token refresh logic (70% done)\n  - Validation complete\n  - Token rotation TODO\n  - Cookie handling TODO\n\nNext:\n- [ ] Complete token rotation logic\n- [ ] Add logout endpoint\n- [ ] Add session expiration handling\n- [ ] Write integration tests\n\nBranch: feature\u002Fauth-system\nLast commit: abc123f \"Add session middleware\"\n\nDecisions Made:\n- Using Auth0 (rationale: enterprise-grade, handles complexity)\n- 15-minute access token expiry (security vs UX balance)\n- HTTP-only cookies for refresh tokens (XSS protection)\n  `,\n  activeForm: \"Checkpoint saved\"\n})\n```\n\n\n## Common Patterns\n\n### Pattern 1: End-of-Day Checkpoint\n\n```\nUser: \"save progress, I'm done for today\"\n\nAction:\n1. Create WIP commit with current state\n2. Create checkpoint task with completed\u002Fpending breakdown\n3. Mark in-progress tasks with current status\n4. Provide resume instructions for tomorrow\n```\n\n### Pattern 2: Context Switch\n\n```\nUser: \"checkpoint this, need to work on something else\"\n\nAction:\n1. Save current branch state (WIP commit)\n2. Create checkpoint task with detailed context\n3. Mark current task as pending (will resume later)\n4. Ready for resume when user returns\n```\n\n### Pattern 3: Collaboration Handoff\n\n```\nUser: \"save progress for Claude to pick up\"\n\nAction:\n1. Create comprehensive checkpoint task\n2. Document all context and decisions\n3. Mark in-progress tasks with current state\n4. Ensure new session can load task state and resume seamlessly\n```\n\n\n## Red Flags - Don't Do This\n\n| Action | Why It's Wrong |\n|--------|----------------|\n| Checkpoint without documenting context | Next session won't know what was happening |\n| Skip WIP commit for code changes | Lose work if something breaks |\n| Generic \"proceed to next\" without checking TaskList | Might skip incomplete work |\n| Vague task subjects\u002Fdescriptions | Unclear what needs to be done |\n| Resume without showing TaskList state | User doesn't know where they are |\n| Create tasks without activeForm | No progress indication in UI |\n\n\n## Quick Reference\n\n| User Intent | Skill Action | Tool Used |\n|-------------|--------------|-----------|\n| \"add to todos\" | Gather details, create task | TaskCreate |\n| \"save progress\" | Create checkpoint task + WIP commit | TaskCreate + git |\n| \"resume tasks\" | Load task state, show status, ask direction | TaskList |\n| \"proceed to next\" | Complete current, start next | TaskUpdate |\n| \"checkpoint this\" | Create detailed checkpoint task | TaskCreate |\n\n\n## Task Status Workflow\n\n```\npending → in_progress → completed\n                ↓\n              deleted (if no longer needed)\n```\n\n**Best practices:**\n- Create tasks in `pending` state\n- Mark `in_progress` when starting work\n- Mark `completed` only when fully done\n- Use `deleted` for cancelled\u002Fobsolete tasks\n\n\n## The Bottom Line\n\n```\nTask management → Clear state + Easy resume + Native UI\nOtherwise → Lost context + Duplicate work + No visibility\n```\n\n**Track everything. Checkpoint frequently. Resume seamlessly. Use native tools.**\n\n\n## Example: Full Workflow\n\n```javascript\n\u002F\u002F User: \"add implementing auth to my todos\"\n\n\u002F\u002F Step 1: Create main task\nTaskCreate({\n  subject: \"Implement user authentication system\",\n  description: `\nBuild complete auth system with:\n- OAuth 2.0 (Auth0 provider)\n- JWT token management\n- Refresh token rotation\n- Session middleware\n- Logout functionality\n  `,\n  activeForm: \"Planning authentication implementation\"\n})\n\n\u002F\u002F User works on it...\n\n\u002F\u002F User: \"save progress for tomorrow\"\n\n\u002F\u002F Step 2: Create checkpoint\nTaskCreate({\n  subject: \"Checkpoint: Auth implementation in progress\",\n  description: `\n📍 Checkpoint: 2026-02-03T18:30:00Z\n\nCompleted:\n✓ OAuth configuration\n✓ Login endpoint\n\nIn Progress:\n⚙️ Token refresh (50%)\n\nNext:\n- [ ] Complete refresh logic\n- [ ] Add logout\n- [ ] Write tests\n\nBranch: feature\u002Fauth\nCommit: abc123f\n  `,\n  activeForm: \"Checkpoint saved\"\n})\n\n\u002F\u002F Step 3: Update main task status\nTaskUpdate({\n  taskId: \"1\",\n  status: \"in_progress\"\n})\n\n\u002F\u002F User: \"resume tasks\" (next day)\n\n\u002F\u002F Step 4: Load and present state\nconst tasks = TaskList()\n\u002F\u002F Present: \"You have 1 in_progress task, last checkpoint 2026-02-03T18:30:00Z\"\n\u002F\u002F Show details from checkpoint task\n\n\u002F\u002F User: \"continue\"\n\n\u002F\u002F Step 5: Resume work\nconst currentTask = tasks.find(t => t.status === 'in_progress')\n\u002F\u002F Begin working on token refresh where they left off\n```\n","> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.\n> Cross-reference commands use installed skill names in Codex rather than `\u002Focto:*` slash commands.\n> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.\n> For host tool equivalents, see `skills\u002Fblocks\u002Fcodex-host-adapter.md`.\n\n\n# Task Management & Orchestration (v7.23.0+)\n\n## Overview\n\nSystematic task orchestration for multi-step work, progress checkpointing, and seamless task resumption across sessions.\n\n**Core principle:** Track → Checkpoint → Resume → Complete.\n\n**v7.23.0 Migration:** This skill now uses native Claude Code host subagent tools:\n- `TaskCreate` - Create new tasks\n- `TaskUpdate` - Update task status\u002Fdetails\n- `TaskList` - View all tasks\n- `TaskGet` - Get specific task details\n\n**Benefits:**\n- ✅ Tasks show in native Claude Code UI\n- ✅ Better progress tracking and visualization\n- ✅ Consistent with Claude Code conventions\n- ✅ No dependency on external task plan tool tool\n\n\n## When to Use\n\n**Use this skill when user wants to:**\n- Add items to the todo list\n- Save current progress for later continuation\n- Resume previously saved work\n- Checkpoint progress in long-running tasks\n- Proceed to next steps in a workflow\n- Continue from where they left off\n\n**Do NOT use for:**\n- Creating git commits (use skill-finish-branch)\n- Simple todo list queries (\"what's on my list?\")\n- Task completion that involves pushing code\n\n\n## Core Capabilities\n\n### 1. Adding Tasks to Todo List\n\nWhen user says \"add to the todo's\" or similar:\n\n```markdown\n**What would you like to add to the todo list?**\n\nI'll help you capture this task. Please provide:\n- Task description (what needs to be done)\n- Any dependencies or prerequisites\n- Priority (if applicable)\n```\n\n**After getting details, use TaskCreate to add:**\n\n```javascript\nTaskCreate({\n  subject: \"[Brief task description]\",\n  description: \"[Detailed description including dependencies and context]\",\n  activeForm: \"Working on [task description]\"\n})\n```\n\n**Then confirm to user:**\n\n```\n✅ Task created: [Task description]\n\nView all tasks with TaskList or use \u002Ftasks command.\n```\n\n\n### 2. Saving Progress \u002F Checkpointing\n\nWhen user says \"save progress\" or \"checkpoint this\":\n\n#### Step 1: Assess Current State\n\n```bash\n# Check git status\ngit status\n\n# Check current branch\ngit branch --show-current\n\n# Check uncommitted work\ngit diff --stat\n```\n\n#### Step 2: Create Progress Checkpoint\n\n**Option A: Git-based checkpoint (if git repo)**\n\n```bash\n# Create a work-in-progress commit\ngit add .\ngit commit -m \"WIP: [description of current state]\n\nProgress checkpoint - work in progress\nNot ready for review or merge\n\nCurrent state:\n- [What's completed]\n- [What's in progress]\n- [What's next]\n\nCo-Authored-By: Claude Sonnet 4.6 \u003Cnoreply@anthropic.com>\"\n```\n\n**Option B: Task-based checkpoint (preferred for tracking)**\n\nCreate checkpoint task with detailed state:\n\n```javascript\nTaskCreate({\n  subject: \"Checkpoint: [Brief description]\",\n  description: `\n📍 CHECKPOINT: ${new Date().toISOString()}\n\nCompleted:\n✓ [Task 1]\n✓ [Task 2]\n\nIn Progress:\n⚙️ [Current task with details]\n\nNext Steps:\n- [ ] [Next task 1]\n- [ ] [Next task 2]\n- [ ] [Next task 3]\n\nContext:\n- Branch: ${branchName}\n- Last commit: ${lastCommit}\n- Files changed: ${filesChanged}\n  `,\n  activeForm: \"Checkpoint saved\"\n})\n```\n\n#### Step 3: Update Existing Tasks\n\nMark completed tasks as done:\n\n```javascript\n\u002F\u002F For each completed task\nTaskUpdate({\n  taskId: \"[task-id]\",\n  status: \"completed\"\n})\n```\n\nMark current task as in_progress:\n\n```javascript\nTaskUpdate({\n  taskId: \"[current-task-id]\",\n  status: \"in_progress\"\n})\n```\n\n#### Step 4: Provide Resume Instructions\n\n```markdown\n✅ Progress saved!\n\nTo resume this work:\n1. Run: git checkout [branch-name]\n2. View tasks: TaskList\n3. Say: \"resume tasks\" or \"pick up where we left off\"\n\nCurrent state:\n- Branch: [branch-name]\n- Tasks: [X completed, Y in progress, Z pending]\n- Last checkpoint: [timestamp]\n```\n\n\n### 3. Resuming Tasks\n\nWhen user says \"resume tasks\" or \"pick up where we left off\":\n\n#### Step 1: Load Task State\n\n```javascript\n\u002F\u002F Get all tasks\nconst tasks = TaskList()\n\n\u002F\u002F Filter by status\nconst completed = tasks.filter(t => t.status === 'completed')\nconst inProgress = tasks.filter(t => t.status === 'in_progress')\nconst pending = tasks.filter(t => t.status === 'pending')\n\n\u002F\u002F Find checkpoint task (if exists)\nconst checkpoint = tasks.find(t => t.subject.startsWith('Checkpoint:'))\n```\n\n#### Step 2: Check Git State\n\n```bash\n# Check for WIP commits\ngit log --oneline -10 | grep WIP\n\n# Check current branch\ngit branch --show-current\n\n# Check git status\ngit status\n```\n\n#### Step 3: Present Current State\n\n```markdown\n📋 **Resuming from last checkpoint**\n\n**Branch:** [branch-name]\n**Last checkpoint:** [timestamp from WIP commit or checkpoint task]\n\n**Completed:** (${completed.length} tasks)\n${completed.map(t => `✓ ${t.subject}`).join('\\n')}\n\n**In Progress:** (${inProgress.length} tasks)\n${inProgress.map(t => `⚙️ ${t.subject}`).join('\\n')}\n\n**Next Steps:** (${pending.length} tasks)\n${pending.map((t, i) => `${i + 1}. [ ] ${t.subject}`).join('\\n')}\n\n**Would you like me to:**\n1. Continue with the next task?\n2. Modify the plan?\n3. See more details about current state?\n```\n\n#### Step 4: Execute Based on Choice\n\n- If \"continue with next task\" → Get first pending task, mark as in_progress, and begin work:\n  ```javascript\n  const nextTask = pending[0]\n  TaskUpdate({ taskId: nextTask.id, status: 'in_progress' })\n  \u002F\u002F Begin working on nextTask\n  ```\n\n- If \"modify the plan\" → Use AskUserQuestion to understand changes, then update tasks\n\n- If \"see more details\" → Show git diff, file changes, recent commits, task descriptions\n\n\n### 4. Proceeding to Next Steps\n\nWhen user says \"proceed to next steps\":\n\n#### Step 1: Check Current Task Status\n\n```javascript\nconst tasks = TaskList()\nconst currentTask = tasks.find(t => t.status === 'in_progress')\n\nif (currentTask) {\n  console.log(`Current task: ${currentTask.subject}`)\n  console.log(`Status: ${currentTask.status}`)\n}\n```\n\n#### Step 2: Complete Current and Move Forward\n\n```javascript\n\u002F\u002F Mark current task as complete\nif (currentTask) {\n  TaskUpdate({\n    taskId: currentTask.id,\n    status: 'completed'\n  })\n  console.log(`✓ ${currentTask.subject}`)\n}\n\n\u002F\u002F Get next pending task\nconst nextTask = tasks.find(t => t.status === 'pending' && !t.blockedBy?.length)\n\nif (nextTask) {\n  \u002F\u002F Mark as in progress\n  TaskUpdate({\n    taskId: nextTask.id,\n    status: 'in_progress'\n  })\n  console.log(`\\n⚙️ ${nextTask.subject}`)\n  console.log(`\\nProceeding with: ${nextTask.description}`)\n}\n```\n\n#### Step 3: Execute Next Task\n\nBegin working on the next task immediately after marking it as in_progress.\n\n\n## Migration from task plan tool (v7.22.x → v7.23.0+)\n\n### For Users with Existing .md Todo Files\n\nIf you have existing `.claude\u002Ftodos.md` or similar files:\n\n#### Option 1: Automatic Migration\n\n```bash\n# Run migration script\n\"${HOME}\u002F.claude-octopus\u002Fplugin\u002Fscripts\u002Fmigrate-todos.sh\"\n```\n\nThis will:\n1. Parse existing .md todo files\n2. Convert to TaskCreate calls\n3. Preserve task order and status\n4. Archive old .md files to `.claude\u002Farchived-todos\u002F`\n\n#### Option 2: Manual Migration\n\nFor each todo item in your .md file:\n\n```markdown\n\u003C!-- Old format in todos.md -->\n- [ ] Implement user authentication\n- [x] Set up database\n- [ ] Create API endpoints\n```\n\nConvert to:\n\n```javascript\n\u002F\u002F New format using native tasks\nTaskCreate({\n  subject: \"Implement user authentication\",\n  description: \"Create auth system with JWT tokens\",\n  activeForm: \"Implementing authentication\"\n})\n\nTaskCreate({\n  subject: \"Set up database\",\n  description: \"Configure PostgreSQL and run migrations\",\n  activeForm: \"Setting up database\"\n})\n\u002F\u002F Mark as completed since it was [x]\nTaskUpdate({ taskId: \"...\", status: \"completed\" })\n\nTaskCreate({\n  subject: \"Create API endpoints\",\n  description: \"Build REST API for user operations\",\n  activeForm: \"Creating API endpoints\"\n})\n```\n\n### Backward Compatibility\n\n**Opt-out for users who prefer old system:**\n\nCreate `.claude\u002Fclaude-octopus.local.md` with:\n\n```yaml\nuse_native_tasks: false\n\n# Claude Octopus Local Configuration\n\nThis project uses legacy task plan tool tool instead of native Task management.\n```\n\nWhen `use_native_tasks: false`, skill falls back to task plan tool behavior.\n\n\n## Integration with Other Skills\n\n### With skill-finish-branch\n\n```\nUser: \"save progress and prepare for PR\"\n\n1. Use skill-task-management to checkpoint (create tasks for current state)\n2. Then use skill-finish-branch to prepare PR\n```\n\n### With flow-develop\n\n```\nUser: \"add implementation of auth system to todos\"\n\n1. Use skill-task-management to add high-level task\n2. Use flow-develop to break down and implement\n3. Update tasks as work progresses\n```\n\n### With skill-debug\n\n```\nUser: \"checkpoint this, I found a bug\"\n\n1. Use skill-task-management to save current progress (checkpoint task)\n2. Use skill-debug to investigate the bug\n3. Return to saved checkpoint after fix\n```\n\n\n## Best Practices\n\n### 1. Clear Task Subjects and Descriptions\n\n**Good task:**\n```javascript\nTaskCreate({\n  subject: \"Implement token refresh with 15-minute expiration\",\n  description: `\nCreate token refresh endpoint that:\n- Validates refresh token from secure HTTP-only cookie\n- Issues new access token with 15min expiry\n- Rotates refresh token for security\n- Returns 401 if refresh token invalid\u002Fexpired\n\nDependencies: OAuth provider setup must be complete\n  `,\n  activeForm: \"Implementing token refresh logic\"\n})\n```\n\n**Poor task:**\n```javascript\nTaskCreate({\n  subject: \"Do auth stuff\",\n  description: \"Fix things\",\n  activeForm: \"Working\"\n})\n```\n\n### 2. Use Task Dependencies\n\nFor tasks with prerequisites:\n\n```javascript\n\u002F\u002F First task\nTaskCreate({\n  subject: \"Set up OAuth provider configuration\",\n  description: \"Configure Auth0 application settings\",\n  activeForm: \"Configuring OAuth provider\"\n})\n\n\u002F\u002F Dependent task\nTaskCreate({\n  subject: \"Implement token refresh endpoint\",\n  description: \"Create \u002Fauth\u002Frefresh endpoint\",\n  activeForm: \"Implementing refresh endpoint\",\n  addBlockedBy: [\"1\"]  \u002F\u002F Blocked by task #1\n})\n```\n\n### 3. Context Preservation in Checkpoints\n\nWhen checkpointing, always include:\n- What's completed (prevents re-doing work)\n- What's in progress (enables quick resume)\n- What's next (provides clear path forward)\n- Why decisions were made (preserves reasoning)\n\nExample checkpoint task:\n\n```javascript\nTaskCreate({\n  subject: \"Checkpoint: Auth implementation 70% complete\",\n  description: `\n📍 CHECKPOINT: 2026-02-03T14:30:00Z\n\nCompleted:\n✓ OAuth provider configuration (Auth0)\n✓ Token exchange endpoint (\u002Fauth\u002Flogin)\n✓ User session middleware\n\nIn Progress:\n⚙️ Token refresh logic (70% done)\n  - Validation complete\n  - Token rotation TODO\n  - Cookie handling TODO\n\nNext:\n- [ ] Complete token rotation logic\n- [ ] Add logout endpoint\n- [ ] Add session expiration handling\n- [ ] Write integration tests\n\nBranch: feature\u002Fauth-system\nLast commit: abc123f \"Add session middleware\"\n\nDecisions Made:\n- Using Auth0 (rationale: enterprise-grade, handles complexity)\n- 15-minute access token expiry (security vs UX balance)\n- HTTP-only cookies for refresh tokens (XSS protection)\n  `,\n  activeForm: \"Checkpoint saved\"\n})\n```\n\n\n## Common Patterns\n\n### Pattern 1: End-of-Day Checkpoint\n\n```\nUser: \"save progress, I'm done for today\"\n\nAction:\n1. Create WIP commit with current state\n2. Create checkpoint task with completed\u002Fpending breakdown\n3. Mark in-progress tasks with current status\n4. Provide resume instructions for tomorrow\n```\n\n### Pattern 2: Context Switch\n\n```\nUser: \"checkpoint this, need to work on something else\"\n\nAction:\n1. Save current branch state (WIP commit)\n2. Create checkpoint task with detailed context\n3. Mark current task as pending (will resume later)\n4. Ready for resume when user returns\n```\n\n### Pattern 3: Collaboration Handoff\n\n```\nUser: \"save progress for Claude to pick up\"\n\nAction:\n1. Create comprehensive checkpoint task\n2. Document all context and decisions\n3. Mark in-progress tasks with current state\n4. Ensure new session can load task state and resume seamlessly\n```\n\n\n## Red Flags - Don't Do This\n\n| Action | Why It's Wrong |\n|--------|----------------|\n| Checkpoint without documenting context | Next session won't know what was happening |\n| Skip WIP commit for code changes | Lose work if something breaks |\n| Generic \"proceed to next\" without checking TaskList | Might skip incomplete work |\n| Vague task subjects\u002Fdescriptions | Unclear what needs to be done |\n| Resume without showing TaskList state | User doesn't know where they are |\n| Create tasks without activeForm | No progress indication in UI |\n\n\n## Quick Reference\n\n| User Intent | Skill Action | Tool Used |\n|-------------|--------------|-----------|\n| \"add to todos\" | Gather details, create task | TaskCreate |\n| \"save progress\" | Create checkpoint task + WIP commit | TaskCreate + git |\n| \"resume tasks\" | Load task state, show status, ask direction | TaskList |\n| \"proceed to next\" | Complete current, start next | TaskUpdate |\n| \"checkpoint this\" | Create detailed checkpoint task | TaskCreate |\n\n\n## Task Status Workflow\n\n```\npending → in_progress → completed\n                ↓\n              deleted (if no longer needed)\n```\n\n**Best practices:**\n- Create tasks in `pending` state\n- Mark `in_progress` when starting work\n- Mark `completed` only when fully done\n- Use `deleted` for cancelled\u002Fobsolete tasks\n\n\n## The Bottom Line\n\n```\nTask management → Clear state + Easy resume + Native UI\nOtherwise → Lost context + Duplicate work + No visibility\n```\n\n**Track everything. Checkpoint frequently. Resume seamlessly. Use native tools.**\n\n\n## Example: Full Workflow\n\n```javascript\n\u002F\u002F User: \"add implementing auth to my todos\"\n\n\u002F\u002F Step 1: Create main task\nTaskCreate({\n  subject: \"Implement user authentication system\",\n  description: `\nBuild complete auth system with:\n- OAuth 2.0 (Auth0 provider)\n- JWT token management\n- Refresh token rotation\n- Session middleware\n- Logout functionality\n  `,\n  activeForm: \"Planning authentication implementation\"\n})\n\n\u002F\u002F User works on it...\n\n\u002F\u002F User: \"save progress for tomorrow\"\n\n\u002F\u002F Step 2: Create checkpoint\nTaskCreate({\n  subject: \"Checkpoint: Auth implementation in progress\",\n  description: `\n📍 Checkpoint: 2026-02-03T18:30:00Z\n\nCompleted:\n✓ OAuth configuration\n✓ Login endpoint\n\nIn Progress:\n⚙️ Token refresh (50%)\n\nNext:\n- [ ] Complete refresh logic\n- [ ] Add logout\n- [ ] Write tests\n\nBranch: feature\u002Fauth\nCommit: abc123f\n  `,\n  activeForm: \"Checkpoint saved\"\n})\n\n\u002F\u002F Step 3: Update main task status\nTaskUpdate({\n  taskId: \"1\",\n  status: \"in_progress\"\n})\n\n\u002F\u002F User: \"resume tasks\" (next day)\n\n\u002F\u002F Step 4: Load and present state\nconst tasks = TaskList()\n\u002F\u002F Present: \"You have 1 in_progress task, last checkpoint 2026-02-03T18:30:00Z\"\n\u002F\u002F Show details from checkpoint task\n\n\u002F\u002F User: \"continue\"\n\n\u002F\u002F Step 5: Resume work\nconst currentTask = tasks.find(t => t.status === 'in_progress')\n\u002F\u002F Begin working on token refresh where they left off\n```\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","d69096e239f2a89aabc2cd078c47664a9d3b1e11","05-技能与代理开发\u002Fskill-task-management",3,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts","https:\u002F\u002Fgithub.com\u002Flza6","个人vx：Tf00798\r\n个人✈：@TFGY999","2026-10-08 14:29:22",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":24},[35,38,41],{"tool":36,"command":37},"npx","npx skills add lza6\u002FArmor-piercing-system-prompts --skill skill-task-management",{"tool":39,"command":40},"bunx","bunx skills add lza6\u002FArmor-piercing-system-prompts --skill skill-task-management",{"tool":42,"command":43},"pnpm","pnpm dlx skills add lza6\u002FArmor-piercing-system-prompts --skill skill-task-management","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F05-技能与代理开发\u002Fskill-task-management\u002FSKILL.md",[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",174,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F05-技能与代理开发\u002Fskill-task-management\u002Fagents\u002Fopenai.yaml",[53,60,65,72,79,86],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7FFG485KY83TD6HSC4YPCMC","obsidian-clipper-template-creator","Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator\u002FSKILL.md",[],[],{"skillNo":61,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7FFG0T6AZ0STEJPSB3CX84K","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator-antigravity-awesome-skills-main\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7FFFY0QEM14SKWPDYGMXM2P","python-api","Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP\u002FmAP semantics, and source-style import diagnostics.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Fpython-api\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7FFFVZQZ2GJ0C0TGP7JHD20","file-evaluation","Folder-based PASCAL VOC AP\u002FmAP evaluation from ground-truth and detection text files.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Ffile-evaluation\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7FFFSFNYSE77SJ6PE1CK2DA","object-detection-metrics","Guides legacy Object-Detection-Metrics PASCAL VOC AP\u002FmAP evaluation from detection text folders and direct Python API classes.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7FFFP0GCK1RVXBCPQ8APBMT","nx-workspace-patterns","Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fnx-workspace-patterns\u002FSKILL.md",[],[]]