# Write Roadmap

> 人工审批通过后，将规划报告中的版本节奏建议追写/更新到 docs/product-planning/roadmap.md，完成调研规划期的最终输出。

- **Type:** Skill
- **Install:** `agentstack add skill-xinyiai0724-tools-write-roadmap`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xinyiai0724](https://agentstack.voostack.com/s/xinyiai0724)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** https://github.com/xinyiai0724/tools/tree/main/skills/planning/write-roadmap

## Install

```sh
agentstack add skill-xinyiai0724-tools-write-roadmap
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: write-roadmap

**类型**: 规划期 Skill（planning/ 组）  
**调用时机**: product-planning pipeline 最后节点（人工审批通过后）

---

## 用途

将规划报告中已审批通过的版本节奏建议追写到 `docs/product-planning/roadmap.md`，保持路标文档的持续更新。若文件不存在则新建。

---

## 参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `topic` | string | ✅ | 本次规划主题（用于路标条目标题） |
| `target_version` | string | ❌ | 版本号；若为空则从规划报告 frontmatter 中读取 |
| `planning_report_path` | string | ❌ | 规划报告文件路径（由 pipeline 自动注入） |

---

## 执行步骤

### Step 1 — 读取规划报告

读取 `{{planning_report_path}}` 中的"路标建议"章节，提取各版本的功能集与时间节点。

### Step 2 — 读取现有路标

读取 `docs/product-planning/roadmap.md`（若不存在则视为空文档）。

### Step 3 — 合并更新

追写/更新规则：
- 若路标中已存在 `{{target_version}}` 条目：在该版本条目下追加本次规划新增的功能项（不删除已有内容）
- 若路标中无该版本：在合适位置（按版本号顺序）插入新版本节

路标格式约定：

```markdown
## 路标（Roadmap）

> 最后更新：{YYYY-MM-DD}

### {target_version}（{计划时间范围}）
**主题**：{版本主题}

| 功能 / CR | 优先级 | 来源 | 状态 |
|---------|-------|------|------|
| {feature-id 或 CR-ID}（{title}） | P0 | planning-{date} | 规划中 |
```

### Step 4 — 落盘

幂等写回 `docs/product-planning/roadmap.md`。

Commit：`[planning] update roadmap for {topic} (${target_version})`

### Step 5 — 输出摘要

```
✅ 路标更新完成
   文件     : docs/product-planning/roadmap.md
   新增条目 : {N} 条
   版本节   : {target_version}
```

---

## 注意事项

1. **幂等**：重跑不产生重复条目（按功能 ID 去重）
2. **只追加不删除**：不得删除路标中已有的条目，仅新增或更新状态字段
3. **不影响 specs/**：路标文件仅位于 `docs/product-planning/`，与 specs/ 无关

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** [xinyiai0724/tools](https://github.com/xinyiai0724/tools)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xinyiai0724-tools-write-roadmap
- Seller: https://agentstack.voostack.com/s/xinyiai0724
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.