agentleFS
XBuilderLABXBuilderLAB/cheat-on-skill/skills/skill-status/SKILL.md

skill-status

Skill191 starsChanged 5 months agoMITView on GitHub

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

6 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use pm-discovery, qa-phase and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ww-w-aiSkill

    pm-discovery

    PM Agent Team - Automated product discovery, strategy, and PRD generation. Runs PM analysis workflow to produce comprehensive PRD before PDCA Plan phase.

    Also in 3 projects that use this

  • ww-w-aiSkill

    qa-phase

    Run QA tests at various levels (L1-L5) for features under PDCA management. Integrates with MCP tools to execute structured test plans.

    Also in 3 projects that use this

  • +10 more from ww-w-ai
  • Other versions6 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 6

    1. nyldn/claude-octopus★ 4.4ksame name
    2. popup-studio-ai/bkit-claude-code★ 605same name
    3. ww-w-ai/bkit-claude-code★ 605same name
    4. ww-w-ai/bkit-gemini★ 66same name
    5. Terum-Inc/terum-skills★ 28same name
    6. kannaka-labs/Kannaktopus★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository3 other files it gives its agents.

The file

Files
SKILL.md

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

这个 skill 的目标是让用户每次回来都不用重新解释上下文。你必须读取 .skill-state.json,根据 active.progress、active.learning_plan、active.prediction 和 retro_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_tasks 和 retro_log 摘要;如果还没开始,就说“我们已经完成了岗位筛选和计划制定,现在准备进入第 1 天执行”
  • 上次卡点/下一步:从 active.progress.blocked_on 和 active.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 需要补哪些能力。

回复语气

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.