Write Product Spec Skill 安全审计
作者说它能做什么(原文)
Write a PRODUCT.md spec for a significant user-facing feature in Warp, focused on detailed behavior and validation. Use when the user asks for a product spec, desired behavior doc, or PRD, wants to define feature behavior before implementation, or when the feature is substantial or behaviorally ambiguous enough that a written spec would improve implementation or review.
这次检查未发现明显风险
- 已检查文件
- 1
- 发现的风险
- 0
Skill 逻辑拆解
该 Skill 的主要作用是为重要功能编写面向用户行为的 PRODUCT.md,明确禁止在其中加入内部类型、算法或其他实现细节。
查看原文
Write a `PRODUCT.md` spec for a significant feature in Warp.## OverviewThe product spec should make the desired behavior unambiguous enough that an agent can implement it correctly and avoid regressions. Describe the feature purely from the user's perspective — what the user sees, does, and experiences, and the invariants that must hold for them. Do not include implementation details (internal types, state layout, module boundaries, data flow, algorithms).它会在 specs/<id>/PRODUCT.md 创建或维护持久文件;目录 ID 来自 Linear 工单、GitHub issue 或用户提供的功能名称。
查看原文
Write specs to `specs/<id>/PRODUCT.md`, where `<id>` is one of:- a Linear ticket number (e.g. `specs/APP-1234/PRODUCT.md`)- a GitHub issue id, prefixed with `gh-` (e.g. `specs/gh-4567/PRODUCT.md`)- a short kebab-case feature name (e.g. `specs/vertical-tabs-hover-sidecar/PRODUCT.md`)`specs/` should contain only id-named directories as direct children — no engineer-named subdirectories.## Keep the spec currentApproved specs may ship in the same PR as the implementation. As implementation evolves, update `PRODUCT.md` in the same PR when user-facing behavior or UX details change. The checked-in spec should describe the feature that actually ships.对于有界面或交互设计的功能,它要求先询问是否存在 Figma mock,并在规格中记录提供的链接;纯后端功能不询问。
查看原文
If the feature has any UI or interaction design, ask the user whether a Figma mock exists before drafting the Behavior section, and include the link in the spec when one is provided. A mock is often the most reliable source of truth for visual states, spacing, and edge-case layouts — not asking can cause the Behavior section to guess at intent the designer already settled.- If the user provides a link, include it under a short `## Figma` section (or inline near the top of Behavior) as `Figma: <link>`.- If the user confirms no mock exists, note `Figma: none provided` so the absence is explicit rather than ambiguous.- If the feature is purely backend (data model, API, CLI with no visual surface), skip the question and omit the section.该 Skill 提及可能使用 Linear MCP 或 gh 创建外部工单,但明确限制为只有用户主动要求时才可创建,并在团队、标签或仓库不明确时要求澄清。
查看原文
Ticket / issue references are optional. If the user has a Linear ticket or GitHub issue, use its id. If they don't, ask them for a feature name to use as the directory. Only create a new Linear ticket or GitHub issue when the user explicitly asks for one; in that case use the Linear MCP tools or `gh` CLI respectively (and `ask_user_question` if team, labels, or repo are unclear).文件与检查记录1 个文件
检查范围与遗漏
逐文件查看涉及的内容
下方列出本次涉及的原文范围;纳入检查不代表已查清所有问题。
SKILL.md已纳入全文
这份报告只针对上方版本。我们看了拿到的代码和说明文件,没有实际运行 Skill,也没有检查它另外安装的软件包。因此,这不是“保证安全”的承诺;换了版本或使用环境,结果也可能不同。
SKILL.md工作说明
- 读取了多少行
- 165
- 文件校验值(用于核对版本)
- 4e7ef781aad1cd42e3178680f6e9d72de439d66c1b99023e4386103065a5fb19