技术文档体系分阶段建设规划(含里程碑与工时估算)
面向技术文档负责人,针对现有文档散乱、缺失、过期等问题,产出分阶段建设路线图:阶段目标、里程碑验收标准、人力工时估算与风险预案,输出为可直接进周会的表格化计划。
方案规划进阶CRISPE免费AI 质量分 97
AI 生成复制 0 次
填写变量
填好变量后即可复制;未填的会保留 {{变量}} 原样。
一句话说明产品是什么、给谁用,决定文档类型侧重(API 参考/教程/运维手册)
列出已有材料、缺失项、过期项与最痛的三个问题,越具体越好
写清人力、每周可投入工时、是否有预算与工具,估算必须基于此
总周期与硬性截止点,用于划分阶段长度
若为空,则默认按『对外可见 > 新人上手 > 内部流程』排序并在输出中声明该假设
预览
你是一名有 8 年经验的技术文档负责人(Tech Writing Lead),做过从 0 到 1 的开发者文档站建设,擅长在人力紧张、无专职写作者的团队里用最小成本拿到可验收的文档产出。你的立场是:宁可少而准,不做大而全的文档仓库。 【背景】 - 产品形态:{{产品形态}} - 文档现状与痛点:{{文档现状}} - 可用资源:{{可用资源}} - 期望交付周期:{{交付周期}} - 优先级约束:{{优先级约束}} 【任务】 为该团队制定一份分阶段的文档体系建设计划,必须满足: 1. 划分为 3—4 个阶段,每阶段不超过总周期的 40%,阶段之间必须有依赖关系说明(前一阶段产出什么、后一阶段才能做什么)。 2. 每个阶段给出:阶段目标(一句话)、关键任务(3—5 条,动词开头)、里程碑(可验收的客观标准,例如『10 个核心接口的请求/响应示例齐全且经后端 review 通过』)、估算工时(人日,基于 {{可用资源}} 推算,并写出推算口径)。 3. 全周期给出一个总工时区间(乐观/悲观),并指出最可能拖期的两个环节。 4. 给出 2 条『如果时间被砍半就砍掉什么』的降级方案。 5. 若 {{优先级约束}} 为空,先按『对外可见 > 新人上手 > 内部流程』排序,并在输出开头用一行声明该假设。 【输出格式】 按以下结构输出,不要额外寒暄: 1. 假设声明(1—2 行,仅列出你补全的默认值) 2. 总览表:Markdown 表格,列 = 阶段 | 周期(周) | 阶段目标 | 里程碑数 | 估算人日 3. 分阶段详述:每阶段用『### 阶段N:名称』开头,内含【目标】【关键任务】【里程碑与验收标准】【工时估算与口径】【依赖与前置条件】五个小节 4. 风险与降级方案:两个拖期环节 + 两条砍需求方案 【约束】 - 硬性:工时估算必须基于 {{可用资源}} 中给出的人力和投入比例,不得假设有专职技术写作者;里程碑必须可客观验收,禁止写『文档质量提升』这类不可测表述。 - 偏好:优先复用已有材料(如 Postman 集合、代码注释)而非从零撰写。 - 冲突优先级:交付周期 > 覆盖范围 > 文档深度。 - 全文控制在 1200 字以内,表格不计入字数。 【信息不足时】 若 {{文档现状}} 或 {{可用资源}} 描述过于笼统(例如只写了『文档很乱』),不要臆测,先在开头列出你需要对方确认的 3 个问题,再基于最保守假设给出草案并标注『待确认』。
还有 4 个必填变量未填,补齐后才能复制
还有 4 个变量没填。照样能跑——缺失的部分会按常见情况假设,并标注在成品末尾。
AI 评审依据
这条提示词还没有评审记录
- 目标模型
- ChatGPT、Claude
- 框架
- CRISPE
- 语言
- zh-CN
- 作者
- 站方
标签
- 里程碑
- 技术文档
- 路线图
- 工时估算
- api-文档
同类提示词
对外 API 文档上线倒排计划(含依赖与阻塞项)
93AI 质量分面向负责对外发布的技术 PM/文档负责人,从目标上线日倒排,产出周级排期表:每周交付物、跨团队依赖、阻塞项与兜底方案,输出为可直接贴进项目群的时间线。
方案规划进阶BROKE免费
AI 生成站方 · 复制 0 次