catalog/repos/aitcmb--mbank.md

结构化项目开发技能

AI编程助手 项目管理 工作流 Claude Code 文档驱动

mbank

适用于 Claude Code、Codex 和 Cursor 的结构化项目开发技能。

mbank 帮助 AI 智能体从模糊的产品想法出发，通过分层项目文档（而非即兴聊天记忆）进入有纪律的实现工作流。

为什么用 mbank

大多数智能体工作流擅长写代码，但在以下方面较弱：

• 将模糊想法转化为可用的设计简报
• 在长对话中保持项目上下文
• 同步维护架构、进度和实现文档

mbank 通过文档优先的工作流解决这些问题：

/discover -> /mbank -> /scaffold -> build -> /check -> /archive

功能说明

• /discover 将模糊想法扩展并细化，生成 mbank/discovery.md 和 mbank/design.md
• /mbank 将 mbank/design.md 转化为清晰计划，并生成 mbank/tech-stack.md
• /scaffold 生成项目运作文档，包括 AGENTS.md、implementation-plan.md、progress.md、architecture.md 和 quickref.md
• /check 执行显式验证和文档一致性检查
• /archive 快照一个里程碑，并重置当前进度追踪

安装

# Claude Code
git clone https://github.com/Aitcmb/mbank.git ~/.claude/skills/mbank

# Codex / OpenAI Agents
git clone https://github.com/Aitcmb/mbank.git ~/.codex/skills/mbank

# Cursor
git clone https://github.com/Aitcmb/mbank.git ~/.cursor/skills/mbank

快速开始

1. 创建项目文件夹

mkdir mbank

2. 从探索阶段开始

如果项目想法仍然模糊：

/discover

此阶段生成：

• mbank/discovery.md
• mbank/design.md

3. 确认技术方向

/mbank

此阶段将：

• 读取 mbank/design.md
• 补全缺失的约束条件
• 评估复杂度
• 生成 mbank/tech-stack.md

4. 生成工作脚手架

/scaffold

此阶段生成：

• AGENTS.md
• CLAUDE.md（可选兼容文件）
• mbank/implementation-plan.md
• mbank/progress.md
• mbank/architecture.md
• mbank/quickref.md
• mbank/context/

5. 开发、验证、归档

/check
/archive

核心文件

your-project/
├── AGENTS.md
├── CLAUDE.md
├── .claude/
│   └── rules/
└── mbank/
    ├── discovery.md
    ├── design.md
    ├── tech-stack.md
    ├── quickref.md
    ├── architecture.md
    ├── implementation-plan.md
    ├── progress.md
    ├── context/
    └── archive/

上下文模型

mbank 使用分层上下文，而非一次性加载所有内容：

• AGENTS.md 项目主规则文件
• .claude/rules/ 全局硬性约束
• mbank/quickref.md 始终读取的快速参考
• mbank/architecture.md 架构与职责说明
• mbank/design.md 正式产品/设计定义
• mbank/discovery.md 早期阶段推理与范围权衡
• mbank/progress.md 当前进度与活跃状态
• mbank/context/ 仅在需要时加载的模块级深度上下文

仓库结构

• SKILL.md 主技能说明文件
• defaults.md 示例偏好配置文件
• references/ 仅按需加载的模板文件
• CHANGELOG.md 版本历史记录

模板

仓库在 references/ 目录中包含可复用模板：

• discovery-template.md
• design-template.md
• scaffold-templates.md

许可证

MIT