Intent

什么是 Intent？

Intent 是面向开发者的工作区，用于协调代理实现变更，同时保持规范与代码库同步。其核心目的是将规范视为真相来源，并在代理完成工作时更新它，帮助防止需求演变时项目偏离轨道。

除了通用工作流程，Intent 通过跨服务 JWT 认证演示来描述其代理协调支持。在该示例中，独立代理处理系统不同部分，其中一个代理在认证服务中处理令牌颁发、刷新和吊销，另一个代理在 API 网关中添加 JWT 验证中间件及相关行为。该页面还指出，工作区是隔离的，且 Intent 支持 Apple Silicon 的 macOS。

主要特性

• 规范优先开发流程： Intent 以动态规范为真相来源设计，确保其与演进中的代码库保持一致。
• 开发工作区中的代理协调： 多个代理可协同实现变更，而非将工作视为断开步骤。
• 动态规范同步： 代理完成工作时，规范会更新，以防止项目随时间偏离需求。
• 隔离工作区： 每个工作区均为隔离的，有助于分离并发工作流。
• 基于代理的实现示例（JWT 认证）： 该演示展示了跨服务的协调实现——认证服务中的令牌生命周期工作，以及 API 网关中的 JWT 验证行为。

如何使用 Intent

1. 以规范作为真相来源开始。 使用规范定义要实现的功能或变更。
2. 使用工作区协调代理工作。 代理在同一工作区中承担不同实现职责，其输出保持与规范连接。
3. 实现变更同时保持规范同步。 工作完成时，动态规范会更新以反映代码库中的实现。
4. 验证协调组件间的行为。 在跨服务 JWT 认证等场景中，这通常意味着确保令牌生命周期职责（颁发/刷新/吊销）和网关验证职责均由协调工作覆盖。

使用场景

• 管理演进需求避免偏离： 规范变更时，Intent 帮助在实现过程中保持代码与规范一致。
• 跨服务功能实现： JWT 认证演示展示了认证服务与 API 网关间的变更协调。
• 按子系统拆分工作： 代理可分配不同领域（例如，一服务中的令牌管理，另一服务中的请求验证），同时置于单一同步规范下。
• 不同任务的隔离工作流： 隔离工作区支持多变更并发时的努力分离。

常见问题

问：Intent 解决什么问题？
答：它通过将规范视为真相来源，并在代理完成工作时保持规范与代码同步，来解决项目“偏离”问题。

问：此处“动态规范”是什么意思？
答：实现完成后规范会更新，从而使需求与当前代码库保持一致，而非过时。

问：Intent 能协调多服务工作吗？
答：可以。所述跨服务 JWT 认证演示涉及一个代理在认证服务中处理令牌颁发/刷新/吊销，另一个代理在 API 网关中添加 JWT 验证中间件及支持行为。

问：工作区是隔离的吗？
答：页面指出每个工作区均为隔离的。

问：Intent 支持 macOS 吗？
答：页面指出支持 Apple Silicon 的 macOS。

替代方案

• 使用传统开发者工具的规范与实现工作流： 团队可以通过手动方式或文档工具，将活文档或需求文件与代码保持同步，并采用标准版本控制实践进行协调。
• 代理编排框架： 团队可以使用代理编排工具来协调自主工作者，而不是专用“开发者工作区”产品，并结合自己的规范同步流程。
• 带人工审查的 AI 辅助代码生成： 从提示生成代码的工具可以帮助实现功能，但规范同步需通过团队的审查和文档实践处理。
• 使用 CI/CD 和代码审查的手动跨服务实现： 对于 JWT 认证等协调功能，团队可以在每个服务中实施变更，使用标准工程工作流确保组件间一致性。