mcpField
G
genshijin-crew

genshijin-crew

github.com/interfacex-co-jpAgent 工作流33211.9k 次安装12 周前更新
代码仓库

关于 genshijin-crew

genshijin-crew 是一组供主 Agent 委派工作的三个子 Agent 预设,以结构化的原始人式输出压缩工具结果,减少主上下文占用。适用于调查、有限范围编辑和差异审查等任务。

主要功能

  1. 01提供 investigator、builder、reviewer 预设
  2. 02以结构化格式压缩子 Agent 结果
  3. 03支持调查、编辑与差异审查
  4. 04说明任务分派与串联流程

适用场景

  1. 01定位符号定义、调用位置或测试
  2. 02对已定位的小范围代码进行编辑
  3. 03审查 diff、分支或文件中的问题

安装

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

$npx skills add https://github.com/interfacex-co-jp/genshijin --skill genshijin-crew

安装后在 Claude Code 中输入/genshijin-crew确认已加载。

详细介绍

genshijin-crew = 以原始人风格输出的 3 个 subagent preset。职责与 Anthropic 默认项(Explore、编辑类 agent、reviewer)相同。区别在于返回的 tool-result 已压缩 → 每次委派消耗的主上下文都会减少。

genshijin-crew 与替代方案的使用方式

任务使用
“X 的定义在哪里 / 调用 Y 的位置 / Z 的所有用法”genshijin-investigator
同上 + 还需要架构讲解/建议Explore (vanilla)
Surgical 编辑,≤2 个文件,范围明确genshijin-builder
新功能 / 3 个以上文件 / 跨领域重构主线程或 feature-dev:code-architect
Diff/branch/file 的 bug 审查genshijin-reviewer
需要附带理由和替代方案的深入代码审查Code Reviewer (vanilla)
已有确定的一行答案主线程,无需 subagent

判断标准:想要以 1/3 的 token 获取 subagent 输出,就用 genshijin-crew;想要散文形式的输出,就用 vanilla。

存在的意义(实际价值)

Subagent tool-result 会原样注入主上下文。Vanilla Explore 返回 2k tokens 的散文时,每次都会消耗主上下文 2k。同样的发现由 genshijin-investigator 返回时则约为 700 tokens。一个会话中委派 20 次,可能决定了是上下文耗尽还是任务完成。

输出约定

主线程可以依赖各 agent 返回的格式:

genshijin-investigator

<Header>:
- path:line — `symbol` — short note
集計: <counts>。

或 No match. 必须以文件路径开头,带行号,符号使用反引号括起。可通过 path:\d+ 进行 grep。

genshijin-builder

<path:line-range> — <change ≤10語>。
verified: <re-read OK | mismatch @ path:line>。

或以下任一项:too-big. / needs-confirm. / ambiguous. / regressed.(首个 token 为终止标记)。

genshijin-reviewer

path:line: <emoji> <severity>: <問題>. <修正>.
totals: N🔴 N🟡 N🔵 N❓

或 No issues. 按文件 → 行号升序排列。

链式调用模式

定位 → 修复 → 验证(最常见):

  1. 使用 genshijin-investigator 获取位置列表
  2. 主线程选择 1-2 个位置,并将路径传给 genshijin-builder
  3. 由 genshijin-reviewer 审查 diff

并行侦察(调查范围较广时): 在一条消息中并行启动 2-3 个 genshijin-investigator(从不同角度调查:定义、调用方、测试)。在主线程中汇总。

单次编辑(已知位置时): 跳过 investigator。直接向 genshijin-builder 传递 path:line。

禁止事项

  • 未确定文件位置时禁止使用 genshijin-builder。先启动 investigator → 否则主线程会因传递上下文而消耗 token。
  • 禁止使用 genshijin-investigator → genshijin-builder 链处理 5 个文件的重构。Builder 会返回 too-big. → 浪费一轮。
  • 禁止要求 genshijin-reviewer 提供“总体反馈” → 它只返回 findings,不提供架构意见。此类需求应使用 Code Reviewer。
  • 不要期待散文输出。genshijin-crew 的输出是结构化的,有时较难理解。若要让人类直接阅读,应由主线程改述。

自动切换(继承)

Subagent 在输出安全警告、确认不可撤销操作,或 fragment 含糊且存在误读风险时,会从原始人风格切换为标准日语。相关部分之后恢复原样。

评论

支持 Markdown