xbuilderlab/skill-status
cheat-on-skill 的陪跑进度 skill。用户问“今天该干嘛”“我现在做到哪了”“继续学”“打卡”“我卡住了”“下一步是什么”时触发。读取 .skill-state.json 的 active.progress 和 learning_plan,给当天任务、检查完成情况、记录进度、根据快慢调整计划。前置:已有 .skill-state.json 且 active.learning_plan 存在。
npx skills add https://github.com/XBuilderLAB/cheat-on-skill --skill skill-status
这个 skill 的目标是让用户每次回来都不用重新解释上下文。你必须读取 .skill-state.json,根据 active.progress、active.learning_plan、active.prediction 和 retro_log 判断用户今天该做什么。
.skill-state.jsonactive.chosen_idactive.learning_planactive.progressactive.predictionretro_log如果 active.learning_plan 不存在,路由到 skill-plan。
如果 active.progress 不存在,按 learning_plan 初始化:
current_week = 1current_day = 1status = not_startednext_action = 今天先选主工具并跑通最小 demo用户问“今天该干嘛/继续/下一步”时,不要直接给任务。先用 2-4 句告诉用户你记得他的计划和进度,体现连续陪跑。
必须包含:
active.learning_plan.targetactive.progress.completed_tasks 和 retro_log 摘要;如果还没开始,就说“我们已经完成了岗位筛选和计划制定,现在准备进入第 1 天执行”active.progress.blocked_on 和 active.progress.next_action 读取示例:
我记得我们已经完成了岗位筛选,最后确定主攻“AI 工作流 / AI Agent 辅助开发 / 业务自动化助理”,也生成了 10 周执行手册。
现在进度在第 1 周第 1 天,还没正式开始执行。
上次给你的下一步是:选主工具,并跑通第一个最简单的 AI 问答/资料整理小工具。
用一句自然语言说清楚:
你现在在第 X 周第 Y 天,当前目标是 <current_phase>。
上次记录的下一步是:<next_action>。
焦虑用户不能给太多任务。今天任务必须具体到“打开什么、输入什么、产出什么”。
格式:
今天只做 3 件事:
1. ...
2. ...
3. ...
同时给完成标准:
做到这样就算完成:...
用户说完成/发截图/描述结果时:
completed_tasks[],推进 current_day;必要时推进 current_week。blocked_on[] 和 next_action。status = ahead,可以给进阶任务,但不要扰乱主线。status = behind,压缩任务,只保留最小完成动作。用户每天产出的东西(提示词、代码、笔记、截图描述、报错)不要只留在对话里。打卡时:
workspace/day-NN/(NN = current_day 两位补零;不存在就建)。.md,脚本→.py,笔记→.md)。用户直接贴了内容就帮他存;只发了截图/口头描述就替他整理成一份当天小结 md。workspace/portfolio/<作品名>/,配一页 说明.md。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": ""
}
先问/判断卡在哪类:
然后给一个最小修复动作,不要换方向。
例如:
今天先不继续扩展功能。只把报错/截图发我,我帮你改到能跑。
你要主动判断:
如果没有更细状态,用以下默认日程:
目标:选主工具,跑通最简单问答/资料整理工具。
任务:
完成标准:能复制一段资料进去,并得到稳定格式输出。
目标:让工具总结英文资料。
任务:
完成标准:输出包含要点和人工确认项。
目标:固定输出格式。
任务:
完成标准:3 次输出结构基本一致。
目标:加入质检。
任务:
完成标准:工具能指出至少 2 类风险。
目标:录 1 分钟演示。
任务:
完成标准:别人能看懂工具怎么用。
目标:写作品说明。
任务:
完成标准:有一页作品说明。
目标:复盘并确定第 2 周补什么。
任务:
完成标准:能判断继续做目标方向的 Agent 需要补哪些能力。
要像陪跑教练,不要像课程大纲。
用户焦虑时先缩小任务。
用户完成时及时推进状态。
用户偏离时温和拉回“作品优先”。
Take xbuilderlab/skill-status from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.