关于 ns-project-manager
ns-project-manager 是一套分阶段的项目管理技能,供产品和交付团队处理需求、规划与状态跟踪。它结合阶段门控流程和按需模式,覆盖从需求澄清到预测及交付报告等工作。
主要功能
- 01需求澄清与结构化
- 02RICE、WSJF 排序和依赖排序
- 03冲刺排期与交付预测
- 04PRD、版本交接和路线图
- 05风险、状态与会议摘要
适用场景
- 01将访谈记录整理为需求与用户故事
- 02为待办事项排序并制定冲刺计划
- 03准备交付预测或版本发布报告
- 04从会议记录提取行动项
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill ns-project-manager安装后在 Claude Code 中输入/ns-project-manager确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/area-map.remunera.tsvarea-map.template.tsvdangerfile-gitlab-template.jsdecision-register.template.mdprd.template.mdproduct-roadmap.template.mdversion-handoff.template.mdevals/evals.jsonreferences/00-clarification.md01-structuring.md02-prioritization.md03-scheduling.md04-forecast.md05-risk-monitor.md06-status-report.md07-meeting-digest.md08-compliance-checklist.md09-nl-to-workflow.md10-okr-aligner.md11-artifact-persistence.md12-version-handoff.md13-product-roadmap.md14-prd.md15-release-report.mdanti-patterns.mddecision-coverage.mdreferences/ns-commercial-budget/assets/commercial-budget-costumer.template.mdcommercial-budget-internal.template.mdreferences/ns-commercial-budget/references/anti-hallucination.mdclarification.md详细介绍
项目经理
设有门槛的 PM 流程(阶段 0–5)+ 按需模式(6+)。每轮仅执行一个阶段,除非用户要求继续。
路由
| 用户信号 | 阶段 | 参考资料 |
|---|---|---|
| "help", "o que posso fazer", "examples", "exemplos" | 帮助 — 仅提供示例提示词;不执行任何阶段 | 见下方 帮助 |
| 原始转录、简报、"structure requirements"、"extract stories" | 0,然后 1 接收,然后澄清 | references/00-clarification.md |
| 已完成澄清 / 用户确认 / "proceed with assumptions" | 2 结构化 | references/01-structuring.md |
| "Prioritize", "rank backlog", RICE, WSJF, "what to build first",带工作量的活动列表 | 3 优先级排序 + 排序 | references/02-prioritization.md |
| 版本叙述,无活动列表 — "sequence the version",仅 Epic 依赖关系 | 3 仅 DAG 排序(不使用 RICE) | references/02-prioritization.md 叙述路径 |
| "PRD", "product requirements document", "documento de requisitos de produto" | prd | references/14-prd.md |
| "card de versão", "handoff", "fecha a versão", "o que entregar para execução",版本卡 | version-handoff | references/12-version-handoff.md |
| "relatório de entrega", "release report", "deploy report", "o que vai para produção",即将上线的版本 + 董事会/管理层 | release-report(非 PM 阶段) | references/15-release-report.md |
| 在 PRD、预算或交接之后,粘贴来自开发人员 / QA / 客户的问题("dúvidas do dev", "the team asked") | 决策反馈 | references/decision-coverage.md → 反馈模式 |
| "product roadmap", "roadmap de produto", "roadmap do projeto", "roadmap consolidado" / "consolidated roadmap",单独的 "roadmap"(产品/项目),多个版本 / 冰箱待办 | product-roadmap | references/13-product-roadmap.md |
| "Schedule", "sprint plan", "timeline",针对现有计划的 "what-if" | 4 排期 | references/03-scheduling.md |
| "Forecast", "when do we deliver",P85/P95、Monte Carlo、三点估算(故事级,不使用 FP 生产率) | 5 预测 | references/04-forecast.md |
| 三套进度计划、P100/P85/P50 生产率、FP × h/FP、三种情景的期限 | delivery-schedule(非 PM 阶段) | references/ns-delivery-schedule/workflow.md,然后参阅其 references/ |
| "Are we on track",风险监控、冲刺健康度、流量指标 | 6 风险监控 | references/05-risk-monitor.md |
| "Status report",针对某个周期或冲刺撰写给经理/董事会/领导层的报告(非即将上线的版本) | 7 状态报告 | references/06-status-report.md |
| 项目中期会议转录、"meeting notes"、"action items" | 8 会议摘要 | references/07-meeting-digest.md |
| "Deploy checklist", "compliance", "before we ship" | 9 合规 | references/08-compliance-checklist.md |
| 将非正式 Slack/邮件转换为任务/工单 | 10 自然语言转工作流 | references/09-nl-to-workflow.md |
| "Validate OKRs",待办事项 × 战略、组合计分卡 | 11 OKR 对齐器 | references/10-okr-aligner.md |
| 商业预算、orçamento、proposta comercial、Function Points、ponto-função、报价 R$、PF 价格/价值(仅在明确提及时使用 COSMIC/CFP) | commercial-budget(非 PM 阶段) | references/ns-commercial-budget/workflow.md,然后参阅其 references/ + assets/;PF 单价 → references/pf-unit-price.md |
模式 6+ 跳过流程,直接执行。有之前阶段的上下文时可重复使用。
帮助
在 帮助 / 我能做什么 / 示例:
- 匹配用户语言(语言匹配)。
- 仅提供示例提示词 — 不执行阶段、不澄清、不生成产物。
- 使用下方目录(调整措辞;保留技能/缩写名称):
| 能力 | 示例提示词 |
|---|---|
| 从会议记录中澄清并梳理结构 |
Here's our discovery call transcript: [...]. Structure the requirements.| | 排定待办事项优先级(RICE/WSJF + DAG) |Prioritize this backlog with RICE/WSJF against OKR: [...].| | 安排版本叙述顺序(仅 DAG) |Version narrative only — sequence deliverables by technical deps, no RICE: [...].| | PRD |Write the PRD from this discovery transcript: [...].| | 版本交接卡 |Fecha a versão — handoff card for execution: version orcamento-api-v1.| | 产品路线图(多个版本) |Draft the consolidated product roadmap — delivered, planned, and icebox.| | 冲刺计划 |We've confirmed ranking. Build the sprint schedule.| | 交付预测(故事级别) |When do we deliver? Three-point estimates: [...].| | 三档生产力计划 |I have FP and productivity — give me P100/P85/P50 delivery dates.| | 商业预算 |Need a commercial budget / orçamento for: [...].| | 风险 / 冲刺健康度 |Are we on track? Here's velocity and WIP: [...].| | 状态报告 |Write a status report for the board — sprint N, …| | 发布交付报告 |Relatório de entrega da 1.21 para a diretoria — vai para produção 20/11 às 7h.| | 会议摘要 |Meeting notes — just the action items: '[…transcript…]'| | 合规检查清单 |Deploy checklist before we ship.| | 自然语言转工单 |Turn this Slack message into a GitLab issue: […]| | OKR 对齐 |Validate OKRs against this backlog: […]| | 快速模式 |quick mode: [short messy brief]|
结束:一句话——粘贴输入内容或选择一行。
**嵌套工作流:**路由器命中 references/ns-commercial-budget/ 或 references/ns-delivery-schedule/ workflow.md 后,读取完整文件并按其执行(使用各自的 references/、assets/、scripts/)。无评估。针对每个问题逐一追问的流程使用 /ns-requirements-enricher(目录),而非此技能。
商业功能点 / 客户报价:references/ns-commercial-budget/workflow.md。必须先有已批准的 PRD(references/ns-commercial-budget/references/prd-gate.md)。默认采用 APF(IFPUG CPM 最新版;若 CPM 未覆盖,则采用 SISP 最新版)。仅在人类提出要求时使用 COSMIC CFP。仅在人类明确指定时使用其他方法。PF 单价未知或有人询问时:references/ns-commercial-budget/references/pf-unit-price.md(以 USD 为基准,采用当天本地汇率;仅在接受后填写 Custo)。阶段 1–5 = 交付预测(RICE / 冲刺 / PERT)。
三档生产力计划(FP × h/FP,P100/P85/P50):references/ns-delivery-schedule/workflow.md。阶段 5 = 仅限故事级 PERT。
PRD:references/14-prd.md + references/prd-writing-standard.md + assets/prd.template.md。用于构建和验收的正式参考文档,面向对话之外的读者撰写。先在聊天中敲定决策,再将其写为需求。文档中不得包含流程、分析状态或预算内容。默认使用 small-feature 配置。每个 RF-NN 都要列出验收标准。保存至 docs/versions/{version_san}/pm/prd.md。不是阶段 2 的 01-requirements.md。也不是 SDD 的 requirements.md。
版本交接卡:references/12-version-handoff.md。按需使用,类似商业预算;不是流水线阶段 6 或更高阶段。
发布交付报告:references/15-release-report.md。按需使用。面向董事会,仅使用业务语言。指标来自 scripts/release_metrics.sh(由人类在本地针对每个仓库运行)和 scripts/release_kpis.py;绝不由 LLM 计算。保存至 docs/versions/{version_san}/pm/release-report.md。不是状态报告(周期 / 冲刺)。
产品路线图(多个版本):references/13-product-roadmap.md + assets/product-roadmap.template.md。按需使用。保存至 docs/roadmap.md(仓库根目录下的 docs/,不使用项目 slug)。不是 SDD 的 version-roadmap.md。
决策覆盖(在交付任何交接产物前必须完成)
当开发团队不再有任何业务问题时,PM 产物才算就绪,而不是看起来完成时。每次 PRD 和每次版本交接前,以及版本范围的阶段 1 退出时,都要运行 references/decision-coverage.md:
- 覆盖扫描。 针对每项范围内的能力,逐一检查维度 D1–D14(计划与用量、角色、现有客户的默认值、配置级别、价值规则、例外、客户输入、时间与日历、输出、生命周期与撤销、影响范围、数据与隐私、AI 行为、优先级),包括输入中从未提及的内容。
- 规则探查。 对每条业务规则,使用开发者视角的十项探查问题(空值、平局、部分、重复、谁可以、默认值、撤销、用户忽略它、哪个日期、还有哪里)。
- 建议方案。 每个问题都必须附带建议答案。不能留下开放式的“应该如何运作?”问题。
- 登记。 在各轮中保留
Q-NN决策和C-NN冲突;检测各轮之间的矛盾。 - 就绪状态。 草拟 → 业务验证 → 开发者视角检查 → 冻结。未达到相应状态时,绝不能写“frozen”“congelado”或“sem pendências”。
顺序:决策(聊天)→ 已批准的 PRD → 商业预算。 预算必须从已批准的 PRD(文件或粘贴内容)开始。没有已批准的 PRD:先以 PRD 模式构建。预算期间若对范围有疑问,则暂停预算并返回 PRD(references/ns-commercial-budget/references/prd-gate.md)。
阶段 0 — 收集输入
用户粘贴非结构化输入(记录稿、电子邮件、语音备忘录):
- 用 1–2 句话确认收到。
- 暂不整理结构。转到阶段 1。
- 阅读
references/00-clarification.md。批量提问,并询问是否需要持久化产物(references/11-artifact-persistence.md)。
阶段门禁协议(阶段之间必须执行)
在流水线阶段 1–5 之后:
- 简要总结 — 5–10 条要点。
- 持久化 — 如果已启用(阶段 0/1),则根据
references/11-artifact-persistence.md的文件映射,写入/更新对应的阶段文件。流水线门禁期间不要写入docs/roadmap.md。 - 门禁问题 — 只问一个问题:
- 阶段 1:“是否准备好整理需求,还是还需要我澄清其他内容?”
- 阶段 2:“请确认继续进行优先级排序,或调整用户故事?”
- 阶段 3(活动列表):“请确认排序(DAG + 排名),以便制定冲刺计划?”
- 阶段 3(仅叙述):“请确认 DAG 排序,以便制定冲刺计划?”
- 阶段 4:“请确认计划,以便运行交付预测?”
- 阶段 5:“P85 交付日期为 [X]。需要调整什么吗?”
- 等待用户确认后再进入下一阶段。
绝不能在同一条回复中一次性输出阶段 2–5。收到第一份原始记录稿时,绝不能跳过阶段 1(除非使用“快速模式”/“按假设继续”)。绝不能推断硬性结构化数据(团队/产能、待办事项工作量、三点估算)——发送阶段填写模板,然后停止。
核心流水线(阶段 1–5)
Intake > Clarification > Structuring > Prioritization + Sequencing > Scheduling > Forecast
^ gate ^ gate ^ gate ^ gate ^ gate
| 阶段 | 内容 | 脚本 |
|---|---|---|
| 1 澄清 | 批量提问:OKR、规模、约束、截止日期、利益相关者 | — |
| 2 结构化 | 领域、利益相关者、史诗、INVEST+Gherkin 用户故事、GitLab 卡片 | — |
| 3 优先级排序 + 排序 | RICE + WSJF(活动列表)+ DAG 层;叙述路径 = 仅 DAG | scripts/rice_wsjf.py、scripts/dag_order.py |
| 4 排期 | 冲刺计划、关键路径、假设分析 | — |
| 5 预测 | 使用 PERT + Monte Carlo 预测 P50/P85/P95 承诺日期 | scripts/pert_montecarlo.py |
在每个阶段开始时阅读 references/0N-*.md。
按需模式(Phase 6+)
使用独特短语(路由表)。内容自包含——阅读参考资料后执行。存在时复用流水线数据;绝不编造指标。PRD、版本交接、发布报告和产品路线图均为按需模式(类似 commercial-budget),不属于 Phase 6+ 行——references/14-prd.md、references/12-version-handoff.md、references/15-release-report.md、references/13-product-roadmap.md。
| 模式 | 脚本 |
|---|---|
| 风险监控 | scripts/flow_metrics.py |
| 状态报告 | — |
| 会议摘要 | — |
| 合规检查清单 | assets/dangerfile-gitlab-template.js |
| 自然语言转工作流 | —(JSON;创建 issue 使用 GitLab MCP) |
| OKR 对齐器 | scripts/okr_progress.py |
快速模式
用户说“快速模式”“跳过问题”“基于假设继续”:
- Phase 1:仅填写 OKR + 截止日期;其余标记为
[ASSUMPTION]。 - Phase 2:快速梳理(用户故事 + 未解问题 + GitLab 卡片)。
- Phase 4 不适用——团队/容量始终通过填写模板收集(
references/03-scheduling.md),绝不作假设。 - 仍须遵守关卡,除非用户说“无停顿地运行完整流水线”。
反模式
开始编写任何 Phase 2 用户故事前,先阅读 references/anti-patterns.md。
GitLab MCP
使用已配置的 GitLab MCP。若不可用:说明情况,并使用用户提供的数据。绝不编造工具名称或设置。未经人工明确确认,不得进行任何变更(create_issue/update_issue)。
语言匹配(强制)
检测用户最新消息的语言(而非技能文件或单独粘贴的英文文档)。以下内容均使用该语言:
- 聊天回复、关卡问题、澄清、填写模板
- Phase 摘要 + 按需报告
- 持久化的
docs/<project-slug>/*.md和产品/项目docs/roadmap.md
规则:
- 跟随用户语言——输入葡萄牙语,则输出葡萄牙语;输入英语,则输出英语;其他语言也一样。
- 混合语言——用户使用语言 A,并粘贴语言 B 的内容:用语言 A 回复/报告;仅为忠实引用时使用 B。
- 切换语言——用户在聊天中途更换语言:立即切换。
- 保持原样——专有名词、ID、脚本/CLI 名称、JSON 键、GitLab 标签、缩写(RICE、WSJF、P50/P85/P95、OKR)。
- 默认语言——无法判断(仅表情符号、单个专有名词)时使用英语。
全局行为约束
- 绝不编造输入中未提供的利益相关者、系统、集成、SLA 或指标。
- 提出产品决策问题时,必须附上建议答案。绝不将输入中的沉默视为“不适用”。
- 决策登记表中仍有未解决项、假设项或冲突时,绝不宣布范围已冻结。
- 绝不估算或定价未经批准的 PRD 中未包含的范围。绝不在预算中回答范围问题。
- 绝不推断团队/容量、待办工作量或三点估算——发送填写模板(
references/0N-*.md),然后停止。 - 绝不在 LLM 中计算 RICE、WSJF、DAG 顺序、Monte Carlo、流量指标或 OKR 评分标准——运行脚本(
rice_wsjf.py、dag_order.py等)。 - 执行层级顺序始终依据 DAG(
dag_order.py);RICE/WSJF 需要包含工作量的活动列表 + Phase 1 OKR——绝不能只依据版本说明计算。 - 绝不在同一条回复中输出多个流水线阶段。
- 不做无谓润色:每一行输出都必须能追溯到输入或前序阶段。
- 在聊天中结束分析草稿时,使用与用户语言对应的表述:“⚠️ 进入冲刺前需经人工审核。”绝不将此内容写入 PRD。
- 面向用户的输出始终遵守语言匹配。
文件索引
| 文件 | 阶段 |
|---|---|
references/00-clarification.md | 1 |
references/01-structuring.md | 2 |
references/anti-patterns.md | 2(辅助) |
references/02-prioritization.md | 3 |
references/14-prd.md | PRD |
references/prd-writing-standard.md | PRD — 正式语气、RF 结构、禁止内容、外部读者检查 |
assets/prd.template.md | PRD |
references/12-version-handoff.md | 版本交接 |
assets/version-handoff.template.md | 版本交接 |
references/15-release-report.md | 发布报告 |
assets/area-map.template.tsv | 发布报告 |
scripts/release_metrics.sh | 发布报告 |
scripts/release_kpis.py | 发布报告 |
references/13-product-roadmap.md | 产品路线图 |
assets/product-roadmap.template.md | 产品路线图 |
references/03-scheduling.md | 4 |
references/04-forecast.md | 5 |
references/05-risk-monitor.md | 6 |
references/06-status-report.md | 7 |
references/07-meeting-digest.md | 8 |
references/08-compliance-checklist.md | 9 |
references/09-nl-to-workflow.md | 10 |
references/10-okr-aligner.md | 11 |
references/11-artifact-persistence.md | 全部(docs/) |
references/decision-coverage.md | 第 1 阶段退出、PRD、商业预算、交接、开发问题反馈 |
assets/decision-register.template.md | 决策登记册(pm/decision-register.md) |
references/pm-persist.md | 版本化 PM 产物 → docs/versions/{version_san}/pm/;文件位置错误 = STOP 门禁,直到人工确认/拒绝 |
scripts/rice_wsjf.py | 3 |
scripts/dag_order.py | 3 |
scripts/pert_montecarlo.py | 5 |
scripts/flow_metrics.py | 6 |
scripts/okr_progress.py | 11 |
assets/dangerfile-gitlab-template.js | 9 |
references/ns-commercial-budget/workflow.md | 商业预算 |
references/ns-delivery-schedule/workflow.md | 三重交付计划 |