Skip to content
This repository was archived by the owner on Jun 3, 2026. It is now read-only.

SKILL.md

Latest commit

 

History

History
282 lines (208 loc) · 5.48 KB

SKILL.md

File metadata and controls

282 lines (208 loc) · 5.48 KB
Raw
name task-checklist
description 长程任务 checklist 管理框架。帮助 AI agent 在执行长程任务时保持进度追踪，确保任务不会因上下文中断而丢失进度。支持动态创建、更新、完成 checklist。
version 0.3.0

Task Checklist

长程任务的进度追踪工具，确保任务不会"断片"。

触发条件

会触发：

  • "帮我做 xxx"
  • "开始做 xxx"
  • "创建个 checklist"
  • "建个任务清单"
  • 任何需要多步骤完成的任务

不会触发：

  • 简单问答
  • 查询类任务

通用框架（必用）

所有任务使用这个通用框架：

[ ] 1. 需求定义 - 要做什么？
[ ] 2. 研发目标 - 做到什么程度？
[ ] 3. 执行计划 - 怎么做？
[ ] 4. 实施执行 - 具体实现
[ ] 5. 自检验证 - 做完了吗？
[ ] 6. 完成交付 - 结束

第3步执行计划详解

执行计划是 checklist 最关键的一步，必须做细：

[ ] 3. 执行计划 - 怎么做？
    ├── 步骤拆解 - 分成哪几步？
    ├── 资源确认 - 需要什么？（工具/权限/信息）
    ├── 风险评估 - 有什么问题？
    └── 交付标准 - 怎么算完成？

3.1 步骤拆解

把大任务拆成小步骤，每步可执行：

示例：
- 创建 GitHub 仓库
- 推送代码
- 添加主题标签

3.2 资源确认

执行前确认需要的资源：

示例：
- gh CLI 已安装
- GitHub 账号有权限
- 必要的环境变量

3.3 风险评估

预估可能的问题：

示例：
- 分支名可能不一致
- 仓库可能已存在
- 网络可能不稳定

3.4 交付标准

明确怎么算完成：

示例：
- 4 个仓库都能访问
- 每个有正确文件
- 本地文件未被移动

触发后交互流程

创建时

  1. 展示 checklist 框架
  2. 询问需求
  3. 填充每一步详情

执行中

  1. 每完成一步更新状态
  2. 显示进度百分比
  3. 提示下一步

中断恢复

  1. 检测未完成任务
  2. 询问是否继续
  3. 恢复到断点

使用示例

示例 1：开始新任务

用户：帮我做个 workspace-cleanup skill

我：好的，为你创建 checklist：

📋 Task Checklist
━━━━━━━━━━━━━━━━━━━━

[ ] 1. 需求定义 - 要做什么？
[ ] 2. 研发目标 - 做到什么程度？
[ ] 3. 执行计划 - 怎么做？
[ ] 4. 实施执行 - 具体实现
[ ] 5. 自检验证 - 做完了吗？
[ ] 6. 完成交付 - 结束

━━━━━━━━━━━━━━━━━━━━

**第1步：需求定义**
请告诉我：这个任务要做什么？

示例 2：更新进度

用户：需求是整合 4 个 skills 到 GitHub

我：✓ 更新进度：

📋 Task Checklist
━━━━━━━━━━━━━━━━━━━━
[✓] 1. 需求定义 - 整合 4 个 skills 到 GitHub
[ ] 2. 研发目标 - 4 个独立仓库 + 主题归类
[ ] 3. 执行计划 - 怎么做？
[ ] 4. 实施执行 - 具体实现
[ ] 5. 自检验证 - 做完了吗？
[ ] 6. 完成交付 - 结束

进度：1/6 (17%)

**第2步：研发目标**
这个任务要做到什么程度才算完成？

示例 3：执行计划示例

第3步确认的执行计划：

├── 步骤拆解
│   ├── 1. 检查现有仓库状态
│   ├── 2. 为缺失的添加 remote
│   └── 3. 推送到 GitHub
├── 资源确认
│   ├── gh CLI 已安装
│   └── GitHub 账号有权限
├── 风险评估
│   ├── 分支名可能不一致
│   └── 仓库可能不存在
└── 交付标准
    ├── 4 个仓库都能访问
    └── 每个有正确文件

预设模板 (references/)

模板存放位置

  • 路径：references/
  • 格式：Markdown 文件
  • 命名：<task-type>-template.md

模板版本控制

每个模板文件必须包含版本信息：

> **版本**: 1.0.0
> **适用**: xxx
> **更新日期**: 2026-03-08

版本号规则

位数 含义 示例
Major 重大结构变更 1.0.0 → 2.0.0
Minor 新增模板 1.0.0 → 1.1.0
Patch 修复/优化 1.0.0 → 1.0.1

已有模板

模板文件 版本 适用场景
plugin-install-template.md 1.0.0 OpenClaw 插件安装

创建新模板

当需要为常见任务创建模板时：

  1. 在 references/ 下创建 <name>-template.md
  2. 添加版本信息和适用场景
  3. 更新 SKILL.md 的"已有模板"表格
  4. 更新版本号 (Minor +1)

数据存储

文件位置：~/.openclaw/workspace/.checklist/

格式：

{
  "task_id": "xxx",
  "title": "任务标题",
  "created": "2026-03-07T22:00:00Z",
  "status": "in_progress",
  "steps": [
    {
      "id": 1,
      "content": "需求定义",
      "detail": "整合 4 个 skills 到 GitHub",
      "status": "completed"
    },
    {
      "id": 2,
      "content": "研发目标",
      "detail": "4 个独立仓库 + 主题归类",
      "status": "pending"
    }
  ]
}

版本历史

版本 日期 变更
0.3.0 2026-03-08 新增预设模板功能和版本控制
0.2.0 2026-03-07 细化执行计划框架
0.1.0 2026-03-07 初始版本

交付物标准

每个 skill 交付时必须包含：

文件 说明
SKILL.md 技能说明
README.md 使用文档
CHANGELOG.md 变更历史
_meta.json 版本元数据

版本: 0.3.0