Yuzuru 工程扩展 MattoYuzuru/yuzuru-skills

Yuzuru 工程扩展

Yuzuru 是跨智能体扩展 monorepo，面向 Codex、Claude Code 和 DeepSeek Harness。它提供可移植的独立智能体技能、十二个可独立安装的插件、轻量厂商适配层、确定性辅助工具、仓库市场、schema、钩子、评测契约，以及安全的本地命令行。

规范行为放在各个技能包里。Claude 智能体与钩子、Codex UI 元数据、双清单和市场只做适配，不另外维护一份提示词副本。

快速开始

git clone https://github.com/MattoYuzuru/yuzuru-skills.git
cd yuzuru-skills
./install.sh

yuzuru list
yuzuru skill install search-workflow
yuzuru marketplace add --agent codex
yuzuru marketplace add --agent claude
yuzuru plugin install sde-agent --agent codex
yuzuru plugin install sde-agent --agent claude

DeepSeek Harness uses its native profile manager; see the distribution guide.
pnpm dsh plugin --profile web add "$PWD/skills" "$PWD/plugins/sde-agent"

install.sh 把 yuzuru 链接到 ${YUZURU_BIN_DIR:-~/.local/bin}。它本身不安装、也不启用任何能力。

独立技能使用 ~/.agents/skills 和 ~/.claude/skills 下的托管符号链接；可用 YUZURU_CODEX_SKILLS_DIR 和 YUZURU_CLAUDE_SKILLS_DIR 覆盖。插件仍归各自的原生管理器管，安装状态和启用状态由它负责。

常用命令

yuzuru list --kind skill
yuzuru list --kind plugin
yuzuru plugin list --agent claude
yuzuru plugin inspect architecture-agent
yuzuru skill validate all --strict
yuzuru plugin validate all --strict
yuzuru validate --strict

yuzuru update
yuzuru marketplace update --agent codex
yuzuru marketplace update --agent claude
yuzuru plugin disable sde-agent --agent claude
yuzuru plugin uninstall sde-agent --agent claude
yuzuru doctor
yuzuru doctor --repair

Claude 提供非交互式的插件启用/禁用命令。当前 Codex 把这项控制放在交互式 /plugins 视图里；yuzuru plugin enable|disable ... --agent codex 会返回 interaction_required，绝不改写 Codex 配置。

更新会拒绝脏工作区，只用 git pull --ff-only。它从不 reset、stash、merge、rebase，不重新启用插件，也不覆盖非托管的安装。

插件目录

| 插件 | 用途 |
| discovery-agent | 基于证据的机会发现、竞品、区域适配、可行性与风险。 |
| product-agent | 按需定制的 PRD、用户行为、可演进的 MVP 边界、验收与可追溯性。 |
| architecture-agent | HLD/LLD、契约、容量、安全边界、故障语义与迁移。 |
| devops-agent | 随仓库自适应的 CI/CD、交付、基础设施、回滚、可观测性与运维。 |
| harness-agent | 智能体就绪度、文档导航、能力清单与代码智能决策。 |
| agent-orchestration | 自适应委派大型任务，检查依赖、资源、预算与证据。 |
| sde-agent | 专注实现、调试、测试、自审、迁移，并给出完成证据。 |
| frontend-agent | 把控 UX 方向、独特设计、前端架构、实现、无障碍与视觉效果。 |
| sre-agent | 独立验证行为、可靠性、性能、安全、E2E 与发布。 |
| cleaner-agent | 保守清理文档、代码与产物，并给出删除证据。 |
| time-messenger | 通过语义 MCP 服务器读取 TiMe API v4，并在明确授权后写入。 |
| telegram | 通过固定版本、打包好的 TDLib MCP 服务器，跑通 Telegram 用户账号工作流。 |

plugins/<id>/ 下每个包只有一个逻辑身份，包含精简的宿主清单与 DSH bundle、主编排技能、配套技能、仅在确有必要时提供的 Claude 专家适配器、脚本或钩子、README，以及 eval 契约。任何包都不依赖目录外的符号链接。

独立技能目录

| 技能 | 用途 |
| central-university-lms | 无头检查 LMS，安全处理作业与状态工作流。 |
| fetch-public-docs | 通过配置好的白名单桥接，获取被拦截的公开文档。 |
| github-workflow | 处理 GitHub 仓库、issue、pull request、Projects、Actions 与本地 Git。 |
| gitlab-workflow | 处理 GitLab 仓库、merge request、讨论、流水线与 fork 交付。 |
| google-ai-search | 借助 Google Search grounding 做省 token 的公开研究。 |
| google-sheets-workflow | 读写 Google Sheets/Drive，控制写入，处理公式与结构。 |
| jira-workflow | 发现、创建、关联 Jira issue，做质量检查与状态流转。 |
| meeting-artifacts-workflow | 通过兼容连接器，在会议产物中找证据、决策与后续事项。 |
| russian-editorial-style | 面向技术、长文、商务与短篇体裁，做有证据意识的俄语编辑。 |
| scientific-evidence | 免密钥检索论文，检查版本与勘误，限量获取科学章节与表格。 |
| search-workflow | 在本地源码、文件、结构化数据、文档与归档之间快速路由。 |
| messenger-workflow | 读取、搜索、总结用户配置的 messenger，并安全更新。 |
| write-kotlin | 按仓库自适应实现与重构 Kotlin。 |
| workstation-dev | 诊断本地 Docker/工具链，协调检查并给出最新测试证据。 |

现有技能路径保持不变。克隆位置变动导致托管链接失效时，可用 yuzuru doctor --repair 诊断并修复；非托管文件与符号链接永远不会被替换。

市场、配置档与生命周期

目录都是提交进仓库的源文件：

- Codex：.agents/plugins/marketplace.json；
- Claude Code：.claude-plugin/marketplace.json。
原生等价物与启用/禁用/卸载细节见 Marketplace installation。版本解析与每个插件的规范版本来源见 Releasing。缓存、启用状态、凭据、用户配置都不应放进 Git。

DeepSeek Harness 通过 dsh plugin --profile 安装 skills/ 和每个 plugins/<id>/ 下的纯配置 package.json 包。每个包只挂载一个隔离的 dsh-skill-filesystem 服务商，并引用规范技能文件，不复制它们。

编写与校验

从 docs/NAVIGATOR.md 开始。它指向仓库架构、独立技能编写、插件打包、脚本、钩子、MCP 策略、schema、测试、分发、安全与贡献工作流。根目录 AGENTS.md 刻意保持精简。

yuzuru skill new my-skill \
--description "Perform a bounded workflow. Use when the user requests that workflow." \
--resources scripts,references
yuzuru plugin new my-plugin \
--description "Package a bounded capability for supported agents." \
--trigger "the user requests this concrete workflow"

python3 scripts/smoke_scripts.py
python3 scripts/run_tests.py
python3 scripts/run_evals.py
yuzuru validate --strict

运行时状态放在 XDG 配置/缓存/数据位置（带平台对应的 home 回退）、临时目录或原生插件数据目录。常规命令不得在克隆目录内创建环境、依赖缓存、日志、报告、索引、截图或字节码。

指令刷新

October 2026 review 覆盖每个技能，说明当前的模型差异、保留的领域控制与实测限制。编写相关见 model guidance，隐式选择用例、观测运行评分与私有本地使用摘要见 testing。

信任模型

默认只读检查。外部写入、生产变更、破坏性清理与负载/故障测试，需要按其影响范围获得明确的范围与授权。脚本限制输出、避免输出凭据、校验目标，并在适用时为写入提供 dry run。见信任模型与影响级别。