技能包

Monozukuri:用日式工艺流程让 agent 写出简洁可验证的代码

Monozukuri 最适合让 agent 按日式工艺流程构建和维护简洁、可验证的软件,但先确认你的 agent 支持 Agent Skills 格式,且官方未说明它是否会直接改动文件、执行命令或联网。

官方来源 · kuya-egg/Monozukuri

安装

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

适合谁

  • 适合希望 agent 在写代码时遵循一条可核查的流程(观察→理解→计划→实现→验证→反思→改进),而不是一次性输出代码的开发者。
  • 适合使用支持 Agent Skills 格式的 agent 的用户:每个技能是顶层 <name>/SKILL.md 目录,官方说明它兼容任何支持该格式的 agent。通过 $monozukuri-core 显式调用。
  • 不适合的情况:证据未说明它依赖的具体运行时版本、未列出经过验证的客户端清单,也未说明对文本/文档类任务的支持情况——本技能面向软件构建与维护,证据未涉及其他用途时请勿假设。
  • 官方未说明的:支持的编程语言、是否需要网络访问、各技能的具体副作用边界,均无证据,使用前自行确认。

3 分钟完成第一次尝试

前提:本机有 Node.js/npx;使用一个支持 Agent Skills 格式的 agent。官方提供两条安装方式,这里只推荐一条主路径:

主路径:skills CLI 安装核心技能

在项目根目录运行:

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

这只安装伞技能 monozukuri-core。若之后想安装全部 12 个技能(伞技能 + 11 个聚焦技能),官方的同一条 CLI 支持通配符:

npx skills add kuya-egg/Monozukuri --skill '*'

(官方另提供作为 Claude Code 插件的安装方式:/plugin marketplace add kuya-egg/Monozukuri 后 /plugin install monozukuri@monozukuri,会装全部 12 个技能并以 monozukuri 命名空间加载;本文不把并列成主路径。)

触发一次低风险任务:装好后,在 agent 中显式输入 $monozukuri-core,并给它一个小型只读/分析类任务,例如「按 craftsmanship 流程检查某个小函数的正确性与简洁性」。核心工作流为 Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen。

成功信号:agent 沿用上述七个阶段的流程组织回答,而不是直接丢出代码;聚焦技能按官方顺序串联(如 nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka)时说明全部技能已生效。注意:本技能面向代码任务,不存在小说/专业文档的分路线 rubric;若你给它文本写作任务,证据不保证有对应流程。$monozukuri-core 只是显式触发方式,它是否读写文件、执行命令或访问网络,官方未说明,第一次尝试请选不会造成副作用的任务。

使用案例

案例一:小函数的工艺化检查 场景:你想让 agent 认真审视一段已有代码。发起方式:在支持的 agent 中输入 $monozukuri-core,附上目标代码并要求按流程评估。使用的工作流:伞技能的 Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen。可期待结果:agent 分阶段给出观察、理解、计划与验证建议,而非直接改写;至于是否需要你确认后才改动文件,证据未说明,建议明确要求只分析不改文件。

案例二:完整特性开发走聚焦技能链 场景:先安装全部技能(--skill '*' 或 Claude Code 插件方式),然后让 agent 开发一个小特性。使用的工作流:聚焦技能按官方顺序 nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka 串联,覆盖从准备到验证的完整链路。可期待结果:agent 按各技能的阶段推进并给出每个阶段的产出;各聚焦技能各自的触发方式和具体副作用在证据中未展开,实际执行前向 agent 确认每一步是否会修改代码。

使用边界

  • 安装差异分平台:skills CLI(npx skills add ...)是通用路径;Claude Code 平台使用 /plugin marketplace add + /plugin install monozukuri@monozukuri,安装全部 12 个技能并带 monozukuri 命名空间。不要把两者混用或推断其他客户端的安装方式。
  • 触发方式:官方说明为显式调用 $monozukuri-core;其他技能的调用语法证据未给出。
  • 副作用与确认点:本技能会引导 agent 写代码,但证据未说明它是否会直接修改你的文件、执行命令或访问网络;这些均为未知。第一次尝试优先只读分析任务,任何改动前要求 agent 先展示计划。
  • 官方明确限制:monozukuri-core 单独安装只含伞技能流程;完整技能链需安装全部 12 个技能。官方未给出支持的编程语言、语言环境、网络要求和客户端清单。
  • 未确认的关键信息:各聚焦技能的具体行为、更新/卸载方式、许可证外的使用条款,证据中均未涉及,使用前请查看仓库原文。