玛德
克劳德代码和代码插件的个人市场. 今天有两个插件, 加一个 maude 用于脚手架和运行捆绑的dev工具的CLI.
完整文档 : https://maude.sh (英语) (或浏览来源于
site/content/docs/直到公共URL登陆). 贡献? 见 捐款额安全吗? 见 警卫。 。 。 .
| 插件 | 它会做什么 |
|---|---|
design | TSX/JSX上的 Canvas- first 迭代在下方 .design/ ——元素选择通过 Cmd+Click,自动管理的dev服务器,链式UX/DS批判. 帆布也可以成为 视频码 (Remotion 组成预览了 in-app,通过Maude自己的抓取引擎导出为MP4/GIF——没有额外安装). |
flow | 通用代理工作流程循环,带有二脑 .ai/ 工作空间. /flow:plan, (中文(简体) ), /flow:execute, (中文(简体) ), /flow:validate, (中文(简体) ), /flow:done, (中文(简体) ), /flow:bug-rca, (中文(简体) ), /flow:bug-fix, (中文(简体) ), /flow:release, (中文(简体) ), /flow:record-ddr, (中文(简体) ), /flow:init, (中文(简体) ), /flow:run (10个命令;变体为旗帜-参见: 流动移徙) (中文(简体) ). 通过项目不可知 <project> 占位符 + 每重置 .ai/workflows.config.json。 。 。 . |
再加上 maude CLI - 翻译: maude init 脚手架很新鲜 .ai/ 流插件骨架的工作空间; maude design serve 启动设计 Dev 服务器 。 遗产 mdcc 别名仍然有效(打印出去色警告),将在v0.17.x被删除.
快开始
代码 CLI : 使用该 本地插件安装指南它使用相同的工作流程; Studio ACP支持是单独的后续行动.
使用Maude桌面吗? 仅限 已安装 Claude 代码,桌面应用程序的内置聊天面板自动加载
design+ 键flow其会话插件 -/design:*财务报告和审定财务报表/flow:*只是工作,没有设备可以安装(已经安装了插件的电源用户看到一个没有操作,没有双载荷). 以下步骤如下: 手动/ 动力用户路径 为:maudeCLI,网络maude design serve流动或驱动/design:*从你自己的终端Claude代码。 全部细节 : maude.sh/台式电脑。 。 。 .
1. 在克洛德法典内增加市场
/plugin marketplace add 1aGh/maude
2. 安装您想要的插件
/plugin install design@maude
/plugin install flow@maude
礛 /reload-plugins 你应该看看 /design:edit, (中文(简体) ), /design:*, (中文(简体) ), /flow:plan, (中文(简体) ), /flow:execute等 (中文(简体) ).
3. 安装国家领导才能
# From npm:
npm i -g @1agh/maude
# Or directly from GitHub:
npm i -g github:1aGh/maude
安装后, 这些垃圾箱会打开 $PATH数字 :
maude· 主要的CLI(init, (中文(简体) ),config, (中文(简体) ),design serve) (中文(简体) ).mdcc- 遗产别名maude。打印折旧警告;将在v0.17.x中删除.
4. 诱饵
在任何工程根中 :
maude init # scaffold .ai/ second-brain workspace
然后在克洛德代码内(与 flow@maude 已安装 :
/init # Anthropic's built-in — generates CLAUDE.md tailored to your codebase
/flow:init # populates .ai/workflows.config.json with detected stack
/flow:run --status # confirm everything wired up
/init 写入 CLAUDE.md Claude 自动装入每个会话(公约,构建命令,获取). /flow:init 处理结构化的工作空间配置——它们是互补的,而不是重复的.
健康检查 - maude doctor
maude doctor 报告缺少依赖性、配置方案出错、堆栈漂移和缺少质量门声明. --fix 应用安全的自定义(每个依赖安装的瞬间;从不覆盖已有的用户配置值). --json 方案消费者。 在堆栈更改后或在打开 PR 之前运行 .
maude doctor # full health check (deps + config + quality)
maude doctor --fix # install missing deps (per-item prompt) + apply safe config fixes
maude doctor --json # machine-readable envelope
质量门 已声明为 .ai/workflows.config.json 在顶层 quality 地图——平面 gate → shell command 测绘(如:. { "lint": "pnpm lint", "tests": "pnpm test" }) (中文(简体) ). 流程命令( E)/flow:validate, (中文(简体) ), /flow:validate --fast, (中文(简体) ), /flow:execute --quick直接读取,然后通过 eval。这里有 没有 maude quality run 包装 —— 说 pnpm <script> 已经是跑者了。 用单行道插入你自己的预承诺工具: eval $(jq -r '.quality.lint' .ai/workflows.config.json)。通过运行填充块 maude doctor --fix 曾经你 package.json 脚本存在( 添加- 它永远不会覆盖您调制的命令) .
侧车缓存 - maude cache
Flow + 设计命令通过小型侧车缓存重复使用昂贵的相会工作 .ai/cache/ (单位:千美元)DDR-061 复员方案:域研究(同域简报上的Sskips 30-90 s的WebSearch),密码库-情报扫描(树没有变化时Skips重新扫描),解析设计-系统词汇,以及安全审查再利用(一个共享的1小时窗口横跨) /flow:validate, (中文(简体) ), /flow:done, (中文(简体) ), /flow:validate --security) (中文(简体) ). 正确性第一——大多数层都是内容处理的(一个已更改的输入更改了密钥)——保证误差),而一个过时的条目从不投机地服务.
maude cache list # layers, entry counts, sizes, last-write time
maude cache stats # hit/miss counters + hit-rate per layer
maude cache inspect <layer> # list a layer's entries; add a <key> to print one
maude cache clear [layer] # wipe one layer (or everything)
这个 research/domain 财务报告和审定财务报表 codebase-intelligence 层为 承诺 (在给定的树上下定决心,所以合作者分享命中); 平分,设计-背景,安全,和情景层被分出. maude init 丢入 a .ai/.gitignore 用来编码拆分.
插件调用 maude 可执行逻辑
插件斜线命令通过 on-PATH 达到所有可执行逻辑 maude 二进制 — 绝不是亲戚 cli/lib/*.mjs 路径或原始 $CLAUDE_PLUGIN_ROOT/dev-server/bin/*.sh 援引复员方案-062) (中文(简体) ). 市场只复制每个插件( 无兄弟姐妹) cli/,没有 dev-server/),和流指令的 $CLAUDE_PLUGIN_ROOT 在流插件(该插件完全没有dev-server)的分数——所以每个安装形状中唯一持有的合同是 maude,它从自己的软件包根解决捆绑的帮助者。 缓存/飞行前通过 maude cache … 编号 : maude preflight …; 设计 dev-server 的击打助手通过 maude design <verb> (单位:千美元)screenshot, (中文(简体) ), server-up, (中文(简体) ), prep, (中文(简体) ), slug, (中文(简体) ), smoke, (中文(简体) ), runtime-health)——见 maude design help保持全球 maude 当前; stale 二进制表示 stale 帮助.
运行时间要求
- 节点 20 ——用于dev服务器和CLI. 0 npm 运行时间分解.
- 克劳德代码 ——桌面应用,CLI,或IDE扩展.
- 可选 :
agent-browser设计截图证据.
协作模式
两条干净的道路,没有中间地带(复员方案047:
- v1.0 — git shitchoff OR回路多塔布. Push / pull是跨机的故事. 在一款单机上,两个浏览器标签(或两个克洛德码例编辑同一回波)同步光标,评论,和注释在回回WebSocket上直播. dev 服务器拒绝任何非浏览
host合作 WS 端点上的标题 . - v1.1——部署一个枢纽 (第9阶段,飞行)。 跨机现场合作需要你部署的中枢二进制 无隧道模式;无共享云. 靴子订单不能吃你的工作 (单位:千美元)复员方案102):每台机器的日记除了真实的相差之外,还讲述干净的赶超;相差的画布快照 两者 版本改为
_history/在新人获胜之前,失败者就是/design:rollback远离——和maude design status每张扫描报告同步状态诚实(synced / 待定 / auth- 拒绝) .
警卫
独奏模式(默认)是完全局部的——没有帐号,没有遥测,没有网络信任表面,帆布沙盒默认上线. 链接(hub)模式是选入的并带有有文件证明的信任模式,包含被披露的,有界限的残基(hub-pushed内容作为不可信输入处理). 完整的账户——什么运行在哪里, 帆布沙盒做什么和不关闭, .tsx 同步的双选入, 不信任的文本处理 /docs/security (来源: site/content/docs/security.mdx) (中文(简体) ). 改为: 报告 一种脆弱性,见 警卫。 。 。 .
何等为相
面向用户的Docs生活在两个地方 — README将您指向正确的方式:
- 参考文献 (每个命令,每个配置密钥, Next.js / Expo / monorepo 的配方)
site/content/docs/(截至2001年12月31日) https://maude.sh (英语) 看到了吗 复员方案-005) (中文(简体) ). - kayai 知识图后端 (可选择的共享决策内存,横跨repos)
docs/kgai-onboarding.md(每个用户)+docs/kgai-company-setup.md(一任管理员. 默认关闭——缺席kg,每个命令运行它的经典.ai/路径. - 快速启动 + 键 贡献信息 这个读取.
文件站点自动生成每个命令页 plugins/{flow,design}/commands/*.md 前题和从 plugins/flow/.claude-plugin/config.schema.json。添加一个新的命令 ~ Docs 在下一个构建上更新.
工作空间
重罚是 pnpm 工作空间单列波 带有一个已公布 npm 软件包(@1agh/maude) (中文(简体) ). 内部工作空间是 "private": true 绝不出版:
| 工作空间 | 目的 |
|---|---|
. (基层) | 单 npm 发布器——CLI,dev-server 条目,插件模板,将发往 npm. |
site/ | Docs site — Fumadocs + Next.js, 由 Cloudflare 工人服务(复员方案-005) (中文(简体) ). |
apps/studio/ | 零点 节点dev服务器+浏览器客户端. 捆绑输出( O)dist/)是npm焦油丸中唯一一种. |
apps/hub/ | 为v1.1联合枢纽(第9阶段)预留. |
根部常见脚本 :
pnpm install # bootstrap everything
pnpm dev # boot the design dev server
pnpm dev:site # docs site dev server
pnpm build # build every workspace that defines `build`
pnpm lint # biome over the whole repo
pnpm test # node --test over cli/**/*.test.mjs
pnpm changeset # add a changeset for the next release
网站工作空间的 Next.js 依赖性很重 — 贡献者固定插件代码可以继续工作 pnpm install --filter '!@maude/site' 跳过它们.
更新
在Claude Code中,在新版本上市后:
/plugin marketplace update maude
/plugin install design@maude
/plugin install flow@maude
释放
Npm 软件包 (@1agh/maude)和克洛德代码插件(design@maude, (中文(简体) ), flow@maude)共享一个版本. 标准发布路径是 更改数字 :
# 1. Each PR with shipped behavior includes a changeset
pnpm changeset
# 2. When ready to release, the maintainer runs:
pnpm version # = bash scripts/changesets-version.sh
# → consumes .changeset/*.md
# → bumps package.json + CHANGELOG
# → propagates version to plugin manifests
# → re-runs scripts/check-version-parity.sh
git commit -am "chore: release v$(node -p "require('./package.json').version")"
# ANNOTATED (-a -m) is required — `git push --follow-tags` only pushes annotated
# tags. A lightweight `git tag vX.Y.Z` will silently stay local and no release
# workflow ever fires.
VER="v$(node -p "require('./package.json').version")"
git tag -a "$VER" -m "$VER"
git push --follow-tags
这个 v* 标签触发器 .github/workflows/publish.yml,重新运行对等检查,验证标记匹配 package.json,建立工作空间,出版 --access public --provenance,并使用 ChangeGELOG 条目创建该版本的 GitHub 发布.
scripts/bump-version.sh patch|minor|major|X.Y.Z 继续作为变换器流外紧急热补补的手动倒置.
一次性设置(项目所有人)
- 创建一个 自动化 符号 https://www.npmjs.com/ settings/~/tokens (英语)。 。 。 .
- GitHub repo – (英语) 设置 / 秘密 / 动作 →
NPM_TOKEN。 。 。 . id-token: write已启用publish.yml为npm出处.
地方发展(插文作者)
/plugin marketplace add /absolute/path/to/maude
/plugin install design@maude
/plugin install flow@maude
在插件内部工作 :
- 编辑就位 - 本地市场点到你的工作树.
- 编辑后重新装入 :
- 指挥/代理/技能 +
/plugin marketplace update maude接下来/reload-plugins。 。 。 . - Dev 服务器代码 ~ 杀死运行的过程(
lsof -i :<port>→kill让下一个/design:edit启动自动启动.
- 指挥/代理/技能 +
- 隔离试验 ——从零开始开放克洛德代码项目(
cd /tmp && claude)所以插件与这repo自己的不相缠.ai/。 。 。 . - 狗粮 ——毛德本身使用
flow计划/执行/执行。 一次flow您可以使用此市场来驱动自己的开发/flow:plan, (中文(简体) ),/flow:execute等 (中文(简体) ).
许可证
麻省理工学院——见 自由主义。 。 。 .