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 接手或继续 Man。两条实施路径都保留原任务门禁，按风险和新证据安排审查。

日常训练

solo

检查实际 diff、执行相关验证，必要时增加独立审查。

真实诊断

/manba

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

先计划再选择

/man

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

团队协作

/manteam

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

季前赛

/manps

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

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

/man 工作流

从需求对齐
到确认计划。

每次规划都会在 .mancode/<namespace>/workflows/<ULID>/ 产生可读记录。计划确认后，可交给 solo 接手，也可继续 Man；两者都保留原计划、范围、审查与验收门禁。

  1. 01球探报告梳理代码、风险与未知项
  2. 02需求澄清确认真正要解决的问题
  3. 03计划输出可验证步骤
  4. 04计划关卡solo、完整治理、仅计划或修改
  5. 05实施按获准计划实施
  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 可以恢复这项任务，先加载当前目的需要的索引，再按版本补读正文，不依赖旧窗口一直打开。

步骤mancode 保留什么边界
保存稳定 TaskRef 关联需求、计划、结果和交接信息。持久上下文
恢复mancode context resume <TaskRef> --session <id> --client <client>显式身份
读取按目的查询有界索引，再读取所需正文与当前任务状态。减少噪声
隔离不复制原始聊天记录，不同客户端 session 仍然隔离。边界清晰
项目进度 / v0.6.10从任务状态，看到决策来由。

每个项目。
一页看清。

任务看板、项目全貌、决策清单、演进时间线和避坑记录，来自同一份已登记项目事实。任务完成、阻塞或验收变化时更新页面；渲染与空闲刷新不调用模型。

上下文

先索引，再补读

默认提供有界引用，执行前按版本读取必要正文。项目增长不等于整套文档进入每轮会话。

决策

保留原因与有效范围

当前有效、部分有效和历史记录分开呈现，沿来源查看替代与撤销依据。

看板

任务按状态推进

未开始、进行中、待审核与阻塞分栏。仅规划保留阶段标记，已完成默认折叠。

使用

本地打开，按需预览

新项目初始化生成 HTML；已有项目运行 mancode progress init。离线文件无需服务，预览随开随停。

虚构客户协作项目的任务看板，包含未开始、进行中、待审核和阻塞四栏
真实模板 · 虚构演示数据 · 页面不把任务完成推断为已发布。

打开五个视图的交互演示 ↗ 查看使用文档 ↗

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 上查看 ↗