# Task Bundle

> 管理 Task Bundle 工件结构（docs/tasks/），提供创建、查询、状态更新的规范

- **Type:** Skill
- **Install:** `agentstack add skill-jerrylalala-compound-engineering-task-bundle`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jerrylalala](https://agentstack.voostack.com/s/jerrylalala)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Jerrylalala](https://github.com/Jerrylalala)
- **Source:** https://github.com/Jerrylalala/compound-engineering/tree/main/plugins/compound-engineering/skills-custom/task-bundle

## Install

```sh
agentstack add skill-jerrylalala-compound-engineering-task-bundle
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Task Bundle 管理

## 什么是 Task Bundle

Task Bundle 是任务的统一工件结构。每个任务由三个文件组成：

| 文件 | 职责 | 写入时机 |
|------|------|----------|
| `plan.md` | 目标、约束、验收标准 | 任务创建时 |
| `state.md` | 当前步骤、阻塞点、状态机历史 | 执行过程中持续更新 |
| `review.md` | findings、证据、结论 | 审查阶段 |

## 创建新 Task Bundle

1. 生成 task-id：`YYYY-MM-DD--`
2. 创建目录 `docs/tasks//`
3. 从模板复制三个文件，替换占位符
4. 更新 frontmatter 中的 task_id、created_at、owner

## 状态转换规则

参见 Failure FSM 协议（`docs/specs/failure-fsm.md`）。

每次状态转换必须：
1. 更新 `state.md` 的 `status` frontmatter 字段
2. 在状态历史表追加一行（时间、从、到、原因、操作者）
3. 更新 `last_checkpoint` 时间戳

## 与现有工作流的关系

> Phase 0 说明：当前 Task Bundle 是独立的文档协议，自身不含自动集成机制。
> 如需在 ce:work 执行时自动读写 state.md，需配合加载 `ce-work-integration` overlay（见 skills-custom/ce-work-integration/SKILL.md）。
> Phase 2 将在上游合并后，将 Task Bundle 读写集成到 ce-work/ce-review 中。

手动使用方式：
- `/workflows:plan` 输出后，手动创建 Task Bundle 并链接 plan 文件
- `/workflows:work` 执行中，手动更新 state.md
- `/workflows:review` 完成后，手动填写 review.md

## 模板位置

```
skills-custom/task-bundle/templates/
├── plan.md.tpl
├── state.md.tpl
└── review.md.tpl
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Jerrylalala](https://github.com/Jerrylalala)
- **Source:** [Jerrylalala/compound-engineering](https://github.com/Jerrylalala/compound-engineering)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jerrylalala-compound-engineering-task-bundle
- Seller: https://agentstack.voostack.com/s/jerrylalala
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.