mcpField
R
re0-plan

re0-plan

github.com/lilmgeniusAgent 工作流1.4k1.2k 次安装4 周前更新
代码仓库

关于 re0-plan

re0-plan 是为 paperthin 仓库的开发周期创建计划文件的 Agent 技能。它按周期规模立即写入不同内容,并将计划与证据门槛、执行步骤及配套技能衔接。

主要功能

  1. 01区分轻量与完整周期
  2. 02创建目录时同步写入首个文件
  3. 03完整计划包含论点、范围和质量门槛
  4. 04为完整周期编写步骤与证据门槛
  5. 05对齐 AGENTS.md 与 README 文档职责

适用场景

  1. 01为小型修复创建简短回顾种子
  2. 02为有设计空间的周期制定计划
  3. 03在会话中断后恢复周期工作
  4. 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 配合使用。它不是一种可移植的规划方法——它写入的格式是本仓库自己的约定。

工作流

  1. 判定周期的权重:没有实质设计空间的修复或加固工作属于轻量级;确实值得仔细权衡方向的周期属于完整。
  2. 创建 .re0/iteration/<version>-<workname>/,并在同一步中写入第一个文件——文件类型由权重决定:
    • 轻量级 → RETRO.local.md:用一段话说明任务及其轻量级的原因。re0-memo 会在最后扩展同一个文件,绝不另起一个文件。到此为止。
    • 完整 → DESIGN.local.md:论点、范围和质量门槛——与 re0-loop 的 FRAME 阶段所需内容相同,且足以单独支撑会话中断后的恢复。如果变更涉及可发布的内容,这些门槛必须始终包含 AGENTS.md/README 反思门槛(见规则)。使用 readchk 确认阅读情况,用 modelchk 确定层级;只有当方向确实存在争议时,才使用 macrothink 或其他判断类技能。
  3. (仅限完整周期)编写 WORKFLOW.local.md:列出此周期按 re0-loop 的阶段顺序执行的具体步骤——针对本次构建,而非复述 re0-loop 的通用阶段。
  4. (仅限完整周期)编写 EVIDENCE.local.md:列出 DESIGN.local.md 中的门槛,作为尚待填充的证明范围——写明标准,而非结果。
  5. 将参考材料平铺存放为 REF-<topic>.local.md;只有文件数量增加到两三个以上时,才将其移入 refs/ 子文件夹。
  6. 移交给 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 未要求的证明内容。

验证

完成前:

  1. 文件夹从存在的那一刻起就有实际内容——无论走哪条路径,都不能有空目录。
  2. 完整路径:DESIGN.local.md 写明论点、范围和检查项;WORKFLOW.local.md 的步骤针对本轮具体定制;每个 EVIDENCE.local.md 检查项都能追溯到 DESIGN.local.md。
  3. 轻量路径:RETRO.local.md 已用任务和原因作为种子内容,且只有一个段落。
  4. 参考资料保持扁平,除非有充分理由创建 refs/ 子文件夹。
  5. 说明选择了哪条路径,以及原因。

评论

支持 Markdown