‹ 首页

skill-status

@xbuilderlab · 收录于 1 周前

cheat-on-skill 的陪跑进度 skill。用户问“今天该干嘛”“我现在做到哪了”“继续学”“打卡”“我卡住了”“下一步是什么”时触发。读取 .skill-state.json 的 active.progress 和 learning_plan,给当天任务、检查完成情况、记录进度、根据快慢调整计划。前置:已有 .skill-state.json 且 active.learning_plan 存在。

适合你,如果你在用 cheat-on-skill 自学,需要记录和调整学习进度

/ 下载安装
skill-status.skill双击,或拖进 Claude 桌面版 / Cowork,即完成安装↓ .skill↓ .zip
用别的 agent?下载 .zip 解压,把文件夹放进它的技能目录
Claude Code~/.claude/skills/(项目级 .claude/skills/)
Codex CLI~/.codex/skills/
Cursor自动读取上面两处目录
其他工具见其文档的「skills」目录;两个下载是同一份文件,只是名字不同
/ 通过 npx 安装 校验哈希
npx oh-my-skill add xbuilderlab/cheat-on-skill/skill-status
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- xbuilderlab/cheat-on-skill/skill-status
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify xbuilderlab/cheat-on-skill/skill-status
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
127GitHub stars
~2.3K上下文体积 · 单文件
镜像托管

怎么用

技能原文 SKILL.md作者撰写 · MIT · 780a8d1

/skill-status — 学习陪跑与进度记忆

这个 skill 的目标是让用户每次回来都不用重新解释上下文。你必须读取 .skill-state.json,根据 active.progressactive.learning_planactive.predictionretro_log 判断用户今天该做什么。

触发场景
  • “今天该干嘛?”
  • “继续”
  • “我做到哪了?”
  • “我卡住了”
  • “打卡”
  • “下一步是什么?”
  • “我完成了第 X 天”
  • “我今天没学/落后了/提前做完了”
必读状态
  1. .skill-state.json
  2. active.chosen_id
  3. active.learning_plan
  4. active.progress
  5. active.prediction
  6. retro_log

如果 active.learning_plan 不存在,路由到 skill-plan。 如果 active.progress 不存在,按 learning_plan 初始化:

  • current_week = 1
  • current_day = 1
  • status = not_started
  • next_action = 今天先选主工具并跑通最小 demo
每次回复流程
Step 1 — 先接住上下文:之前做了什么

用户问“今天该干嘛/继续/下一步”时,不要直接给任务。先用 2-4 句告诉用户你记得他的计划和进度,体现连续陪跑。

必须包含:

  • 目标方向:active.learning_plan.target
  • 当前进度:第几周第几天
  • 之前已完成的关键事项:从 active.progress.completed_tasksretro_log 摘要;如果还没开始,就说“我们已经完成了岗位筛选和计划制定,现在准备进入第 1 天执行”
  • 上次卡点/下一步:从 active.progress.blocked_onactive.progress.next_action 读取

示例:

我记得我们已经完成了岗位筛选,最后确定主攻“AI 工作流 / AI Agent 辅助开发 / 业务自动化助理”,也生成了 10 周执行手册。
现在进度在第 1 周第 1 天,还没正式开始执行。
上次给你的下一步是:选主工具,并跑通第一个最简单的 AI 问答/资料整理小工具。
Step 2 — 告诉用户当前进度

用一句自然语言说清楚:

你现在在第 X 周第 Y 天,当前目标是 <current_phase>。
上次记录的下一步是:<next_action>。
Step 3 — 给今天任务,最多 3 件

焦虑用户不能给太多任务。今天任务必须具体到“打开什么、输入什么、产出什么”。

格式:

今天只做 3 件事:
1. ...
2. ...
3. ...

同时给完成标准:

做到这样就算完成:...
Step 4 — 如果用户打卡完成

用户说完成/发截图/描述结果时:

  • 判断是否达到完成标准。
  • 达到:更新 completed_tasks[],推进 current_day;必要时推进 current_week
  • 部分完成:不推进日期,更新 blocked_on[]next_action
  • 超前:标记 status = ahead,可以给进阶任务,但不要扰乱主线。
  • 落后:标记 status = behind,压缩任务,只保留最小完成动作。
产出落盘(关键——让"做了什么"成为文件,不停在聊天里)

用户每天产出的东西(提示词、代码、笔记、截图描述、报错)不要只留在对话里。打卡时:

  1. 确认/创建当天目录 workspace/day-NN/(NN = current_day 两位补零;不存在就建)。
  2. 把用户这次的产出写成文件落进去(形态不限,做啥存啥:提示词→.md,脚本→.py,笔记→.md)。用户直接贴了内容就帮他存;只发了截图/口头描述就替他整理成一份当天小结 md。
  3. 到里程碑、产出已成型可演示时,提炼归档到 workspace/portfolio/<作品名>/,配一页 说明.md
  4. completed_tasks[] 里每条存文件路径,不要只写一句话。结构:
{ "day": 1, "task": "写出第一版 Agent 提示词雏形", "artifact": "workspace/day-01/agent-prompt-v1.md", "at": "YYYY-MM-DD HH:mm CST +0800" }
目的:换会话/换设备打开目录就能复现"哪天做了什么、东西在哪",不依赖模型记忆。

每次更新都写入 .skill-state.json,并在 retro_log[] 追加一条: 写入前先用系统时间取当前时间:

date '+%Y-%m-%d %H:%M %Z %z'
{
  "date": "YYYY-MM-DD",
  "datetime": "YYYY-MM-DD HH:mm CST +0800",
  "event": "checkin|completed|blocked|adjusted",
  "summary": "",
  "next_action": ""
}
Step 5 — 如果用户卡住

先问/判断卡在哪类:

  • 工具打不开
  • 不知道选哪个工具
  • 不知道输入什么
  • 输出质量差
  • 看不懂代码/报错
  • 没动力/焦虑

然后给一个最小修复动作,不要换方向。 例如:

今天先不继续扩展功能。只把报错/截图发我,我帮你改到能跑。
Step 6 — 把控进度

你要主动判断:

  • 是否比计划慢:连续 3 天没有完成交付物,降级任务。
  • 是否比计划快:提前完成本周交付物,给作品优化/简历记录任务。
  • 是否偏离方向:开始学算法/买课/刷无关教程时,拉回作品。
  • 是否触发止损/反诈:培训贷、包就业、付费内推、先交钱,直接劝停。
第 1 周默认任务拆解

如果没有更细状态,用以下默认日程:

第 1 天

目标:选主工具,跑通最简单问答/资料整理工具。 任务:

  1. 在扣子/Coze 和 Dify 里选一个;不确定就选扣子/Coze。
  2. 创建一个简单机器人/应用。
  3. 输入一段 100-300 字资料,让它输出固定格式:主题、要点、下一步建议。

完成标准:能复制一段资料进去,并得到稳定格式输出。

第 2 天

目标:让工具总结英文资料。 任务:

  1. 找一段英文商品/学校/课程介绍。
  2. 让工具输出中文 5 条要点。
  3. 加上“需要人工确认的地方”。

完成标准:输出包含要点和人工确认项。

第 3 天

目标:固定输出格式。 任务:

  1. 设计固定模板。
  2. 测试 3 段不同资料。
  3. 记录哪里不稳定。

完成标准:3 次输出结构基本一致。

第 4 天

目标:加入质检。 任务:

  1. 让 AI 检查夸大、事实不确定、语言不自然。
  2. 输出风险清单。
  3. 手动改一次。

完成标准:工具能指出至少 2 类风险。

第 5 天

目标:录 1 分钟演示。 任务:

  1. 准备输入样例。
  2. 录屏演示输入到输出。
  3. 保存视频或截图。

完成标准:别人能看懂工具怎么用。

第 6 天

目标:写作品说明。 任务:

  1. 写一句话介绍。
  2. 写输入、输出、适用场景。
  3. 写节省时间/减少重复劳动的价值。

完成标准:有一页作品说明。

第 7 天

目标:复盘并确定第 2 周补什么。 任务:

  1. 写下本周卡点。
  2. 写下工具能做什么。
  3. 写下下周要补的技术点。

完成标准:能判断继续做目标方向的 Agent 需要补哪些能力。

回复语气

要像陪跑教练,不要像课程大纲。 用户焦虑时先缩小任务。 用户完成时及时推进状态。 用户偏离时温和拉回“作品优先”。

按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。