task-keeper
v4.6.0多实例 keeper 并行托管 debug/杂务两队列:一条 bug 一个实例,原子认领 + 合并锁,登记前跨队列查重,规格空白转出互链,细节见 README
By zhangq0 GitHub starsUpdated 4 days ago
Directory evidence
- Runtimes
- Claude Code
- Parsed components
- 5 skill or MCP entries
- Source updated
- Sep 19, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install task-keeper for Claude Code
claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install task-keeper@agent-plugin-marketplacePaste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/ibootz/claude-devkit-marketplaceClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/task-keeper/.
Plugin files
├── .claude-plugin/plugin.json├── skills/tk-board/SKILL.md├── skills/tk-chore/SKILL.md├── skills/tk-debug/SKILL.md├── skills/tk-decisions/SKILL.md└── skills/tk-worktree/SKILL.md
Included Skills5
出一张 debug / chore 队列的进度看板:每条一行(编号 + 20 字问题说明 + 已关闭/未解决/进行中/待拍板),外加四态计数与占比、陈旧 worktree 与悬空拍板项告警。纯只读,跑多少次都不改队列、不唤醒 keeper。
主会话把杂务(台账/沉淀/收尾/外部系统小操作)转交常驻 chore-keeper subagent 托管的最小流程:判断是杂务 → 逐字转发 → 回原任务。登记、分类、攒批执行、外部写打包拍板、归档全部由 chore-keeper 在独立上下文完成,主会话不亲手做杂务。队列落盘 `.keeper/<交付id>/chore/`(v6 起正文与附件入库,只排除 worktree/instance.json/keeper-active/merge.lock 四类本机产物)。
Debug 队列工程化处理(主会话侧入口)。把「Human 报 bug → AI 立刻派 subagent 修」 改造成「主会话只转发 → debug-keeper agent 独立跑完登记/triage/派发/对账/收尾, 自己直接并行派第二层 fixer subagent」的并行流水线。**v7 起一条 issue 一个 debug-keeper 实例**,同一档可以并存多个;同轮报来多条 bug 要在同一条消息里并行 派多个实例,各管一条,互不干扰。队列落在项目根 `.keeper/<交付id>/debug/`(一 issue 一个目录,跨 session 持久;v6 起 issue 文本、 receipts 与截图入库,只有 fixer worktree 等四类本机产物排除在外)。**主会话在本流程里只做三件事:截图落盘(如果用户附了图)→ 把原话转给 debug-keeper → 立刻回到原任务。** 不做 triage、不写 issue 文件、不派 fixer、 不对账,这些全部由 debug-keeper 在独立上下文里完成,避免打断主会话手上的工作。
keeper(后台 subagent)与 Human 之间的决策打包 HITL 协议正典:keeper 把待拍板事项写 `.keeper/<交付id>/decisions/` 文件 + SendMessage 一句话通知,主会话攒批后一次 AskUserQuestion 并列问完,答复原文写 `answers/` 回传。解决「subagent 永远拿不到 AskUserQuestion」与「逐条弹框打断用户」两个问题。
从一个源 worktree 派生出**结构完整的聚合仓 worktree**(父仓 + 全部 submodule(子模块)层,含嵌套递归),落点固定 `<source>/.keeper/<交付id>/debug/<id>/worktree/`,并能整体合并回源 worktree 的分支。`git worktree add` 只建父仓工作区、submodule 目录全是空的,本 skill 负责把它们按父仓记录的 gitlink(父仓 index 里那条 `160000` 模式条目,值是子仓某次提交的 40 位 SHA)真正 checkout 出来,并提供状态查询 / 清理 / 回流。核心纪律:linked worktree 里永远走 `git worktree add` 供给、绝不用 `git submodule update --init`;gitlink 一律以**源侧同层 index** 为准。
Plugin manifests1
{
"name": "task-keeper",
"version": "4.6.0",
"description": "多实例 keeper 并行托管 debug/杂务两队列:一条 bug 一个实例,原子认领 + 合并锁,登记前跨队列查重,规格空白转出互链,细节见 README",
"author": {
"name": "zhangq"
},
"hooks": {
"SessionStart": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-start-keeper-routing.sh",
"timeout": 10
}
]
}
],
"UserPromptSubmit": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit-keeper-routing.sh",
"timeout": 10
},
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit-debug-queue.sh",
"timeout": 10
},
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit-chore-queue.sh",
"timeout": 10
}
]
}
],
"SubagentStart": [
{
"matcher": "task-keeper:debug-keeper",
"hooks": [
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/subagent-start-debug-keeper.sh",
"timeout": 10
}
]
}
],
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pre-tool-use-debug-worktree-push.sh",
"timeout": 5
},
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pre-tool-use-debug-worktree-destroy.sh",
"timeout": 5
}
]
},
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pre-tool-use-debug-evidence.sh",
"timeout": 5
}
]
},
{
"matcher": "Agent",
"hooks": [
{
"type": "command",
"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pre-tool-use-keeper-instance.sh",
"timeout": 5
}
]
}
]
}
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[task-keeper on Agent Plugins Marketplace](https://pluginsmp.com/plugins/task-keeper)