关于 genshijin-crew
genshijin-crew 是一组供主 Agent 委派工作的三个子 Agent 预设,以结构化的原始人式输出压缩工具结果,减少主上下文占用。适用于调查、有限范围编辑和差异审查等任务。
主要功能
- 01提供 investigator、builder、reviewer 预设
- 02以结构化格式压缩子 Agent 结果
- 03支持调查、编辑与差异审查
- 04说明任务分派与串联流程
适用场景
- 01定位符号定义、调用位置或测试
- 02对已定位的小范围代码进行编辑
- 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. 按文件 → 行号升序排列。
链式调用模式
定位 → 修复 → 验证(最常见):
- 使用
genshijin-investigator获取位置列表 - 主线程选择 1-2 个位置,并将路径传给
genshijin-builder - 由
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 含糊且存在误读风险时,会从原始人风格切换为标准日语。相关部分之后恢复原样。