mancode
EN开始使用 ↘

AI 编码 Agent 工作流调度工具

交付干净代码，避免AI 屎山。

为每个任务选择恰当的工程纪律。优先复用已有代码，匹配项目风格；只有当风险值得时，才进入季后赛级别的流程。

> npm install -g mancode
模式 / 03运行中
/man季后赛
纪律
01球探
02执行
03风险审查
01 / 问题所在保留速度，丢掉膨胀。

AI 写得很快。

它也该知道
何时停下。

没有战术板+ 12 个文件

+ 新组件与新样式文件

+ 新主题 token

+ 新控制器与新 hook

+ 新抽象层

新增抽象5
使用 mancode / solo+ 3 行
<Button variant="default"
  onClick={handleLogout}>
  退出登录
</Button>
复用现有模式100%
复用优先阶梯
  1. 01已有代码
  2. 02标准库
  3. 03原生能力
  4. 04已安装依赖
  5. 05最小新实现
02 / 五档强度按风险匹配流程。

不是每个任务
都是抢七。

同一个编码 Agent，日常任务轻装上阵；需要正式方案时先用 /man 对齐需求和计划，再选择 solo 轻量开发或完整治理。针对最新模型自带审查的特点，mancode 会限制 review 轮次，同时给不主动审查的模型保留质量门槛。

日常训练

solo

一次受限 diff 自检、最窄验证，不调用额外 reviewer。

真实诊断

/manba

复现、定位根因、驱动真实路径并回归验证。

先计划再选择

/man

引导需求对齐、方案推荐和持久计划；确认后选择 solo 或完整九步治理。

团队协作

/manteam

共享项目记忆、决策记录与协作约定。

季前赛

/manps

检测陈旧 TODO、依赖风险和硬编码设计值。

03 / 先计划再选择solo 交付或完整治理。

/man 工作流

从需求对齐
到确认计划。

每次规划都会在 .mancode/<namespace>/workflows/<ULID>/ 产生可读记录。计划确认后，可交给 solo 轻量开发，也可继续完整九步治理。

  1. 01球探报告梳理代码、风险与未知项
  2. 02需求澄清确认真正要解决的问题
  3. 03计划输出可验证步骤
  4. 04计划关卡solo、完整治理、仅计划或修改
  5. 05实施完整 /man 才进入
  6. 06验证与范围验证后选择审查深度
  7. 07定向审查有证据的质量 finding
  8. 08风险防守高风险时审查安全边界
  9. 09收尾一轮修复、复验、停止
04 / 项目感知你的代码库本来就有自己的战术。

先读懂现场，
再开始写。

mancode 会识别项目形态、可用验证命令、现有组件、CSS 变量和设计信号。只有项目确实存在 UI 时，才会启用 UI 指导。

运行时源码布局验证命令现有组件CSS 变量团队状态
project / local
your-project/
├── .mancode/
│   ├── shared/context/project.json
│   ├── local/cache/style-tokens.json
│   ├── local/workflows/<ULID>/
│   └── shared/team/
├── .claude/
├── .cursor/rules/
├── .agents/skills/
└── AGENTS.md

✓ 上下文跟随代码留在本地
✓ 不发送遥测
05 / 设计策略先选方向，再谈装饰。

0.5.0 新能力

方向你来选。
效果交给它。

新建 UI 或视觉重做，不再由 Agent 默默套用唯一默认风格。方向尚未确定时，mancode 会先给出 2–3 个符合产品语境的方案、简明取舍和一个推荐；你选定后，它再把一个视觉系统做完整。用户内容可以包含表情，但界面图标绝不能用表情代替。

配置设计策略
UI 需求 / 尚未选定等待决策
开始实现之前先给出
2–3 个方向。

视觉逻辑要有差异，取舍要说清楚，并给出一个推荐。在方向属于你之前，不急着写代码。

  1. 01编辑式精度克制 / 排版驱动
  2. 02技术剧场强烈 / 动态叙事
  3. 03产品清晰度紧凑 / 功能优先
策略 / 01最稳妥

preserve

保留现有层级、组件、布局和交互模式，只完成任务真正要求的 UI 改动。

策略 / 02推荐

refine

改善排版、间距、层级、状态和响应式行为，但不改变产品结构。

策略 / 03显式开启

experimental

确认后允许更强的构图与有目的的动效，仍然不能突破既有产品范围。

01 现有设计系统优先02 不扩大产品范围03 不偷加依赖04 条件允许时浏览器验证
06 / 适配器保留你的 Agent，加入纪律。

一套战术。
你的工具。

mancode 是工作流层，不是新的编码 Agent。Claude Code 获得最完整的原生集成；其他工具获得持久 rules、skills 或 instruction 文件。

平台适配方式级别
Claude CodeHooks · skills · subagents完整集成
Cursor项目 rules · commands适配器
CodexAGENTS.md · 项目 skills适配器
GitHub Copilot仓库 instructions · prompts适配器
ZCodeAGENTS.md · 项目 skills预览适配器
Kimi CodeAGENTS.md · 项目 skills预览适配器
QoderAGENTS.md · 项目 commands预览适配器
DeepSeek HarnessAGENTS.md · 隔离项目 skills预览适配器
07 / 跨会话续接换窗口，不丢任务脉络。

一项任务。
下个会话继续。

mancode 把目标、需求、计划、检查结果和交接信息保存在稳定 TaskRef 下。新聊天窗口或 CLI session 可以恢复这项任务，只加载当前目的需要的 Context Pack，不依赖旧窗口一直打开。

步骤mancode 保留什么边界
保存稳定 TaskRef 关联需求、计划、结果和交接信息。持久上下文
恢复mancode context resume <TaskRef> --session <id> --client <client>显式身份
读取按目的生成 Context Pack，恢复真正有用的任务状态。减少噪声
隔离不复制原始聊天记录，不同客户端 session 仍然隔离。边界清晰
08 / 快速开始安装一次，初始化一次，继续编码。

准备上场

把 mancode
放进轮换。

不需要账户、Dashboard、API Key 或新编辑器。原生支持 Windows CMD、PowerShell、Git Bash、macOS 与 Linux。

阅读完整文档 ↗
01 / 安装npm install -g mancode
02 / 进入项目cd your-project
03 / 初始化mancode init
solo 模式已就绪00:03

简单任务少一点仪式。
关键任务多一点纪律。

别再替 AI
收拾臃肿。

> npm install -g mancode
GitHub 上查看 ↗