AgentSkillsCN

cunzhi

寸止协议——通过 cunzhi MCP 工具,在关键决策点强制暂停并等待人工确认。这并非简单的文字输出“假装等待”,而是真正意义上的暂停。

SKILL.md
--- frontmatter
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

PointWhenPurpose
[REQ_READY]需求分析完成确认理解正确
[DESIGN_READY]方案设计完成确认技术方案
[PLAN_READY]计划制定完成确认执行计划
[PHASE_DONE]阶段执行完成确认继续下一阶段
[RELEASE_READY]准备发布确认发布
[TASK_DONE]任务完成确认归档

MCP 调用方式

确认请求

javascript
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: "取消任务" }
  ]
})

处理响应

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

Fallback (无 MCP)

当 cunzhi MCP 不可用时,使用文本确认:

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

## 计划摘要
[内容]

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

Rules

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

集成场景

需求审查

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

方案审查

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

发布确认

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

与 RIPER 集成

RIPER PhaseCunzhi PointTrigger
Research → InnovateREQ_READY需求分析完成
Plan → ExecutePLAN_READY计划制定完成
Execute → ReviewPHASE_DONE每阶段完成
Review → DoneTASK_DONE任务完成