一旦产品负责人批准了 intent.md,Claude 就会接手并生成一份需求与设计规范。这一过程由组织针对品牌、安全、合规和用户体验(UX)制定的技能(在新标签页中打开)来指导。
产品负责人会审查该规范,但不会亲自编写它。此流程的目标是创建一份工程团队可以据以规划的规范,并标注出需要关注的问题领域。
前端工作是最清晰的例子。一旦 intent.md 被接受,产品负责人就会根据 intent.md 在 Claude Design(在新标签页中打开) 中制作设计原型,对原型进行迭代,然后将其导出给 Claude Code 进行构建。
有何变化
| 传统方式 | AI 原生方式 |
|---|---|
| 需求与设计是由不同团队分别运行的独立阶段。分析师将想法正式化为需求,然后设计师再将这些需求解析回设计。这种分离是出于问责制的考虑,但速度慢且存在信息损耗。 | 这两个阶段在单次提示会话中完成。Claude 接收 intent.md,并在组织技能的约束下生成一份需求与设计规范,同时标注出需要关注的问题领域。 |
入门指南
- 前提条件:编写一份
intent.md文件,并将品牌、安全、合规和用户体验(UX)政策编写为技能。 - 基础设施:一位拥有 Claude 访问权限的产品负责人。不需要工程技能。
如何执行
- 产品负责人打开一个可使用组织技能的会话,并附上
intent.md。 - 产品负责人的提示指向该意图,列出约束条件,并要求标注出需要关注的问题。起初手动运行它,然后将其固化为组织级别的斜杠命令。在此基础上,将
intent.md在意图主目录中被接受作为触发条件,由一个非交互式任务在合并时触发,加载组织的技能运行该流程,并将spec.md作为拉取请求提交(第 5 阶段:部署中的 CI/CD 方案涵盖了具体实现细节)。从那时起,产品负责人的首次参与就是审查。 - 同一位产品负责人会对照最初的想法审查该规范。该规范是否解决了所陈述的问题,
intent.md中的未决问题是否得到了解答或被延续下来? - 首先处理被标注的问题,因为这些正是分析师原本会上报的要点。在工程团队看到该规范之前,产品负责人会与相应的政策负责人一起解决每一个问题。
- 将
spec.md与intent.md一起提交。这对文件记录了最初的需求以及最终的决定。 - 产品负责人决定该规范与意图是否进入构建阶段,对于组织归类为较高风险的事项,会咨询技术负责人。这一决定始终由人类团队成员做出,而接受该规范正是启动第 3 阶段:构建中规划模式方案的动作。
实际效果
提示:
阅读附带的 intent.md,并生成一份需求与设计规范,用于将其集成到我们现有的代码库中。应用您可用的技能,使该方案符合我们的品牌指南、安全政策和用户体验标准。将该规范完整记录为 spec.md,以便交给工程团队。清楚地描述任何需要关注的问题,尤其是在您无法同时满足相互矛盾的政策时。
此示例背后的 intent.md 来自一家保险公司,该公司希望客户能够在其门户网站中查看理赔状态。在其中,claims-api 是该门户的后端,而 claims-core 是保存理赔信息的较旧内部系统。上述提示将其转化为以下 spec.md:
markdown
# Spec: claims status self-service
From: intent.md (J. Ortiz, claims operations). Status: ready for product owner review.
Skills applied: secure-api-review, brand-voice, portal-ux.
## Requirements
- R1. A signed-in customer sees status, next step and expected date for each open claim.
- R2. Status is one of four states: received, in review, approved, paid.
- R3. The response carries those three fields and nothing else.
- R4. What the customer sees is at most 60 seconds old.
## Design
- New endpoint GET /claims/{id}/status in claims-api, behind the gateway JWT.
- claims-api reads the claim from claims-core. The portal never calls claims-core.
- New StatusPanel on the portal claims page. It caches each answer for 60 seconds.
## How each constraint in the intent is met
| Constraint | Met by |
| :---- | :---- |
| No new PII in the portal session | R3. None of the three fields is tagged pii in the schema. |
| Existing authentication only | The gateway JWT. No new login, token or role. |
## Open questions from the intent
- Do third-party loss adjusters need access too? Not answered. Carried forward as concern 1.
## Areas of concern
1. Loss adjusters have no portal account. Giving them access breaks "existing
authentication only", so they are left out of this spec. Owner: security.
2. The portal-ux skill says every status shows a date. The brand-voice skill says
never to state a payment date as a commitment. I cannot satisfy both as written.
Proposed label: "Estimated date". Owner: compliance.
3. claims-core allows 50 requests a second. The 60-second cache should keep the
portal under that, but nobody has load tested it. Owner: claims-core team.需求被编号,以便规划和审查可以引用它们。问题 2 使两项技能相互冲突,这正是提示要求 Claude 标注出来的那种冲突。
治理考量
政策冲突不再是在数周后的审查中才被发现,而是在编写规范的同时就读取并应用实时政策。组织的技能被作为规范的约束条件加以应用。该规范、生成它的提示以及当时生效的技能版本都会被记录在版本控制中。产品负责人对该规范签字确认,并将被标注的问题转交给指定的政策负责人。
如何衡量
- 领先指标:同一变更中
intent.md提交与spec.md提交之间经过的时间(两个 Git 时间戳),与旧的需求加设计周期进行比较。 - 滞后指标:构建开始后的需求返工。统计同一变更中,日期晚于首次
plan.md提交的spec.md提交数量。Git 日志可以直接给出这一数据。