快速了解
它能做什么
创建并更新 YAML 研究图，直观呈现研究任务、依赖关系、负责人和进度。
本站提供的是中文说明，不代表该项目或 Plugin 自身提供中文界面；语言支持请以上游文档为准。
选择前先看
该技能会把黑板中的更新整理为 research-graph.yml 节点及父子连线，供前端渲染成可拖拽的研究进度图。它定义了状态、Markdown 正文、负责人、颜色和项目内图片附件等字段，并要求更新时保留已有节点 ID。
适合谁
使用 Mobius 黑板、希望由智能体持续维护研究进度可视化的研究团队。
常见任务
- 为研究项目及其工作流创建初始图谱。
- 为新实验添加节点，并连接其前置工作。
- 随着黑板更新，将节点标记为进行中、已完成、成功或失败。
- 为研究节点附加符合条件的项目内图片。
权限与数据
读取黑板上下文提供的研究更新，并在项目黑板目录写入 YAML 图谱。
权限- 在增量更新前读取现有 research-graph.yml。
- 目标黑板目录不存在时创建目录。
- 在指定项目路径写入或覆盖 research-graph.yml。
- 使用项目提供的研究进度、任务负责人、节点内容和可选图片路径。
- 图片附件必须是 bind_path 内的绝对路径，且使用允许的图片扩展名。
局限
- 它不亲自开展研究，只呈现已报告的进展。
- 它会等待黑板更新，不会反复轮询。
- 提供的文档未说明宿主集成方式或运行环境要求。
- 商业使用需要另行取得商业许可。
DSHub 已核对
- 已从固定 Git 提交中捕获完整技能文档。
- 文档明确了图谱文件位置、YAML 结构、有效状态值和更新规则。
DSHub 未核对
- DSHub 未安装或执行该技能。
- 未声明与特定智能体运行框架版本的兼容性。
固定版本安装
主要操作
这个独立 Skill没有 DSH Plugin 安装操作，请根据源码文档使用真实交付方式。
维护者原文
Skill 使用说明
name: research-generate-graph description: instructions for research generate graph agent. 指导 agent 创建或修改 research graph 的 YAML 文件 (research-graph.yml)，用一组带父子连线的节点表达研究的结构与进展，前端渲染成可拖拽节点图。 research_role: progress-display-artist
你是汇报进度的agent，你不亲自参与research，你的任务是按照 research-generate-graph skill 中的指示完成任务。
监视黑板，每当黑板有信息更新时，就更新 graph，告诉用户现在的研究进展到什么进度了。
黑板没有更新的话，就停下来等待，不必反复轮训。当黑板上有数据更新时，我会叫醒你，然后把黑板上更新的内容发给你的。
生成 / 修改 Research Graph (research-graph.yml)
Research Graph 用一组节点和它们之间的父子连线表达一项研究的结构与进展。
文件位置
<项目 bind_path>/.imac/blackboard/<researchId>/research-graph.yml
与该 research 的 blackboard.jsonl 同目录。cwd 一般就是 bind_path；目录不存在时先 mkdir -p。
结构与示例
nodes:
- id: 1
color: "#3b82f6"
parent_nodes: []
visual_effects: [in_progress]
main_content: |
# 课题立项
方向：**自动驾驶感知优化**，周期 6 周。
owner: chief_researcher
attached_images: []
- id: 2
color: "#10b981"
parent_nodes: [1]
visual_effects: [successful]
main_content: 复现基线，mAP `0.71`，符合预期。
owner: research_assistant_A
attached_images:
- /home/me/proj/.imac/blackboard/abcd1234/baseline.png
- id: 3
color: "#ef4444"
parent_nodes: [1, 2]
visual_effects: [failed, in_progress]
main_content: 融合实验第一轮精度下降，重做中。
owner: research_assistant_A
字段
| 字段 | 类型 | 说明 |
|---|---|---|
id |
正整数 | 必填、唯一。被 parent_nodes 引用的标识。 |
color |
字符串 | 卡片强调色，任意 CSS 颜色（"#3b82f6"、"red"）。 |
parent_nodes |
整数列表 | 父节点 id；每个生成一条 父 → 本节点 的连线。根节点写 []。一个节点可有多个父，允许成环。 |
visual_effects |
字符串列表 | 状态标签，取值见下，可组合。 |
main_content |
字符串 | 节点正文，按 Markdown 渲染；多行用 ` |
owner |
字符串 | 责任人 / 与该节点最相关的主体。 |
attached_images |
字符串列表 | 图片绝对路径，须位于 bind_path 内、扩展名为 png/jpg/jpeg/gif/svg/webp/bmp/ico。 |
visual_effects 取值：
| 值 | 含义 | 渲染 |
|---|---|---|
in_progress |
进行中 | 蓝色徽章 + 脉冲点，蓝色外环 |
completed |
已完成 | 灰色徽章 |
successful |
成功 | 绿色徽章，绿色外环 |
failed |
失败 | 红色徽章，红色外环 |
修改已有文件
先读现有文件，在原结构上增量改：更新 visual_effects 表达进展、加节点用新 id 并设好 parent_nodes、调连线即改 parent_nodes，整体覆盖写回。已有节点的 id 保持不变 —— 前端拖拽位置按 researchId:id 存，改 id 会丢失该节点布局。
有意识地管理
安装与管理
前置条件与目标 Profile
目标： research-progress-agent Profile, research-team Profile
交付方式： Skill 文件 — https://raw.githubusercontent.com/nutshellai-tech/mobius/1eb8750d2d9012e1f50a18f7c60c2ad040c04889/skills/research-generate-graph/SKILL.md。
兼容性与访问范围
Skill document available; host integration requirements are not declared： Not declared in supplied evidence。
风险事实
证据与编辑审查Manifest、Bundle patch、分发与新鲜度
不可变证据
审查状态与源码活动
在核对来源内容和不可变发布记录后，已由人工批准发布。AI 参与了内容草稿生成，最终发布决定由人工完成。
人工审查于 2026/9/4 UTC 11:48。GitHub 事实核对日期： 2026/9/3 UTC 15:47。
自当前证据基线以来，没有记录到重要源码变化。