科学

数据 社区

技能解读

当前原文的自动摘译,尚未人工审校。

用途

当用户提供一个或多个数据文件(CSV、FASTA 或其他科学格式)并想要探索或分析它们时,请使用此技能。首先捕获上下文——在问题(生物、化学或数据科学问题)得到明确说明并且代理被调整为指导助手之前,不要加载或绘制数据。

要求

uv 用于运行 Python 脚本:每个脚本都使用 PEP723 内联脚本元数据,并使用 uv run script.py 运行。不要运行临时 Python 或原始解释器;每个脚本都声明并管理自己的依赖项。能够通过脚本块中声明的依赖项读取相关数据格式(pandas、BioPython 等)。

它的作用

上下文优先 – 在接触数据之前捕获并记录问题上下文(什么问题、什么领域)。第一步——帮助用户缩小到第一个图或第一个摘要(而不是一堆代码或图)。人工指导执行——接受下一步做什么的指示;当用户说“制作这个图”或“给我那个表”时,在做之前询问为什么,然后执行。会话布局 – 每个分析都是一个会话:analysis/下的一个文件夹,具有描述性名称和开始日期/时间,包含journal.md、plots/和scripts/。

第 1 阶段:捕获上下文(在接触数据之前)

不要打开数据文件并开始编码或绘图。询问或确认:问题背景——生物、化学或数据科学问题;用户希望了解或决定什么;以及任何约束(例如特定变量、子集)。将其记录在会话的journal.md中(参见第 3 阶段)。只有在记录并同意上下文之后,才能继续检查数据形状并规划第一步。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
数据
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@ericmjl · MIT
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 阶段:捕获上下文(在接触数据之前)

不要打开数据文件并开始编码或绘图。询问或确认:问题背景——生物、化学或数据科学问题;用户希望了解或决定什么;以及任何约束(例如特定变量、子集)。将其记录在会话的`journal.md`中(参见第 3 阶段)。只有在记录并同意上下文后,才能继续检查数据形状并规划第一步。

02
第 2 阶段:开始数据分析会话

在`analysis/`(或项目同意的基础)下创建一个会话文件夹。将其命名为描述性 + 会话开始时的 ISO 日期时间,例如`analysis/2025-02-05T14-30-00-protein-binding/`。每个会话文件夹的规范布局: `journal.md` – 此会话的仅附加运行日志 `plots/` – 所有图形(WebP 仅适用于 matplotlib) `scripts/` – 加载数据、总结或绘图的一次性脚本

03
第 3 阶段:日志(仅附加,每次会话)

在采取每项实质性行动之前,请阅读会议的`journal.md`。在日志中记录:数据形状:加载或检查数据后,记下列(以及相关类型)、行计数和任何结构(例如多索引、FASTA 计数、关键字段)。一旦形状已知并且在任何主要数据步骤之后就执行此操作。做了什么(哪个剧本、哪个情节、哪个摘要)发现、惊喜和后续想法

04
第四阶段:了解形状,然后是第一步

数据的形状:在提出或制作图表之前,确保代理(和用户)知道:存在哪些列/字段、有多少行/记录以及任何关键结构。将其记录在`journal.md`中的`[SHAPE]`条目下。单个第一个图(或表格):帮助用户选择第一个可视化或摘要(例如一个分布、一个概览表)。不要一次生成很多图;对齐该单个步骤,然后执行。

05
第五阶段:人工指导执行和“问为什么”

接受指示:用户可能会要求特定的图表、表格或过滤器。明确后才执行。在做之前先问为什么:当用户说“制作这个图”或“给我那张桌子”时,简短地问为什么(例如它支持什么决定或问题)。然后运行脚本并将结果记录在日志中。在每个操作之后:建议最合乎逻辑的下一步(一步),并让用户确认或重定向。不要自动执行长管道。

06
第 6 阶段:脚本(一次性、PEP723、uv 运行)

用于此 EDA 的所有 Python 都位于会话的 `scripts/` 文件夹下的脚本中。每个脚本的顶部都有 PEP723 内联脚本元数据(`# /// script`、`requires-python`、`dependencies`、`# ///`)。使用 `uv run script.py`(或带有 CWD = 会话文件夹的 `uv run scripts/script_name.py`)运行。不要运行原始的`python`或将代码粘贴到 REPL 中;脚本是执行单元并拥有其环境。

07
第 7 阶段:绘图(WebP 仅适用于 matplotlib)

将所有 matplotlib(和类似)图形保存为 WebP,而不是 PNG,以保持较小的图像尺寸。使用例如`fig.savefig("plots/overview.webp", format="webp")`。将绘图文件写入会话的`plots/`目录中。描述性地命名文件(例如 `distribution_response.webp`、`first_ten_records.webp`)。当您记录所做的事情时,请在日志中参考这些图。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。