Communitygithub.com

PaeoniaCommon/SkillsOdea

将自然语言目标分解为有序步骤和嵌套子流程,规划一个新的 toy_process 流程。当用户要求创建新的流程、工作流或管道时,首先使用该技能,然后再编写任何代码。

SkillsOdea 是什么?

该技能(PaeoniaCommon/SkillsOdea)帮助开发者将自然语言描述的目标转化为一个结构化的流程规划。它首先将目标拆解为一系列有序的小步骤,并基于步骤的复杂性(单一动作 vs 多个相关动作)以及可复用性,决定每个步骤是作为方法步骤还是子流程步骤。子流程支持嵌套,但建议最多两层。随后,技能要求为每个流程(包括父流程和子流程)记录类名(CamelCase)、参数(含默认值)、步骤列表(方法用 snake_case,子流程用类名)以及上下文键(每个步骤读写的内容)。最后,技能会检查步骤间的上下文依赖关系,确保每一步读取的上下文键都由之前的步骤写入,且所有使用的参数都已在流程参数中定义。该技能适用于 Cursor 等基于 AI 的编辑器,旨在替代直接编写代码前的人工设计阶段,提升流程开发的效率与正确性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PaeoniaCommon/SkillsOdea/tree/HEAD/.opencode/skills/design-process

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

设计流程

使用此技能将诸如“创建一个统计文本中单词数的流程”之类的请求转化为步骤计划。然后通过 create-process 技能构建它。

包位于 process_package/ 目录下。父类是 process_package/toy_process/process.py。

1. 列出步骤

将目标写成一个有序的小操作列表,每个操作以动词短语形式呈现:

WordReport
  1. 清洗文本
  2. 统计单词
  3. 生成报告

每个步骤应只做一件事,并将结果放入共享的 context 字典中。

2. 确定每个步骤的性质

对于每个步骤,做出选择:

使用方法步骤的情况...使用子流程步骤的情况...
它是单个小操作它是属于一起的多个操作
它仅在此处使用它可以在其他流程中复用
它不需要自己的设置它有自己的参数

子流程可以包含子流程。保持嵌套层次浅:对于大多数 toy 流程,两层已经足够。

3. 写下计划

对于每个流程(父流程及每个子流程),记录:

  • 类名:采用 CamelCase 命名的名词或动词短语,例如 CleanText。
  • 参数:名称 → 默认值。这些放在 set_parameters 中。
  • 步骤:按顺序。方法使用 snake_case;子流程使用其类名。
  • 上下文键:每个步骤读取和写入的内容。

示例计划:

CleanText            参数: lowercase=True
  - strip_punctuation   读取 text   写入 text
  - normalise_case      读取 text   写入 text

WordReport           参数: text="", lowercase=True, top_n=3
  - load_text          读取 -       写入 text
  - CleanText(lowercase=...)   (子流程)
  - count_words        读取 text   写入 counts
  - build_report       读取 counts 写入 report

4. 检查计划

  • 每个步骤读取的上下文键都必须由之前的某个步骤写入。
  • 每个步骤使用的参数都必须存在于该流程的参数列表中。
  • 子流程从其父流程以关键字参数形式获取参数,例如 CleanText(lowercase=self.params["lowercase"])。

如果请求比较模糊,请将计划展示给用户,然后遵循 create-process 技能。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能