# 文档结构与列规则

**仅在硬门禁通过后**书写。门禁未通过时只输出待确认清单（可附同主题总览）。

正文按当前目标填写；禁止把示意当固定产出照抄。

## 目标与计划记录

见 [requirements.md](requirements.md)。

## 阶段总览

路径：`plans/<主题>/stages.md`

```markdown
# <主题名> 阶段总览

## Meta
- Goal: <一句话总目标>
- Context: <关键约束与真实依赖，一句话>
- PlanMode: incremental
- DetailProgress: <已产出数>/<阶段总数>

## Stages

| Stage | Name | Outcome | Depends | Budget | DetailStatus | DetailPath |
|-------|------|---------|---------|--------|--------------|------------|
| P0 | <按本次目标命名> | <可观察结果> | — | <上限> | 已产出 | [stages/P0.md](stages/P0.md) |
| P1 | <按本次目标命名> | <可观察结果> | P0 | <上限> | 未产出 | — |
```

| 列 | 规则 |
|----|------|
| DetailStatus | `未产出` \| `已产出` \| `待修订` |
| DetailPath | 已有详细任务文件则相对链接；否则 `—` |
| DetailProgress | 与表内状态一致 |

不附工作项明细。

## 阶段任务清单

路径：`plans/<主题>/stages/P{n}.md`（默认每轮只写本轮目标阶段）

```markdown
# <主题名> · <Stage> <Name> 任务计划

## Meta
- Goal: <本阶段 Outcome 或总 Goal>
- Stage: <本阶段 ID>
- Depends: <前置阶段或 —>

## Tasks

| ID | Stage | Title | Deliverable | Deps | Ref |
|----|-------|-------|-------------|------|-----|
| W00x | <Stage> | <按本次目标拟定的精准标题> | <deliverable> | <Deps 或 —> | <Ref 或 —> |
```

| 列 | 规则 |
|----|------|
| ID | 全局唯一 `W001`…；续写时承接已用号段 |
| Title | ≤30 字；动词+对象；按本次目标拟定 |
| Deliverable | `define` \| `prepare` \| `produce` \| `integrate` \| `verify` |
| Deps | 可跨阶段引用已有工作项 ID |

## 外部依赖说明

路径：`plans/<主题>/dependencies.md`。细则见 [dependencies.md](dependencies.md)。

```markdown
# <主题名> 外部依赖说明

| 依赖 | 用途 | 接入状态 | 接入/替代 | 切换方式 |
|------|------|----------|-----------|----------|
| <名称> | <被何能力依赖> | 已提供 / 暂不提供 | <要点> | <配置项或步骤> |
```

## 澄清清单（按本次目标裁剪）

```markdown
## 同主题总览（若已有）
- Goal / DetailProgress / 下一默认阶段：

## 待确认（请直接选或改）
1. <题>：[ ] A  [ ] B  [ ] 其他：___
2. <依赖>：[ ] 提供接入：___  [ ] 暂不提供（可切换替代）
```