mancode 0.3.5 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +20 -19
  2. package/README.zh-CN.md +19 -18
  3. package/dist/cli.js +852 -761
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -17,7 +17,7 @@
17
17
  <p align="center">
18
18
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
19
19
  <a href="https://www.npmjs.com/package/mancode"><img src="https://img.shields.io/npm/v/mancode?style=flat-square" alt="npm version" /></a>
20
- <img src="https://img.shields.io/badge/status-stable%20v0.3.5-green?style=flat-square" alt="Status: stable v0.3.5" />
20
+ <img src="https://img.shields.io/badge/status-stable%20v0.3.7-green?style=flat-square" alt="Status: stable v0.3.7" />
21
21
  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="Platforms: Claude Code, Cursor, Codex in ChatGPT desktop and CLI, GitHub Copilot, ZCode" />
22
22
  <img src="https://img.shields.io/badge/tests-381%20passed-brightgreen?style=flat-square" alt="Tests: 381 passed" />
23
23
  </p>
@@ -46,7 +46,7 @@ mancode installs three things:
46
46
 
47
47
  1. **Hooks** that inject project context, design tokens, and YAGNI checks into
48
48
  agent prompts.
49
- 2. **Skills / modes** for `solo`, `/mamba`, `/man`, `/manteam`, `/manps`, and
49
+ 2. **Skills / modes** for `solo`, `/manba`, `/man`, `/manteam`, `/manps`, and
50
50
  `/mansolo`.
51
51
  3. **Coaching-staff subagents**: Scout, Plan Coach, Head Coach, Film Analyst
52
52
  (Offense), and Film Analyst (Defense).
@@ -80,15 +80,16 @@ After initialization, keep using your coding agent normally. `solo` mode runs by
80
80
  default: practice day, no ceremony. Use `/man` when a task needs planning,
81
81
  testing, and multi-agent review: playoffs, every possession counts.
82
82
 
83
- Invocation is surface-specific. Claude Code and Cursor use `/man`, `/mamba`,
83
+ Invocation is surface-specific. Claude Code and Cursor use `/man`, `/manba`,
84
84
  and the other slash-style mode names. Codex in the ChatGPT desktop app, CLI, or
85
- IDE extension loads repo skills from `.agents/skills/`; `$man`, `$mamba`, and
85
+ IDE extension loads repo skills from `.agents/skills/`; `$man`, `$manba`, and
86
86
  the other `$` mentions are the portable explicit syntax. In the ChatGPT desktop
87
87
  app, enabled skills also appear in the slash-command list, so a discovered
88
88
  `man` skill can be selected there as `/man`. In CLI/IDE, use `$man` or `/skills`.
89
89
  These are agent skills, not deprecated custom prompts. See the official
90
90
  [skills](https://learn.chatgpt.com/docs/build-skills) and
91
91
  [slash-command](https://learn.chatgpt.com/docs/reference/slash-commands) docs.
92
+ Existing workflow metadata remains compatible and does not need migration.
92
93
 
93
94
  ## What Gets Installed
94
95
 
@@ -201,7 +202,7 @@ slash commands in your AI coding agent's conversation:
201
202
  | Mode | Best For | What It Does |
202
203
  |---|---|---|
203
204
  | `solo` | Daily coding · practice day | Lightweight hooks, style awareness, YAGNI checks, and one bounded diff self-check |
204
- | `/mamba` | Diagnosis and real validation · Mamba mentality | Reproduces defects, finds root causes, drives real user flows, and runs regression checks |
205
+ | `/manba` | Diagnosis and real validation · Mamba mentality | Reproduces defects, finds root causes, drives real user flows, and runs regression checks |
205
206
  | `/man` | Production or high-risk changes · playoffs | Full 9-step workflow with targeted or full risk-based review |
206
207
  | `/manteam` | Team projects · five on the floor, one mind | Shared memory, decisions, coordination, and Conventional Commits |
207
208
  | `/manps` | Cleanup and maintenance · preseason | Project health scan with Markdown and JSON reports |
@@ -292,7 +293,7 @@ it should behave, and why previous decisions were made.
292
293
 
293
294
  ## Installation
294
295
 
295
- **Status**: stable v0.3.5. Claude Code, Cursor, Codex in the ChatGPT desktop app
296
+ **Status**: stable v0.3.7. Claude Code, Cursor, Codex in the ChatGPT desktop app
296
297
  and CLI, and GitHub Copilot are supported. ZCode adapter support is included,
297
298
  with project skill discovery kept behind a verification gate before release.
298
299
 
@@ -342,14 +343,14 @@ mancode install --minimal # Install only solo-mode essentials
342
343
 
343
344
  ```bash
344
345
  # Claude Code / Cursor
345
- /mamba # Diagnose bugs and validate real user flows
346
+ /manba # Diagnose bugs and validate real user flows
346
347
  /man # Full 9-step workflow with bounded risk-based review
347
348
  /manps # Project health check
348
349
  /manteam # Team mode and shared memory
349
350
  /mansolo # Return to solo mode
350
351
 
351
352
  # Codex in ChatGPT desktop / CLI / IDE
352
- $mamba
353
+ $manba
353
354
  $man
354
355
  $manps
355
356
  $manteam
@@ -364,7 +365,7 @@ mancode status
364
365
  mancode status --json
365
366
  mancode install <claude-code|cursor|codex|copilot|zcode>
366
367
  mancode list-platforms
367
- mancode workflow create <man|mamba|manteam> "<task>" [--parent-task <taskId>]
368
+ mancode workflow create <man|manba|manteam> "<task>" [--parent-task <taskId>]
368
369
  mancode workflow update <taskId> [--step N] [--status in_progress|planned|completed|blocked|abandoned] [--blocking-reason "<reason>"] [--outcome fixed|verified|no_repro|manual_test_required] [--plan-version N] [--skipped a,b]
369
370
  mancode workflow review <taskId> init --review-depth <targeted|full> [--review-domain <quality|security>]
370
371
  mancode workflow review <taskId> complete --review-domain <quality|security> --report <path> [--blockers Q1,Q2]
@@ -385,7 +386,7 @@ mancode version
385
386
  Example output for a UI project (not a default stack):
386
387
 
387
388
  ```text
388
- mancode v0.3.5
389
+ mancode v0.3.7
389
390
 
390
391
  Project: my-app (React + TypeScript + Tailwind)
391
392
  Mode: solo (default)
@@ -447,8 +448,8 @@ mancode status --json
447
448
 
448
449
  ### `mancode workflow`
449
450
 
450
- Creates and manages validated workflow metadata used by `/mamba`, `/man`, and
451
- `/manteam`. A linked `/mamba` child can only be created while its parent is
451
+ Creates and manages validated workflow metadata used by `/manba`, `/man`, and
452
+ `/manteam`. A linked `/manba` child can only be created while its parent is
452
453
  active at Step 6. Governed review state records required domains, blocker IDs,
453
454
  and the single remediation round.
454
455
 
@@ -458,8 +459,8 @@ mancode workflow update <taskId> --step 4 --plan-version 2
458
459
  mancode workflow review <taskId> init --review-depth full
459
460
  mancode workflow review <taskId> complete --review-domain quality --report film-report-1.md --blockers Q1
460
461
  mancode workflow review <taskId> remediate --resolved Q1
461
- mancode workflow create mamba "verify auth regression" --parent-task <taskId>
462
- mancode workflow update <mambaTaskId> --status completed --outcome verified
462
+ mancode workflow create manba "verify auth regression" --parent-task <taskId>
463
+ mancode workflow update <manbaTaskId> --status completed --outcome verified
463
464
  mancode workflow show <taskId> --json
464
465
  mancode workflow clean --older-than 30d --dry-run
465
466
  ```
@@ -514,7 +515,7 @@ mancode/
514
515
  │
515
516
  ├── Skills
516
517
  │ ├── solo/SKILL.md
517
- │ ├── mamba/SKILL.md
518
+ │ ├── manba/SKILL.md
518
519
  │ ├── man/SKILL.md
519
520
  │ ├── manteam/SKILL.md
520
521
  │ ├── manps/SKILL.md
@@ -546,7 +547,7 @@ mancode/
546
547
  | Phase | Focus |
547
548
  |---|---|
548
549
  | MVP-1 | solo mode, aesthetics, and Claude Code hooks |
549
- | MVP-2 | `/mamba`, `/man`, `/manteam`, `/manps`, and coaching-staff subagents |
550
+ | MVP-2 | `/manba`, `/man`, `/manteam`, `/manps`, and coaching-staff subagents |
550
551
  | MVP-3 | Cursor, Codex (ChatGPT desktop/CLI), and GitHub Copilot adapters |
551
552
  | Public Release | stable npm release, marketplace distribution, docs, and demos |
552
553
 
@@ -581,7 +582,7 @@ markers is preserved.
581
582
 
582
583
  ### ZCode skills not appearing
583
584
 
584
- Ensure `.agents/skills/mamba/SKILL.md` through `.agents/skills/mansolo/SKILL.md`
585
+ Ensure `.agents/skills/manba/SKILL.md` through `.agents/skills/mansolo/SKILL.md`
585
586
  exist, then restart or refresh ZCode. ZCode slash commands are not generated
586
587
  yet because the workspace command file path still needs explicit verification.
587
588
 
@@ -589,8 +590,8 @@ yet because the workspace command file path still needs explicit verification.
589
590
 
590
591
  Ensure the `.cursor/rules/mancode-*.mdc` files exist. Rules with
591
592
  `alwaysApply: true` (context, practice, solo) load on every conversation.
592
- Mode-specific rules (mamba, man, manteam, manps) trigger based on the
593
- description field — invoke them by asking for `/mamba` or similar.
593
+ Mode-specific rules (manba, man, manteam, manps) trigger based on the
594
+ description field — invoke them by asking for `/manba` or similar.
594
595
 
595
596
  ### How to do a clean reinstall
596
597
 
package/README.zh-CN.md CHANGED
@@ -17,7 +17,7 @@
17
17
  <p align="center">
18
18
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="许可证：AGPL-3.0" /></a>
19
19
  <a href="https://www.npmjs.com/package/mancode"><img src="https://img.shields.io/npm/v/mancode?style=flat-square" alt="npm 版本" /></a>
20
- <img src="https://img.shields.io/badge/status-stable%20v0.3.5-green?style=flat-square" alt="状态：稳定版 v0.3.5" />
20
+ <img src="https://img.shields.io/badge/status-stable%20v0.3.7-green?style=flat-square" alt="状态：稳定版 v0.3.7" />
21
21
  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="平台：Claude Code、Cursor、ChatGPT 桌面端 Codex、Codex CLI、GitHub Copilot、ZCode" />
22
22
  <img src="https://img.shields.io/badge/tests-381%20passed-brightgreen?style=flat-square" alt="测试：381 通过" />
23
23
  </p>
@@ -43,7 +43,7 @@ GitHub Copilot 和 ZCode。Claude Code 获得完整 hooks、skills 和 subagents
43
43
  mancode 会安装三类能力：
44
44
 
45
45
  1. **Hooks**：在 agent 提示词中注入项目上下文、设计 token 和 YAGNI 检查。
46
- 2. **Skills / modes**：提供 `solo`、`/mamba`、`/man`、`/manteam`、`/manps`、
46
+ 2. **Skills / modes**：提供 `solo`、`/manba`、`/man`、`/manteam`、`/manps`、
47
47
  `/mansolo` 工作流模式。
48
48
  3. **教练组 subagents**：Scout、Plan Coach、Head Coach、Film Analyst
49
49
  (Offense) 和 Film Analyst (Defense)。
@@ -73,13 +73,14 @@ mancode init
73
73
  初始化后，继续正常使用你的编码代理。`solo` 默认自动生效：日常训练，零仪式感。遇到需要
74
74
  计划、测试和多 agent 审查的任务时，使用 `/man`：季后赛，每球必争。
75
75
 
76
- 不同界面的调用方式不同：Claude Code 和 Cursor 使用 `/man`、`/mamba` 等命令；
76
+ 不同界面的调用方式不同：Claude Code 和 Cursor 使用 `/man`、`/manba` 等命令；
77
77
  ChatGPT 桌面端、Codex CLI 和 Codex IDE 扩展会从 `.agents/skills/` 读取项目 skill，
78
- 其中 `$man`、`$mamba` 等 `$` mention 是跨界面稳定的显式调用方式。ChatGPT 桌面端
78
+ 其中 `$man`、`$manba` 等 `$` mention 是跨界面稳定的显式调用方式。ChatGPT 桌面端
79
79
  还会把已启用的 skill 显示在 slash command 列表，因此发现并启用 `man` 后可从列表中
80
80
  选择 `/man`；CLI/IDE 则使用 `$man` 或 `/skills`。这些属于 agent skills，而不是已弃用
81
81
  的 custom prompts。参见官方 [skills 文档](https://learn.chatgpt.com/docs/build-skills)
82
82
  和 [slash command 文档](https://learn.chatgpt.com/docs/reference/slash-commands)。
83
+ 已有 workflow 元数据继续兼容，不需要迁移。
83
84
 
84
85
  ## 安装后创建哪些文件？
85
86
 
@@ -172,7 +173,7 @@ mancode 不是 Claude Code、Cursor、Codex 或 Copilot 的替代品。它是在
172
173
  | 模式 | 适合场景 | 做什么 |
173
174
  |---|---|---|
174
175
  | `solo` | 日常编码 · 日常训练 | 轻量 hooks、风格感知、YAGNI 检查和一次受限 diff 自检 |
175
- | `/mamba` | 诊断与真实验证 · 曼巴心态 | 复现缺陷、定位根因、驱动真实用户路径并执行回归检查 |
176
+ | `/manba` | 诊断与真实验证 · 曼巴心态 | 复现缺陷、定位根因、驱动真实用户路径并执行回归检查 |
176
177
  | `/man` | 生产级或高风险改动 · 季后赛 | 完整 9 步工作流和定向/完整风险审查 |
177
178
  | `/manteam` | 团队项目 · 上场五人，一条心 | 共享记忆、决策记录、协作和 Conventional Commits |
178
179
  | `/manps` | 清理和维护 · 季前赛 | 输出 Markdown 和 JSON 项目健康报告 |
@@ -253,7 +254,7 @@ src/components/
253
254
 
254
255
  ## 安装
255
256
 
256
- **状态**：稳定版 v0.3.5。Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
257
+ **状态**：稳定版 v0.3.7。Claude Code、Cursor、ChatGPT 桌面端中的 Codex、
257
258
  Codex CLI 和 GitHub Copilot 均已支持。ZCode adapter 已接入，但项目级 skill
258
259
  发现路径在发布前仍作为验证门禁。
259
260
 
@@ -301,14 +302,14 @@ mancode install --minimal # 只安装 solo 必需文件
301
302
 
302
303
  ```bash
303
304
  # Claude Code / Cursor
304
- /mamba # 定位 bug 并验证真实用户路径
305
+ /manba # 定位 bug 并验证真实用户路径
305
306
  /man # 完整 9 步流程和有界风险审查
306
307
  /manps # 项目健康检查
307
308
  /manteam # 团队模式和共享记忆
308
309
  /mansolo # 回到 solo 模式
309
310
 
310
311
  # ChatGPT 桌面端 Codex / Codex CLI / IDE
311
- $mamba
312
+ $manba
312
313
  $man
313
314
  $manps
314
315
  $manteam
@@ -323,7 +324,7 @@ mancode status
323
324
  mancode status --json
324
325
  mancode install <claude-code|cursor|codex|copilot|zcode>
325
326
  mancode list-platforms
326
- mancode workflow create <man|mamba|manteam> "<task>" [--parent-task <taskId>]
327
+ mancode workflow create <man|manba|manteam> "<task>" [--parent-task <taskId>]
327
328
  mancode workflow update <taskId> [--step N] [--status in_progress|planned|completed|blocked|abandoned] [--blocking-reason "<reason>"] [--outcome fixed|verified|no_repro|manual_test_required] [--plan-version N] [--skipped a,b]
328
329
  mancode workflow review <taskId> init --review-depth <targeted|full> [--review-domain <quality|security>]
329
330
  mancode workflow review <taskId> complete --review-domain <quality|security> --report <path> [--blockers Q1,Q2]
@@ -344,7 +345,7 @@ mancode version
344
345
  以下是 UI 项目的输出示例，并非默认技术栈：
345
346
 
346
347
  ```text
347
- mancode v0.3.5
348
+ mancode v0.3.7
348
349
 
349
350
  Project: my-app (React + TypeScript + Tailwind)
350
351
  Mode: solo (default)
@@ -404,7 +405,7 @@ mancode status --json
404
405
 
405
406
  ### `mancode workflow`
406
407
 
407
- 创建和管理 `/mamba`、`/man` 和 `/manteam` 使用的受校验 workflow 元数据。关联 `/mamba` 子任务只能在父任务处于 Step 6 且正在进行时创建；严格模式的 review 状态会记录所需领域、blocker ID 和唯一一轮修复。
408
+ 创建和管理 `/manba`、`/man` 和 `/manteam` 使用的受校验 workflow 元数据。关联 `/manba` 子任务只能在父任务处于 Step 6 且正在进行时创建；严格模式的 review 状态会记录所需领域、blocker ID 和唯一一轮修复。
408
409
 
409
410
  ```bash
410
411
  mancode workflow create man "refactor auth module"
@@ -412,8 +413,8 @@ mancode workflow update <taskId> --step 4 --plan-version 2
412
413
  mancode workflow review <taskId> init --review-depth full
413
414
  mancode workflow review <taskId> complete --review-domain quality --report film-report-1.md --blockers Q1
414
415
  mancode workflow review <taskId> remediate --resolved Q1
415
- mancode workflow create mamba "verify auth regression" --parent-task <taskId>
416
- mancode workflow update <mambaTaskId> --status completed --outcome verified
416
+ mancode workflow create manba "verify auth regression" --parent-task <taskId>
417
+ mancode workflow update <manbaTaskId> --status completed --outcome verified
417
418
  mancode workflow show <taskId> --json
418
419
  mancode workflow clean --older-than 30d --dry-run
419
420
  ```
@@ -466,7 +467,7 @@ mancode/
466
467
  │
467
468
  ├── Skills
468
469
  │ ├── solo/SKILL.md
469
- │ ├── mamba/SKILL.md
470
+ │ ├── manba/SKILL.md
470
471
  │ ├── man/SKILL.md
471
472
  │ ├── manteam/SKILL.md
472
473
  │ ├── manps/SKILL.md
@@ -494,7 +495,7 @@ mancode/
494
495
  | 阶段 | 重点 |
495
496
  |---|---|
496
497
  | MVP-1 | solo 模式、审美扫描、Claude Code hooks |
497
- | MVP-2 | `/mamba`、`/man`、`/manteam`、`/manps` 和教练组 subagents |
498
+ | MVP-2 | `/manba`、`/man`、`/manteam`、`/manps` 和教练组 subagents |
498
499
  | MVP-3 | Cursor、Codex（ChatGPT 桌面端/CLI）、GitHub Copilot 适配 |
499
500
  | 公开发布 | npm 稳定版、marketplace 分发、文档和演示 |
500
501
 
@@ -525,15 +526,15 @@ mancode/
525
526
 
526
527
  ### ZCode skills 未出现
527
528
 
528
- 确认 `.agents/skills/mamba/SKILL.md` 到 `.agents/skills/mansolo/SKILL.md`
529
+ 确认 `.agents/skills/manba/SKILL.md` 到 `.agents/skills/mansolo/SKILL.md`
529
530
  都存在，然后重启或刷新 ZCode。当前尚不生成 ZCode `/man*` slash commands，
530
531
  因为 workspace command 的文件路径仍需显式验证。
531
532
 
532
533
  ### Cursor rules 不触发
533
534
 
534
535
  确认 `.cursor/rules/mancode-*.mdc` 文件存在。`alwaysApply: true` 的规则
535
- （context、practice、solo）在每次对话加载。模式规则（mamba、man、manteam、
536
- manps）按 description 触发——输入 `/mamba` 等关键词即可激活。
536
+ （context、practice、solo）在每次对话加载。模式规则（manba、man、manteam、
537
+ manps）按 description 触发——输入 `/manba` 等关键词即可激活。
537
538
 
538
539
  ### 如何完全重装
539
540