给你的编程 Agent
一套真正可执行的战术。

$ npm install -g mancode
$ cd your-project
$ mancode init

$ mancode init --platform codex,cursor
$ mancode init --yes --platform codex --no-team
$ mancode init --empty --platform claude-code --lang zh-CN

$ mancode status
$ mancode status --json

$ mancode status --brief --json
$ mancode context session new --client claude-code
$ mancode context resume <namespace:ULID> --session <id> --client claude-code
$ mancode context show --purpose orient --session <id> --client claude-code

{
  "version": 1,
  "goal": "重构认证模块，同时保持登录行为不变",
  "confirmedScope": ["把 token 校验提取到现有 auth service"],
  "excludedScope": ["更换身份提供商", "重做登录界面"],
  "technicalDecisions": ["保留现有 TypeScript 与 session 技术栈"],
  "defaults": ["保持当前超时时间"],
  "blockingUnknowns": [],
  "coverage": [
    { "dimension": "platform", "status": "confirmed", "rationale": "Node 服务" },
    { "dimension": "core_scope", "status": "confirmed", "rationale": "仅重构" },
    { "dimension": "technical_stack", "status": "confirmed", "rationale": "沿用现有技术栈" },
    { "dimension": "data_and_persistence", "status": "not_applicable", "rationale": "无数据结构变更" },
    { "dimension": "performance", "status": "defaulted", "rationale": "不得低于现有基线" },
    { "dimension": "compatibility", "status": "confirmed", "rationale": "外部行为保持不变" },
    { "dimension": "security", "status": "confirmed", "rationale": "token 校验继续 fail-closed" }
  ],
  "acceptanceCriteria": [
    {
      "id": "AC-LOGIN",
      "description": "有效和过期 token 保持当前行为",
      "required": true,
      "method": "automated"
    }
  ]
}

$ mancode workflow requirements <local:ULID> finalize --file requirements-input.json --expected-revision <revision> --session <session-id>

# 创建 actor 和显式 session
$ mancode team identity create --name "Your name"
$ mancode context session new --client codex --json

# 创建、发现并检查任务
$ mancode workflow create man "refactor auth module" --session <session-id> --json
$ mancode workflow list --json
$ mancode workflow show <local:ULID> --json

# 需求和计划闸门（每次使用上一个命令返回的 revision）
$ mancode workflow requirements <local:ULID> finalize --file requirements-input.json --expected-revision <revision> --session <session-id>
$ mancode workflow plan <local:ULID> revise --file plan.md --expected-revision <revision> --session <session-id>
$ mancode workflow plan <local:ULID> confirm --plan-decision governed_execution --expected-revision <revision> --session <session-id>

# 记录规范化评审和验证台账
$ mancode workflow review <local:ULID> apply --file review-ledger.json --expected-revision <revision> --session <session-id>
$ mancode workflow verify <local:ULID> apply --file verification-ledger.json --expected-revision <revision> --session <session-id>
$ mancode workflow complete <local:ULID> --expected-revision <revision> --session <session-id>

# remediation 后更新规范化台账
$ mancode workflow review <local:ULID> apply --file review-ledger.json --expected-revision <revision> --session <session-id>
$ mancode workflow verify <local:ULID> apply --file verification-ledger.json --expected-revision <revision> --session <session-id>
$ mancode workflow complete <local:ULID> --expected-revision <revision> --session <session-id>

$ mancode refresh-project
$ mancode refresh-style
$ mancode install cursor --force

$ mancode uninstall cursor --force

$ mancode uninstall claude-code --force
$ mancode install claude-code

$ npm uninstall -g mancode