# logic-confirmation

> 逻辑确认 - 理解用户输入并确认，结合文档输出行动计划设计思路和逻辑说明

- Author: hrply
- Repository: hrply/iflow-skills
- Version: 20260126131508
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/hrply/iflow-skills
- Web: https://mule.run/skillshub/@@hrply/iflow-skills~logic-confirmation:20260126131508

---

---
name: logic-confirmation
description: 逻辑确认 - 理解用户输入并确认，结合文档输出行动计划设计思路和逻辑说明
license: MIT
---

# 逻辑确认

## 概述

接收用户的问题或要求，结合模型已缓存的上下文，输出对用户意图的理解并让用户确认。确认后读取相关文档，输出行动计划的设计思路和逻辑说明，再次确认后输出文档并触发计划撰写流程。

## 核心能力

### 1. 用户输入理解

**输入处理**：
- 接收用户的问题、要求或需求描述
- 结合当前对话上下文进行理解
- 输出结构化的理解结果

**理解输出模板**：
```markdown
## 用户输入理解

**原始输入**：
[用户的原始问题或要求]

**上下文背景**：
[结合已缓存的上下文信息]

**模型理解**：
- **核心需求**：[需求的核心目标]
- **涉及范围**：[涉及的功能/页面/模块]
- **预期目标**：[期望达成的结果]
- **约束条件**：[已有的限制或要求]

**待确认事项**：
- [ ] 理解是否准确？
- [ ] 是否有遗漏的关键点？
```

### 2. 文档定位与读取

**文档查找流程**：
1. 读取 `./docs/index.md` 获取文档索引
2. 根据用户输入定位相关文档
3. 读取相关文档内容

**索引读取逻辑**：
```python
def read_docs_index():
    """读取 docs 目录下的 index.md"""
    index_path = './docs/index.md'
    with open(index_path, 'r', encoding='utf-8') as f:
        return f.read()

def locate_docs(understanding, index_content):
    """根据理解结果定位相关文档"""
    # 关键词匹配或分类定位
    relevant_docs = []
    for doc in index_content['documents']:
        if matches(understanding, doc):
            relevant_docs.append(doc)
    return relevant_docs
```

### 3. 行动计划设计输出

**设计思路文档模板**：
```markdown
# 行动计划设计

## 需求概述
[基于用户输入和文档理解]

## 设计思路

### 整体架构
[架构层面的设计思路]

### 核心逻辑
1. 逻辑步骤一
2. 逻辑步骤二
3. 逻辑步骤三

### 关键决策点
| 决策点 | 选项 | 选择 | 理由 |
|--------|------|------|------|
| 决策一 | A/B/C | A | 理由 |

### 依赖关系
- 前置条件：[需要满足的条件]
- 依赖模块：[依赖的文档或模块]
- 输出产物：[产生的文档或代码]

## 详细说明

### 流程图
```
[流程图描述]
```

### 数据结构
```python
# 相关数据结构定义
```

### 接口设计
[API 或交互接口设计]
```

### 4. 文档输出与更新

**文档写入逻辑**：
```python
def output_design_document(design_content, docs_dir='./docs/'):
    """输出设计文档到 docs 目录"""
    timestamp = datetime.now().strftime('%Y%m%d_%H%M%S')
    filename = f"design_{timestamp}.md"
    filepath = os.path.join(docs_dir, filename)
    
    with open(filepath, 'w', encoding='utf-8') as f:
        f.write(design_content)
    
    return filepath

def update_index_md(design_filepath, index_path='./docs/index.md'):
    """更新 index.md 索引"""
    # 读取现有 index.md
    # 添加新文档索引
    # 写回 index.md
```

## 工作流程

### 完整流程

```
用户输入 → 理解输出 → 用户确认(workflow-controller)
     │
     ├─ 确认 ──→ 读取 index.md → 定位文档 → 读取文档
     │                              │
     │                              ↓
     │                      设计思路输出 → 用户确认(workflow-controller)
     │                                    │
     ├─ 确认 ──→ 输出文档到 ./docs/ ──→ 更新 index.md
     │                                    │
     │                                    ↓
     │                              调用 test-plan skill
     │
     └─ 否，修改意见 → 重新理解循环
```

### 循环处理

**用户否定处理**：
```markdown
## 反馈处理

**用户反馈**：否，[修改意见]

**处理动作**：
1. 提取修改意见
2. 更新理解/设计
3. 重新输出确认
4. 再次提交给 workflow-controller
```

## 使用方法

### 基本调用

```
用户: 我需要添加用户认证功能
→ logic-confirmation 执行完整理解-确认-设计流程

用户: 优化数据库查询性能
→ logic-confirmation 分析并输出优化设计
```

### 与 workflow-controller 配合

1. logic-confirmation 完成理解后，调用 workflow-controller 确认
2. 确认通过后继续设计流程
3. 设计完成后再次调用 workflow-controller 确认
4. 最终调用 test-plan skill

## 输出产物

- 用户理解确认文档
- 设计思路文档 (`./docs/design_*.md`)
- 更新的 `index.md`
- 触发的测试计划

## 与其他技能配合

- workflow-controller - 用户确认流程控制
- test-plan - 计划撰写触发
- index-builder - 文档索引维护

## 📝 自动文档生成

### 设计文档模板

```markdown
# 行动计划设计

## 基本信息
- 创建时间: YYYY-MM-DD HH:mm:ss
- 需求来源: 用户输入
- 状态: 待确认 / 已确认

## 需求理解
[用户输入的结构化理解]

## 设计思路

### 1. 整体设计
[架构和设计思路]

### 2. 详细逻辑
[具体实现逻辑]

### 3. 关键决策
[设计决策点]

## 依赖文档
- 依赖文档1: [链接]
- 依赖文档2: [链接]

## 验证标准
[如何验证设计正确性]
```

### 设计记录 (`.docs/designs/`)

```log
#========================================
# 设计记录
#========================================
时间: YYYY-MM-DD HH:mm:ss
需求: [用户需求摘要]
状态: [待确认/已确认/已执行]

设计输出: .docs/designs/design_YYYYMMDD_HHMMSS.md
关联文档: index.md
触发计划: test-plan
#========================================
```

## 环境说明

### 文档目录
- `./docs/index.md` - 文档索引
- `./docs/design_*.md` - 设计文档
- `./docs/[已有文档]` - 相关说明文档

### 文档索引格式 (index.md)

```markdown
# 文档索引

## 文档列表

| 文档名称 | 路径 | 最后更新 | 标签 |
|----------|------|----------|------|
| 设计文档1 | design_20240124_103000.md | 2024-01-24 | 认证 |

## 标签分类

### 认证
- design_20240124_103000.md

### 数据库
- [文档列表]
```