# Send PlanSuite to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "plansuite",
    "name": "PlanSuite",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/double729/plansuite",
    "canonicalUrl": "https://clawhub.ai/double729/plansuite",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/plansuite",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plansuite",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "templates/findings.md",
      "templates/progress.md",
      "templates/task_plan.md",
      "_meta.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "plansuite",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T03:13:51.870Z",
      "expiresAt": "2026-05-14T03:13:51.870Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plansuite",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plansuite",
        "contentDisposition": "attachment; filename=\"plansuite-0.1.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "plansuite"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/plansuite"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/plansuite",
    "downloadUrl": "https://openagent3.xyz/downloads/plansuite",
    "agentUrl": "https://openagent3.xyz/skills/plansuite/agent",
    "manifestUrl": "https://openagent3.xyz/skills/plansuite/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/plansuite/agent.md"
  }
}
```
## Documentation

### PlanSuite

把“写计划（含子计划）→ 冻结计划（变更控制）→ 独立会话执行（带检查点）”合成一个最小可用流程。

### 文件结构（在当前工作目录创建/维护）

task_plan.md：计划主文件（含子计划/里程碑）
progress.md：执行进度（每次推进都要写）
findings.md：发现/决策/坑点（避免重复踩坑）

不要把这三份写到聊天里：写到文件，才能恢复/续跑。

### 0) 初始化（第一次做这个项目）

如果缺文件：用模板创建 task_plan.md/progress.md/findings.md（见 templates/）。
让用户确认目标、范围、约束、完成定义（DoD）。

### 1) 计划阶段（拆子计划）

在 task_plan.md 里输出：

背景/目标
范围（做/不做）
风险 & 回滚
子计划（Milestones）：每个子计划要有

输入/输出
验收标准
预计工具调用/文件改动
风险与回滚点

### 2) 冻结阶段（FINALIZED）

只有当用户明确说“按这个计划执行”后：

在 task_plan.md 顶部写入：STATUS: FINALIZED + 时间戳。
把“接下来要执行的子计划编号/名称”写入 progress.md 的 Next。

规则：未 FINALIZED 不允许进入执行阶段（最多做调查/补充计划）。

### 3) 执行阶段（独立会话 + 检查点）

当进入执行：

建议用 sessions_spawn 开一个隔离执行会话（避免污染主会话上下文）。
每完成一个子计划：

更新 progress.md（Done/Next/Blockers）
更新 findings.md（关键决策、踩坑、验证命令、回滚步骤）


检查点策略（默认每个子计划至少一次）：

执行前：复述子计划的 DoD + 风险 + 回滚
执行后：给出验证步骤 + 结果

### 4) 变更控制（计划变更）

如果执行中发现计划不成立：

不要“边做边改”。先写入 findings.md，再把变更提案写入 task_plan.md。
把 STATUS 改为 DRAFT，等待用户重新确认。

### 你在什么时候用什么文件

需要问清楚/拆任务 → task_plan.md
需要告诉用户进度/下一步 → progress.md
需要记录结论/命令/坑/回滚 → findings.md

### 模板

templates/task_plan.md
templates/progress.md
templates/findings.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: double729
- Version: 0.1.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T03:13:51.870Z
- Expires at: 2026-05-14T03:13:51.870Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/plansuite)
- [Send to Agent page](https://openagent3.xyz/skills/plansuite/agent)
- [JSON manifest](https://openagent3.xyz/skills/plansuite/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/plansuite/agent.md)
- [Download page](https://openagent3.xyz/downloads/plansuite)