mont-forge

生产级工程技能包：45 个技能覆盖 spec 到 ship 全生命周期，含中文意图路由总入口 mont-forge。合并自 addyosmani/agent-skills 与 mattpocock/skills（均 MIT）。

Packages

Package details

skill

Install mont-forge from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:mont-forge
Package
mont-forge
Version
0.2.0
Published
Nov 12, 2026
Downloads
609/mo · 609/wk
Author
royrao
License
MIT
Types
skill
Size
668.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

mont-forge

生产级工程技能包 —— 44 个技能，覆盖软件开发生命周期从 spec 到 ship，并补入大跨度规划、领域建模、issue 分诊等能力。 一个仓库，多端通用：同一份 skills/ 内容真源，通过各平台的外壳声明， 可安装到 DSH、Pi、Claude Code、Codex、Gemini、OpenCode 等主流 AI 编码代理。

来源声明：本仓库合并自两个 MIT 项目 —— addyosmani/agent-skills（作者 Addy Osmani，25 个技能，构成骨架） 与 mattpocock/skills（作者 Matt Pocock，19 个独有技能，补入锋利切口）。 归因见 NOTICE.md、LICENSE、LICENSE-mattpocock。

版本

0.1.1

技能构成

来源 数量 说明
addyosmani/agent-skills 25 生命周期骨架（定义/规划/构建/验证/评审/交付）
mattpocock/skills 19 独有能力（大规模规划、领域建模、分诊、复盘、教学等）
合计 44 全部遵循 Agent Skills 规范

多端安装

平台 外壳 安装方式
DSH（npm，推荐） dsh key + cordis.patch.yml dsh plugin --profile <profile> add mont-forge
DSH（市场） market/index.json 插件市场添加索引源，点击安装/卸载
DSH（GitHub 订阅） 根 skills/ Skills Manager「发现 → GitHub 仓库订阅」本仓库
Pi pi key + pi-package keyword pi install git:github.com/royrao2007/mont-forge
Claude Code .claude-plugin/plugin.json /plugin marketplace add royrao2007/mont-forge
Codex .codex-plugin/plugin.json Codex 插件市场添加本仓库
Gemini .gemini/commands/*.toml + commands/*.toml Gemini 订阅本仓库
OpenCode 根 skills/（Agent Skills 规范） 订阅本仓库，自动发现 skills/

所有平台都消费同一份 skills/<name>/SKILL.md（遵循 Agent Skills 规范）， 外壳只是各平台的"入口声明"，不复制技能内容。

网络受限环境建议用 npm 安装：走 registry（海外 registry.npmjs.org，国内 registry.npmmirror.com），不依赖 github.com 直连。

手动部署到 DSH 原生技能目录（无需网络）

# 把全部技能复制到 DSH 技能目录，热加载立即生效
Copy-Item .\skills\* "$env:DSH_HOME\skills\" -Recurse -Force

# 卸载（只删本仓库部署的技能）
.\scripts\uninstall-from-dsh.ps1

技能清单（44 个）

来自 addyosmani/agent-skills（25 个，生命周期骨架）

按软件开发生命周期阶段分组：

阶段 技能
定义 Define interview-me、idea-refine、spec-driven-development
规划 Plan planning-and-task-breakdown
构建 Build incremental-implementation、test-driven-development、source-driven-development、doubt-driven-development、context-engineering、constraint-driven-development、frontend-ui-engineering、api-and-interface-design
验证 Verify browser-testing-with-devtools、debugging-and-error-recovery
评审 Review code-review-and-quality、code-simplification、security-and-hardening、performance-optimization
交付 Ship git-workflow-and-versioning、ci-cd-and-automation、deprecation-and-migration、documentation-and-adrs、observability-and-instrumentation、shipping-and-launch
元技能 Meta using-agent-skills

来自 mattpocock/skills（19 个，独有能力）

类别 技能
规划与拆解 wayfinder（跨多个会话的大规模工作地图）、to-tickets（拆成带阻塞边的 tracer-bullet 票）、to-spec（对话转规格）
设计 codebase-design（深模块设计词汇）、domain-modeling（领域建模 / GLOSSARY）、improve-codebase-architecture（架构深化扫描）
执行 implement（按 spec/票执行）、prototype（一次性原型验证设计）
质量 triage（issue 分诊状态机）、retro（会话复盘）、pr（写 PR 描述）
协作 grilling（设计树式连环拷问）、grill-me（精确触发词别名，转发到 grilling）、to-questionnaire（把答不了的决策转成问卷）
知识 research（派后台 agent 查一手资料）、teach（教学）、writing-for-agents（给 agent 写文档）
配置 setup-matt-pocock-skills（初始化 issue tracker / 术语表布局；支持本地 markdown 模式）、wizard（生成交互式 bash 向导）

这 19 个技能保存在 overrides/skills/，不进入上游同步层，升级时不会被覆盖。 其中 implement 的两处交叉引用已适配为本包内的技能名 （tdd → test-driven-development，code-review → code-review-and-quality）。

安装到 DSH

在 DSH Skills Manager 的「发现 → GitHub 仓库订阅」中输入本仓库地址即可整仓 扫描并安装。技能目录遵循 skills/<kebab-case-name>/SKILL.md 规范，frontmatter 含合法的 ASCII name 与 description，可直接被 DSH 宿主加载调用。

目录结构（三层隔离）

mont-forge/
├── skills/          # 唯一内容真源（44 个 SKILL.md，所有平台共享）
├── references/      # 7 个共享清单（被部分技能以 ../../references/ 引用）
├── overrides/       # 你的优化层（同步脚本永不写入，物理隔离）
│   ├── skills/      # 19 个 mattpocock 合并技能（已并入 skills/，此处为来源层）
│   └── patches/     # 放 .patch 增量补丁
├── index.js + cordis.patch.yml + dsh key    # DSH 插件外壳
├── pi key + pi-package keyword              # Pi 插件外壳
├── market/index.json                        # DSH 市场索引（格式 1）
├── .claude-plugin/ + .claude/               # Claude Code 外壳
├── .codex-plugin/                           # Codex 外壳
├── .gemini/ + commands/                     # Gemini 外壳
├── scripts/
│   ├── sync-upstream.ps1   # 一条命令：拉上游 → 重放 skills/references
│   └── build-dist.ps1      # 合并 upstream + overrides → 根级 skills/
├── LICENSE          # 上游 MIT 原文（含 Addy Osmani 署名，合规保留）
├── NOTICE.md        # 来源声明
└── README.md

关键设计：upstream 不在仓库里占一个目录（避免 DSH 扫描到重复的 SKILL.md），而是作为 git remote（addyosmani/agent-skills）存在。 同步脚本 fetch 上游后，把 skills/ 与 references/ 检出到根目录。

同步与升级

# 拉取上游最新，重放到根级 skills/ + references/（只更新上游层，永不碰 overrides/）
.\scripts\sync-upstream.ps1

# 合并 upstream + overrides 生成最终 dist（初期 overrides 为空，等同纯镜像）
.\scripts\build-dist.ps1

合并优先级：overrides/ > patches/ > upstream。 当上游某技能更新、而你也在 overrides/ 有对应优化时，脚本会打印告警清单， 不静默覆盖，由你决定采纳上游新版、保留优化还是重新合并。

许可证

上游内容遵循两个 MIT License：

  • LICENSE — Copyright (c) 2025 Addy Osmani（addyosmani/agent-skills，25 个技能）
  • LICENSE-mattpocock — Copyright (c) 2026 Matt Pocock（mattpocock/skills，19 个技能）

本项目（打包、同步工具、多端外壳、市场索引）由 mont 维护。