mcpField
R
research-add-fields

research-add-fields

github.com/julianobarbosa生产力1446 次安装3 天前更新
代码仓库

关于 research-add-fields

用于在研究流程中扩展 fields.yaml 字段结构的技能，适合需要补充研究维度的用户。它会先检查现有字段，再收集并确认新增字段后原位更新文件。

主要功能

  1. 01扫描并读取 fields.yaml
  2. 02支持用户输入或网络搜索提议字段
  3. 03逐项确认保留、删除或编辑
  4. 04设置类别、详细程度和必填状态
  5. 05原位追加并保留现有结构

适用场景

  1. 01为深入研究补充维度
  2. 02避免新增字段与现有定义重复
  3. 03在研究开始前扩展字段结构

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill research-add-fields

安装后在 Claude Code 中输入/research-add-fields确认已加载。

详细介绍

研究添加字段 — 追加到字段架构

就地更新 fields.yaml，添加额外的研究维度。

触发方式

/research-add-fields

工作流中的位置

/research-outline → ► /research-add-fields ◄ → /research-deep → /research-report

在 /research-outline 生成 fields.yaml 后的任何时候都可以使用，但最好在 /research-deep 之前使用，这样深度研究 Agent 就能在第一轮中填入新增字段。

工作流

步骤 1 — 自动定位字段文件

从当前工作目录使用 Glob 查找 */fields.yaml。使用 Read 读取文件，了解已定义的内容，避免建议重复字段，并在询问用户时展示当前类别。

步骤 2 — 选择补充来源

使用 AskUserQuestion 提供两个选项：

  • A. 直接输入 — 用户指定字段名称、描述和类别。
  • B. 网络搜索 — 通过 Task 工具（subagent_type: general-purpose）启动研究子 Agent，建议该主题领域的常见字段。
步骤 3 — 展示并确认
  • 向用户展示候选字段列表（无论来自 A 还是 B）。
  • 使用 AskUserQuestion 逐个询问候选字段：保留 / 删除 / 编辑。
  • 对每个保留的字段，记录：category（必须与现有的 field_categories[].category 匹配，也可以是新类别）、detail_level（brief | moderate | detailed）、required（默认为 false）。
步骤 4 — 保存更新

将确认后的字段追加到 fields.yaml，保留现有结构和顺序。就地保存。

字段格式（与 /research-outline 一致）

field_categories:
  - category: <name>
    fields:
      - name: <field_name>
        description: <what to capture>
        detail_level: brief | moderate | detailed
        required: false

输出

更新后的 {topic}/fields.yaml — 就地修改，保存前由用户确认。

注意事项

  • 追溯添加 required: true 会导致已完成的条目出错。 如果 /research-deep 已为部分条目生成 JSON，而你添加了新的必填字段，这些 JSON 将无法通过验证。应将字段设为 required: false，或者计划对受影响的条目重新运行 /research-deep。
  • 类别名称按字面匹配。 如果新字段的 category 与现有的 field_categories[].category 不匹配，架构中就会创建新的顶层类别。这样做没有问题，但请确认这是有意为之——此处的拼写错误会导致类别被悄然拆分。
  • B 选项中的网络搜索子 Agent 在对话上下文之外运行。 请将主题和现有类别的明确列表提供给它，让它提出的内容符合架构，而不是与现有内容冲突。
  • fields.yaml 还会被 ~/.claude/skills/research-outline/validate_json.py 使用。此技能写入的架构必须与该验证器保持兼容——使用相同的 field_categories[].fields[].name / required 格式，不使用特殊的 YAML 结构。

评论

支持 Markdown