关于 re0-plan
re0-plan 是为 paperthin 仓库的开发周期创建计划文件的 Agent 技能。它按周期规模立即写入不同内容,并将计划与证据门槛、执行步骤及配套技能衔接。
主要功能
- 01区分轻量与完整周期
- 02创建目录时同步写入首个文件
- 03完整计划包含论点、范围和质量门槛
- 04为完整周期编写步骤与证据门槛
- 05对齐 AGENTS.md 与 README 文档职责
适用场景
- 01为小型修复创建简短回顾种子
- 02为有设计空间的周期制定计划
- 03在会话中断后恢复周期工作
- 04规划涉及可发布内容的文档更新
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lilmgenius/ paperthin --skill re0-plan安装后在 Claude Code 中输入/re0-plan确认已加载。
详细介绍
在 re0-loop 的周期运行哪怕一行之前,就打开 .re0/iteration/<version>-<workname>/ 并同步写入内容。
目标
如果没有写下论点、门槛清单和步骤计划,周期就会偏向最先出现的任何思路;而一个打开后空空如也的文件夹,对恢复的会话毫无帮助。re0-plan 一次性弥补这两个缺口:从文件夹创建之时起,它就绝不会是空的,无论周期最终采用哪种权重。它假定已安装完整的 paperthin 套件,并直接点名其同级技能。它与负责归档文件夹的 re0-release 以及在此技能播种的内容基础上继续扩展、而非从头开始的 re0-memo 配合使用。它不是一种可移植的规划方法——它写入的格式是本仓库自己的约定。
工作流
- 判定周期的权重:没有实质设计空间的修复或加固工作属于轻量级;确实值得仔细权衡方向的周期属于完整。
- 创建
.re0/iteration/<version>-<workname>/,并在同一步中写入第一个文件——文件类型由权重决定:- 轻量级 →
RETRO.local.md:用一段话说明任务及其轻量级的原因。re0-memo会在最后扩展同一个文件,绝不另起一个文件。到此为止。 - 完整 →
DESIGN.local.md:论点、范围和质量门槛——与re0-loop的 FRAME 阶段所需内容相同,且足以单独支撑会话中断后的恢复。如果变更涉及可发布的内容,这些门槛必须始终包含 AGENTS.md/README 反思门槛(见规则)。使用readchk确认阅读情况,用modelchk确定层级;只有当方向确实存在争议时,才使用macrothink或其他判断类技能。
- 轻量级 →
- (仅限完整周期)编写
WORKFLOW.local.md:列出此周期按re0-loop的阶段顺序执行的具体步骤——针对本次构建,而非复述re0-loop的通用阶段。 - (仅限完整周期)编写
EVIDENCE.local.md:列出DESIGN.local.md中的门槛,作为尚待填充的证明范围——写明标准,而非结果。 - 将参考材料平铺存放为
REF-<topic>.local.md;只有文件数量增加到两三个以上时,才将其移入refs/子文件夹。 - 移交给
re0-loop。此处不要调用re0-work——从头重新开始是re0-loop自己在周期中途发起的调用;必要时由nba显示,绝不是设置步骤。
规则
- 创建时文件夹绝不为空。 无论是轻量路径还是完整路径,都会在创建文件夹的同时写入实际内容,确保即使会话在任何时刻中断,也总有内容可供继续。
- 按设计不可移植。 直接指向其他 paperthin 技能,并假定已安装完整套件——这与此处其他技能一贯遵循的自包含默认方式恰恰相反。它只与
re0-release和re0-memo配套使用,不适合单独使用。 - 不填充无关内容。 轻量路径不包含
DESIGN/WORKFLOW/EVIDENCE,其RETRO.local.md种子内容保持为一个段落——它是任务说明,不是伪装成WORKFLOW.local.md的文件。绝不会为了「以防万一」而强行加入判断类技能或re0-work。 - 文件夹的
<version>是暂定的。 使用re0-release所采用的相同次要/修补版本判定标准——看性质,而非规模:相对于产物自身先前的规范,这项变更是修复(修补版本),还是用户新近会主动寻求的一项新能力(次要版本)?同时,若本轮产生了尚未解决的分支,就让版本号继续保持待定。绝不提前承诺本轮尚未挣得的确定升级;若某个分支可能新增技能,在它解决之前,版本升级就应保持未定。 - 文档保持一致,与
re0-release发布时的做法相同。 当本轮变更触及可发布内容时,其质量门始终包含 AGENTS.md/README 反映检查,并根据 AGENTS.md 的文档职责划分,将每项反映分配到相应文档:内部机制/规则/结构 → AGENTS.md(供大模型和人类阅读,作为指令注入);面向用户的目录/体验 → README(仅供人类阅读,绝不注入)。绝不把 Agent 指令机制一股脑放进 README,也绝不在面向用户的变更中跳过 README。这是计划阶段的补充步骤,对应re0-release在发布阶段的 README 步骤。 - negatives-as-corpus — 不删除此技能或它开启的本轮产出的任何内容;出错的本轮由
re0-release退役,而非丢弃。 - 每个
EVIDENCE.local.md检查项都必须能追溯到DESIGN.local.md中的一行;不要凭空添加DESIGN未要求的证明内容。
验证
完成前:
- 文件夹从存在的那一刻起就有实际内容——无论走哪条路径,都不能有空目录。
- 完整路径:
DESIGN.local.md写明论点、范围和检查项;WORKFLOW.local.md的步骤针对本轮具体定制;每个EVIDENCE.local.md检查项都能追溯到DESIGN.local.md。 - 轻量路径:
RETRO.local.md已用任务和原因作为种子内容,且只有一个段落。 - 参考资料保持扁平,除非有充分理由创建
refs/子文件夹。 - 说明选择了哪条路径,以及原因。
评论
支持 Markdown