/product-new
在工作台内创建一个产品文件夹:先进行一次简短访谈,然后通过一个脚本写入文件夹,接着两个由模型调用的技能进行填充(source-recon 获取代码,product-kit 提取令牌、字体、图标、Logo、角色和名称)。
为什么在任何其他操作之前进行访谈:在衍生出这些技能的生产流程中,角色、产品名称和定位都是一轮轮评审后才确定的,每一次评审都会导致重新渲染。在这里收集的每个答案,都是未来不会发生的评审轮次。
开始之前
从当前技能的实际路径解析工作台(既可以从工作台根目录运行,也可以从一个产品文件夹中运行):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
从参数中检查 slug:2 到 40 个小写字母、数字或短横线,以字母开头。如果 $PVS_HOME/products/<slug> 已经存在,则停止并告知;绝不覆盖已有产品,因为它有自己的历史记录,可能还有已签署的简报。如果用户传入了 --from examples/acme(或其他文件夹),则访谈只需了解与其不同的部分。
在连接任何仓库之前,向用户说明一次:Claude 会读取产品的代码,这意味着代码会被作为上下文发送给模型。用户应确保其公司允许这样做。
1. 访谈
按小组提问(每次消息两到三个问题),使用用户的母语。对任何可以推断的内容给出默认值,以便用户主要是确认。完整的问题列表及每个问题背后的原因在 references/interview.md 中;请先阅读该文件再开始提问。
- 产品:名称、用一句话描述(定位)、面向谁。
- 禁用语:团队拒绝使用的描述,即使公司文档中有也不使用。
- 源代码:对每项(前端、后端、设计、文档)提供一个 Git URL 或本地路径、生产环境使用的分支、应用目录和框架(
angular-primeng、react、vue、svelte、html、other)。询问实际部署的是哪个分支:在原始生产环境中,过时的检出会浪费大量时间。 - 文档:URL、仓库路径或
mcp:<name>(只读)。 - 品牌:仅当不在前端时(Logo 和字体文件)。否则
product-kit会自动找到它们。 - 虚构角色:提议一个公司名和两到三个人,包括全名、555 电话和
example/.test域名的邮箱。以你的提议作为默认值,用一个闭合式问题让用户拒绝。评审员对平淡或听起来像真人的名字反应强烈,而姓在视频中发生变化是一个会发布的错误。 - 名称和发音:规范名称、当前 UI 中可能仍然显示的历史遗留字符串,以及品牌词汇的读法。
- 禁止提及的术语:竞争对手、供应商、真实客户,任何绝对不能出现或被听到的内容。
- 评审员:签署每个视频的覆盖矩阵和声明表的人。
绝不要索要令牌、密码或 SSH 密钥,也绝不要主动存储它们。源代码拉取使用机器已有的 Git 访问权限。如果 URL 中包含凭据(https://user:token@...),请让用户删除;脚本无论如何都会拒绝它们。
2. 写入文件夹
将答案写入一个类似 product.yaml 格式的临时文件(可以是任意子集;参见 references/answers.example.json),存放在仓库外部,然后运行:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/product-new/scripts/new_product.py" <slug> \
--answers <scratch>/answers.json [--from examples/acme]
该脚本会复制 _template/product,然后将 --from 指定的文件夹覆盖到其上(因此如果某个示例缺少文件,如 kit/RULES.md,仍会从模板中获取),将答案逐行合并到 product.yaml 中(模板的注释是用户的文档,因此保留),当模板没有时写入 CLAUDE.md 和 .gitignore,运行 scripts/link-skills.sh 使得 cd products/<slug> && claude 能看到相同技能,并创建第一个 Git 提交。它会拒绝已存在的 slug、URL 中的凭据以及明显非虚构的角色邮箱和电话。如果失败,修正它指出的答案并重新运行;不要手动创建文件夹。
如果输出 "still to fill in product.yaml",则表示模板中有一些占位符在访谈中未覆盖。询问这些占位符,或者告知用户哪些仍未填写。
3. 填充
通过 Skill 工具按顺序调用由模型调用的技能:
source-recon,将每个源代码拉取到products/<slug>/sources/目录并锁定到sources.lock文件中。如果某个拉取因访问权限失败,报告精确的 Git 错误并停止:用户自行在他们的机器上修复访问权限,绝不要让你提供凭据。product-kit,提取kit/tokens.css、字体、图标、Logo,并将角色、名称和发音写入kit目录和kit/RULES.md文件。
两者都只会在产品文件夹内写入。绝不编辑 sources/ 目录中的任何内容。
4. 报告
一个简短的表格,然后给出下一步命令:
| 项目 | 值 |
|---|---|
| 文件夹 | products/<slug>/(Git:首次提交或未提交的原因) |
| 源代码 | 角色、分支、来自 sources.lock 的提交号 |
| 套件 | product-kit 提取的内容以及未找到的内容 |
| 角色 | 已冻结的角色名称,供最后一次否决 |
| 待办 | product.yaml 中仍有占位符、任何未验证的内容 |
下一步:cd products/<slug> && claude,然后 /video-new <video>。