cunzhi

name: cunzhi description: | 寸止协议 - Pause and wait mechanism using cunzhi MCP for human confirmation at critical decision points. Prevents AI from proceeding autonomously past important checkpoints. hooks: PreToolUse: - matcher: "tool == 'Write' && phase in ['design', 'implement']" command: "echo 'Approaching cunzhi point'"

寸止 (Cunzhi) Protocol

Concept

寸止 = "Stop at the inch" - Pause execution at critical points for human review.

Uses cunzhi MCP for interactive confirmation.

Cunzhi Points

MCP 调用方式

确认请求

mcp__cunzhi__confirm({
  point: "PLAN_READY",
  title: "计划确认",
  content: `
## 执行计划摘要

1. 创建 auth 模块
2. 实现 JWT 验证
3. 添加单元测试

预计时间: 2小时
  `,
  options: [
    { id: "continue", label: "继续执行", default: true },
    { id: "modify", label: "修改计划" },
    { id: "cancel", label: "取消任务" }
  ]
})

处理响应

switch (response.choice) {
  case "continue":
    // 继续执行下一阶段
    break;
  case "modify":
    // 回到规划阶段
    break;
  case "cancel":
    // 终止任务，保存状态
    break;
}

Fallback (无 MCP)

当 cunzhi MCP 不可用时，使用文本确认：

---
🛑 **[PLAN_READY]** 寸止等待确认

## 计划摘要
[内容]

请输入选择:
- `继续` 或 `c` - 执行计划
- `修改` 或 `m` - 调整后重新规划  
- `取消` 或 `x` - 终止任务
---

Rules

1. 必须等待 - 不可跳过寸止点
2. 明确输出 - 清晰展示等待内容
3. 选项明确 - 提供清晰的下一步选项
4. 状态保存 - 等待前保存当前状态

集成场景

需求审查

await cunzhi.confirm({
  point: "REQ_READY",
  content: formatRequirement(req),
  options: ["确认理解正确", "需要澄清", "重新描述"]
});

方案审查

await cunzhi.confirm({
  point: "DESIGN_READY", 
  content: formatDesign(design),
  options: ["批准方案", "调整设计", "换方向"]
});

发布确认

await cunzhi.confirm({
  point: "RELEASE_READY",
  content: formatReleaseNotes(release),
  options: ["确认发布", "延迟发布", "取消"]
});

与 RIPER 集成