mstack 是 Mola-maker 的个人 agent 工作流技能栈:把 superpowers、gstack、pstack、oh-my-claudecode(OMC)四套 skill 去重、合并、按个人使用习惯重写成 17 个互不重叠的 skill。同一份 skills/ 目录同时供 Claude Code(plugin)、DSH(~/.dsh/skills)和 Codex 使用。
(MP4 版 · 源码在 demo/,Remotion:cd demo && npm i && npm run render)
/go 修好 cmd-run 那个偶发失败的测试
/go 给 molamaker-site 加暗色模式,提PR
一句话进去,mstack 自己挑阶段(想 → 找现成代码 → 计划 → 实现 → 验证 → 审查 →(要求时)提 PR),按模型层给每个阶段配模型,写的人不审自己的代码。不用记 16 个 skill 的名字,它们变成了 /go 内部的阶段。
| 想要 | 用什么 |
|---|---|
| 在 Claude Code 里干活 | /go <一句话> |
| 终端里无人值守地跑 | mola go "<一句话>" [--auto],mola go status / approve / stop |
| 写之前先找能复用的代码 | mola scout "<需求>"(/go 自动做) |
| 看每个 agent 在干什么、花了多少 | 终端全屏 mola tui;状态栏 mola statusline install;手机 mola web --host <tailscale IP> |
| 完成或卡在审批时推到手机 | mola config set notify.ntfy https://ntfy.sh/<你的 topic> |
只有 push、PR、发布、删除、花钱、给别人发消息这类不可逆或对外的动作会停下来问你(可以在手机网页或 TUI 里批准);其余可逆的选择直接用默认值并说明。agent 只在 agent/<id> 分支上干活,进 main 只能走 mola land(要有异族模型的审查凭证)。
设计约束(详见 FRAMEWORK.md):短 prompt 也能接得上(m-start 总入口读 .mstack/ 状态续干)、每个 SKILL.md ≤150 行、长跑任务必须写 closeout、同一个错误连错 3 次就停。
| skill | 说明(来自 frontmatter) |
|---|---|
m-start |
总入口:读 .mstack/ 状态选 skill、恢复未完成的工作,"继续/开工"这类短 prompt 也能路由 |
m-think |
动手前想清楚:攻击前提、一次最多问 3 个带默认值的问题、产出设计稿 |
m-plan |
把设计拆成有序、可验证的步骤,每步写清验证方式,并由独立 critic 复核 |
m-goal |
长跑目标循环:goal 文件、检查点、停止条件,任何退出路径都强制写 closeout |
m-dispatch |
并行分派到 Claude subagent / DSH headless / Codex,各自隔离工作区,最后合并并独立验证 |
m-verify |
没有新鲜证据不说"完成":跑真测试、读真实输出、测行为不测实现 |
m-debug |
复现 → 竞争假设 → 找根因 → 回归测试;连错 3 次停下换思路 |
m-review |
多角度并行 review,写的人不审自己的代码;收到 review 意见先验证再改 |
m-ship |
同步上游 → 真测试 → 独立 review → 写 PR 文档 → 开 PR → 盯 CI 和评论 |
m-qa |
网页真机验收:起服务、Playwright 走真实流程、截图对比、性能与设计问题,带证据汇报 |
m-research |
多渠道调研:≥3 个独立渠道并行、去重交叉验证、每个关键论断标注来源 |
m-handoff |
存档 / 恢复上下文到 .mstack/handoff.md:compact 前、换模型前、会话结束时必写 |
m-learn |
复盘沉淀:post-mortem 进 lessons,可复用流程进候选 SKILL.md,事实进 memory |
m-deslop |
删 AI 味:多余代码、注释、抽象、废话,先保行为再做减法 |
m-guard |
安全护栏 + 插件冲突体检 + 死循环刹车 + Mola 的已知陷阱清单 |
m-team |
会进化的 agent team:开放式大预算任务交给按轮次重组的团队,supervisor 每轮诊断卡点、重设角色与知识流向 |
m-cua |
操作真实界面做 L3/L4 验收:桌面应用、Android 设备、浏览器;先探测驱动是否接通,留下可重放的脚本和回执 |
npm i -g @molamaker/mstack # Node ≥ 22
mola doctor # 查环境:node、magpie、agent、工具
mola skills install --claude # 或 --dsh / --codex:把包里的 17 个 skill 装到对应 agent
mola go "<一句话>" # 无人值守跑完整流程
mola web # 浏览器控制台(总控):http://127.0.0.1:7333
mola tui # 终端控制台,和网页读同一份状态@molamaker/dsh-mstack 把 17 个 skill 注册进 DSH;在 dsh-TUI 的底栏显示 mstack 状态(mstack ✗L1/L3 等你1 跑1:验收结论、等你批准的任务、在跑的任务,悬停看原因);在 DSH 网页端每个会话标题旁显示一行状态、多一个 mstack 标签页(嵌入 mola web)。
dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui # 终端界面(需要 dsh ≥ 0.2.2-rc.3)
dsh plugin --profile dsh-tui add @molamaker/dsh-mstack
dsh --profile dsh-tui方式一(GitHub marketplace):
claude plugin marketplace add Mola-maker/mstack
claude plugin install mstack@mstack方式二(本地 plugin marketplace):
claude plugin marketplace add /path/to/mstack
claude plugin install mstack@mstack方式三(直接软链 skills 到个人目录):
for d in /path/to/mstack/skills/*/; do
ln -s "$d" ~/.claude/skills/"$(basename "$d")"
done把每个 skill 软链进 ~/.dsh/skills:
for d in /path/to/mstack/skills/*/; do
ln -s "$d" ~/.dsh/skills/"$(basename "$d")"
doneCodex 需要实体文件,复制而不是软链:
mkdir -p ~/.codex/skills
cp -r /path/to/mstack/skills/* ~/.codex/skills/作者机器上的实际做法(2026-11-04,细节和理由见 docs/migration.md):
- superpowers:整体停用(
claude plugin disable superpowers@claude-plugins-official)。 - OMC:保留它的 agents、MCP 工具(state / notepad)和 hooks;关掉关键词触发和 persistent-mode(
settings.json的env.OMC_SKIP_HOOKS=keyword-detector,persistent-mode);全局 CLAUDE.md 写明工作流先走 mstack。 - 注意:用户级
settings.json的skillOverrides对插件 skill 不生效,没法单独隐藏 OMC 的某个 skill。
node scripts/check.mjs # FRAMEWORK.md §8 验收:17 个 skill、6 节结构、≤150 行、frontmatter 合法、无上游引用
claude plugin validate . # 插件清单
claude -p "列出所有以 mstack: 开头的 skill" # 真实加载:应列出 17 个CI(.github/workflows/check.yml)在每次 push 时跑前两类检查。有 .sources/(上游原文,不入库)时 check.mjs 还会检查 source-map 覆盖率和"连续 3 行雷同"。
主会话(Claude)写 FRAMEWORK.md 规格和每个 worker 的任务书(tasks/w*.md),用 tasks/dispatch.sh 把任务派给 DSH headless worker(WSL,mola-cli profile,magpie 路由 group/smart-split)并行写 skill,主会话再审查、修正、跑验收。改 skill 时照这个流程:改规格 → 派 worker 或直接改 → check.mjs → push → claude plugin marketplace update mstack && claude plugin update mstack@mstack。
插件根目录 agents/ 带 7 个子 agent(Claude Code 里用 subagent_type: "mstack:<name>" 调用):
m-explorer(haiku,只读):快速找文件、符号、调用关系,返回绝对路径 + 行号。m-implementer(sonnet):在指定 worktree 内做一个子任务的最小改动,并跑计划里的验证命令。m-debugger(sonnet):先复现、列竞争假设、在根因处修一次;3 个假设失败就停。m-verifier(sonnet,只读):自己跑真命令,返回 PASS / FAIL / INCOMPLETE 和证据表。m-reviewer(opus,只读):按严重度列 findings,末行给 APPROVE / REQUEST CHANGES。m-critic(opus,只读):先攻前提、预测风险,再给 APPROVE / REVISE / REJECT。m-researcher(sonnet):一个 agent 只走一个调研渠道,每条结论带来源,单源结论单列。
.claude-plugin/ plugin.json(插件清单)+ marketplace.json(本仓库即 marketplace)
agents/m-*.md 7 个子 agent
skills/<name>/SKILL.md 17 个 skill(≤150 行,细节放 references/)
FRAMEWORK.md 规格:画像 → 约束、来源映射、格式、共享约定、验收标准、§9 m-team
docs/source-map.md 每个来源文件 → 归入哪个 m-skill
docs/migration.md 与 superpowers / OMC 共存的做法
scripts/check.mjs 验收脚本
tasks/ 构建记录:DSH worker 任务书与分派脚本
reviews/ 独立验收记录(DSH reviewer 的 findings 与修复)
demo/ · assets/ Remotion 演示动画源码与渲染产物
CHANGELOG.md · NOTICE.md · LICENSE