# TAPD 输出模板

## 1. 规范文档型：需求/任务查询结果

### 输出模板

- 项目：`{{workspace_name}}`（`{{workspace_id}}`）
- 对象类型：`{{entity_type}}`
- 查询条件：`{{query_summary}}`
- 结果摘要：`{{summary}}`

#### 明细

| 编号 | 标题 | 状态 | 负责人 | 计划时间 | 备注 |
|------|------|------|--------|----------|------|
| {{id}} | {{name}} | {{status}} | {{owner}} | {{schedule}} | {{note}} |

#### 结论

- 当前结论：{{conclusion}}
- 后续动作：{{next_action}}

## 2. 规范文档型：缺陷跟踪结果

### 输出模板

- 项目：`{{workspace_name}}`（`{{workspace_id}}`）
- 缺陷范围：`{{query_summary}}`
- 结果摘要：`{{summary}}`

| 缺陷ID | 标题 | 状态 | 严重程度 | 处理人 | 备注 |
|--------|------|------|----------|--------|------|
| {{id}} | {{title}} | {{status}} | {{severity}} | {{owner}} | {{note}} |

## 3. 规范文档型：迭代汇报

### 输出模板

- 项目：`{{workspace_name}}`（`{{workspace_id}}`）
- 迭代：`{{iteration_name}}`
- 时间范围：`{{date_range}}`

#### 进展概览

- 已完成：{{done_summary}}
- 进行中：{{progressing_summary}}
- 风险项：{{risk_summary}}

#### 建议关注

- {{focus_1}}
- {{focus_2}}
- {{focus_3}}

## 4. 粒度映射模板

### TAPD 与 speckit 对齐关系

| TAPD 层级 | speckit 对应物 | 说明 |
|-----------|----------------|------|
| Epic / 大主题 | feature 背景 | 例如 REV-005 这类主题范围 |
| Story | `spec.md` | 最小需求粒度，一个可独立评审与交付的设计闭环 |
| Task | `tasks.md` 中的任务项 | 具体执行动作，如修改某篇文档、补某张表、校核某组引用 |

### 立项判断规则

优先作为一个独立 Story / speckit feature 的情形：

- 需要跨两篇及以上主文档协同修改
- 需要同时对齐详细设计、接口设计、数据库设计中的两类及以上内容
- 具备明确边界、验收标准与独立评审价值

优先作为 Task 的情形：

- 单字段修订
- 单表格补充
- 单文档局部改写
- 链接、标题、编号等局部一致性修复

### speckit feature 命名模板

#### 推荐命名公式

`<主题编号>-<场景关键词>-<交付动作>`

#### 推荐写法

- `rev005-invoice-apply-design`
- `rev005-invoice-redflush-alignment`
- `rev005-invoice-status-rules`
- `rev005-invoice-db-interface-sync`

#### 中文标题模板

`<主题编号>：<业务场景><交付动作>`

示例：

- `REV-005：补齐发票开具申请设计闭环`
- `REV-005：统一发票红冲字段口径`
- `REV-005：补齐发票状态流转规则`

#### 命名约束

- 使用小写英文与连字符 `-`
- 不使用空格、中文、下划线
- 主题编号放在最前面，便于同批需求聚类
- 场景关键词优先写业务对象，不要只写模块名
- 交付动作优先使用 `design`、`alignment`、`rules`、`sync`、`cleanup` 等可辨识词
- 一个 feature 名称只表达一个独立交付目标，不混入多个并列场景

#### 交付动作建议词表

- `design`：补齐某业务场景设计闭环
- `alignment`：统一多文档之间的字段或口径
- `rules`：补齐规则、状态流转、约束条件
- `sync`：做跨文档同步与一致性收口
- `cleanup`：处理遗留结构、引用、编号、术语收口

#### 快速套用模板

- 场景设计类：`<topic>-<scenario>-design`
- 口径统一类：`<topic>-<scenario>-alignment`
- 规则补齐类：`<topic>-<scenario>-rules`
- 跨文档收口类：`<topic>-<scenario>-sync`

#### 当前仓库推荐示例

- `rev005-invoice-apply-design`
- `rev005-invoice-issue-result-sync`
- `rev005-invoice-redflush-alignment`
- `rev005-invoice-status-rules`
- `rev005-invoice-db-interface-sync`

## 术语偏好

- story：需求
- task：任务
- bug：缺陷
- iteration：迭代