大多数目录站表单都分成两部分:一部分介绍产品,另一部分介绍你——maker 简介、姓名和所属机构,在发布榜单上有时还要一段“我为什么做这个产品”的留言。工具包有意把这两部分分开处理。关于产品的表述来自文案工作坊,保存在 copy.md 中;关于你个人的表述则来自 identity.json,以及工具包称为“对外形象简报”(representation briefing)的一个简短环节,具体流程写在 PR-BRIEFING.md 里。本指南说明这个环节是什么、为什么需要它,以及最终会写进 representation.md 的内容。
为什么要单独做一次
刚填完 product.json 的智能体对你的产品了解很多,但对你希望以什么形象出现几乎一无所知。放任不管的话,它会用能找到的任何信息临场拼凑一段简介——以前的雇主、之前的项目、GitHub 资料里写的城市——然后贴进公开的 maker 资料,一旦发布就很难撤回。这个简报环节的目的,就是在你亲眼看到将要使用的原句之前,不让任何个人信息出现在上架页面上。每个产品在第一条个人信息公开之前做一次;之后这些信息有变化时,再做一次。
三个问题
智能体会用直白的语言直接问你:
- 你是以个人、公司,还是两者兼有的身份出现? 这决定了表单中的“maker”字段填昵称、法定姓名还是组织名称。
- 哪些昵称、姓名和所属机构可以出现?
identity.json里的信息并不是每一条都适合出现在每个目录站上。 - 哪些内容绝对不能提? 过去的产品、无关的雇主、你的真实所在地——任何你不希望和发布帖子挂钩的信息。
注意它不会问什么:智能体不会自己编几个选项让你挑。它只收集约束条件,然后完全基于你确认过的事实来写。
三段示例,逐字展示
智能体只用你确认过的信息起草三段简短文字,并逐字展示给你:
- 一句话的 maker 简介,用于目录站的个人资料;
- 一句话的发布或论坛自我介绍,也就是 Show HN 式帖子或发布榜单留言需要的那种开场白;
- 一句话的“我为什么做这个产品”留言。
然后它只问一个真正要紧的问题:这里有没有错误、夸大或遗漏?每一处修改都会直接改到示例本身,而不只是在 identity.json 里悄悄记一笔。这个区别是刻意的——如果智能体只改了数据文件,却留着一份措辞过时的草稿,它下次还是会用旧措辞。你没看过的内容,一律不会发布。
保存了什么,存在哪里
确认后的示例、你的修改以及确认日期,会写进你私有工作区中该产品文件夹下的 representation.md。此后,任何需要简介或自我介绍的平台指南步骤都会从这里读取,而不是重新编写。有两条边界保证这个文件值得信赖:
- 个人表述绝不会混进
copy.md的产品表述,反之亦然。产品上下文文件描述的是产品;representation.md描述的是你。 - 这个文件属于私有工作区,绝不会进入共享的交付仓库;里面只包含你批准公开的事实——不包括你的私人账号邮箱,也不包括
identity.json中其他被你标记为私密的信息。
它在第一次会话中的位置
这个简报位于智能体主导的引导流程的第三阶段,紧接在 identity.json 填好之后、任何目录站的浏览器操作之前,只需几分钟。如果你跳过它,让智能体临时去写简介,那么等你在 Product Hunt 的 maker 页面上搜索自己的产品时,才会发现自己被描述成了什么样。至于为什么 maker 资料值得在发布日之前而不是之后准备好,独立开发者发布清单里有更多说明。