Skip to content

user-skills-plan.md

Latest commit

 

History

History
84 lines (53 loc) · 6.6 KB

user-skills-plan.md

File metadata and controls

84 lines (53 loc) · 6.6 KB
Raw

使用侧 Skill 规划

状态：规划稿，尚未实现新的 Skill 或 CLI 命令。

按当前讨论过的场景规划：安装到另一台机器、导入实验室库存、新增仪器、基于实际库存设计多色 panel，以及记录抗体质量。更具体的实验类型和复盘习惯尚未确认，不预设为既有需求。

程序、实验室数据和 Skill 的位置

内容 当前默认位置
CLI 环境，Linux/macOS ~/.local/share/panelagent/cli/
CLI 环境，Windows %LOCALAPPDATA%\PanelAgent\cli\
实验室 SQLite，Linux/macOS ~/.local/share/panelagent/panelagent.db
实验室 SQLite，Windows %USERPROFILE%\.local\share\panelagent\panelagent.db
用户 Skill pa skill install --dest DIR 指定的 DIR/panelagent-cli/

程序目录可通过安装器 --prefix 改变；数据位置由 --db > PANELAGENT_DB > 默认值决定。pa db path 显示本次命令选择的数据位置，不会创建数据库。安装器仅用临时数据自检，不初始化正式实验室库。

原始 CSV 可以保留在自己的实验室文件夹，导入后以 SQLite 为运行事实来源；编辑原 CSV 不会自动更新数据库。一个数据库对应一个实验室，库内可以有多个抗体库和多台仪器。安装目录中的 seed 是分发参考数据，不是实验室日常维护入口。

拆分方案：先做两个，第三个后续增加

Skill 触发场景 产出与职责 阶段
panelagent-design “用现有库存设计 CD3/CD4/CD8 panel”“这个 marker 没抗体，怎么调整？” 确认实验条件、发现库存/仪器、生成候选、解释诊断与取舍；保留原始条件和计算结果 第一阶段
panelagent-lab-data “导入这张库存表”“加一台仪器”“这支抗体质量不好”“查看当前数据库在哪” 定位实验室数据，核对输入、预览影响、执行受支持的导入/质量维护、复查结果 第一阶段
panelagent-review “比较实验前后的方案”“结合这次反馈整理下一版方案” 汇总已有方案和用户提供的实验反馈，区分观测、推测与调整建议，形成可追溯复盘记录 第二阶段

按使用意图拆分，不为每个 CLI 子命令建立 Skill，也不为 CLI/MCP/Web 复制三套同名工作流。当前 CLI + Skills 发行先实现 CLI 调用方式；未来需要 MCP 适配时，再增加相应执行说明，并保持 MCP 当前只读边界。

当前 panelagent-cli 已覆盖查询、生成和部分维护，第一阶段先把它作为已有入口保留。新 Skill 验收前不移除旧文件；迁移后避免同时保留触发条件重叠的“大而全” Skill。

panelagent-design

必要输入：已确认的 marker、抗体库、仪器、质量纳入设置。若用户只有实验目标，先形成待用户确认的 marker 建议，不把模型建议当作已确认条件。

基本流程：

  1. 定位明确的实验室数据库，查询可用库和仪器；复用本次会话已确认的信息。
  2. 查询 marker、抗体选择和质量信息，识别缺项。
  3. 调用确定性生成/诊断命令；业务无解、搜索预算耗尽和执行失败分别处理。
  4. 输出候选及条件、通道/质量限制；如果需要替换 marker 或纳入 bad 抗体，说明改变的条件。
  5. 需要导出时保存 CLI JSON 和可阅读结果。CLI 当前没有共享历史写入命令，不声称已保存到 Web 历史。

不编造库存、亮度或仪器通道；不把候选排名描述为已验证的生物学最优方案。文献检索仅在实验任务需要且有可用来源时进行，不给本地 CLI Skill 加强制网络依赖。

参考文件只在相应任务中读取：结果字段说明、无解处理、可选的导出模板。CLI 参数和错误规则集中维护，避免每个 Skill 各自复制一份。

panelagent-lab-data

包含三个按需读取的操作说明：库存导入、仪器配置、质量维护。安装与数据库定位是该 Skill 的简短入门流程，不单独拆成安装 Skill。

每次维护要明确目标数据库、库或记录。输入预览应说明新增/更新/歧义/无效行，实际写入通过公开内核能力与 CLI 执行；不能让 Skill 临时生成任意 SQL 来补齐缺失功能。

当前可用：首次 pa init --csv、库存查询、pa antibody annotate、pa dye alias-add。

当前缺口：

  • 独立库存导入命令：追加/更新库存，不重跑 seed；复用现有内核 CSV 导入逻辑。pa init 每次都会重跑 seed，不适合替代专用日常维护入口。
  • 导入预览和校验：变更数量、行级问题、重复/匹配身份、必要时报告歧义；当前没有 --dry-run 导入契约。
  • 通用仪器导入：当前配置导入固定写入 Beckman/CytoFLEX，不能新增任意厂商/型号；需要统一 schema 和冲突处理。
  • 数据备份/恢复：明确 SQLite WAL 的一致性处理，不能把复制正在写入的主 DB 文件当作可靠备份。
  • CLI 质量清空：现有 annotate 支持 good/warn/bad，Web 可清空；使用侧维护应补齐明确的 CLI 清空语义。

以上是待开发能力，不是当前已存在的命令。优先先补独立库存导入，再补仪器导入和影响预览，然后编写相应 Skill 操作说明。

panelagent-review 的启用条件

当前可以诊断方案和记录行内质量。独立复盘 Skill 应等用户确实开始积累并比较实验记录后再做：先明确记录结构、文件或历史来源，再决定是否需要 CLI 历史/导出能力。

不预设 FCS 数据分析、自动补偿或全光谱解混已被内核支持。它们若成为实际需求，应独立评估数据与算法支持。

实验室上下文

Skill 保持通用；实验室自己的数据库路径、常用库、仪器标识和偏好放在用户指定的工作目录说明中，不写死进分发 Skill。当前尚无自动加载该说明文件的机制，agent 需显式读取用户提供的说明。

上下文只表达选择与偏好，真实库存/仪器可用性仍通过 CLI 查询。模型凭据不放入 Skill 或实验室说明文件。

验收方式

  • 新机器安装后，agent 仅凭 Skill 和用户任务完成发现、生成与诊断，不依赖源码路径。
  • 修改库或仪器前，已有数据不会被隐式替换；对未实现能力明确说明缺口。
  • 导入命令落地后，使用临时数据库验证重复导入、质量保留、错误输入与变更预览。
  • 以“导入库存”“生成候选”“记录指定抗体质量”三个真实任务进行独立 agent 验收；只校验 SKILL.md 格式不能代替行为验收。