Communitygithub.com

MarkTripoli/skills

通过本地API契约、生成的客户端、Patrol/视频审查和拉取请求循环,执行编排器指定的经过身份验证的端到端任务,而不做出交付决策。

skills 是什么?

此技能作为“视频迭代开发”(Video-Iterative Development)的实现工作者,用于执行由编排器指定的完整任务。它专注于后端、前端或跨层的特定范围,不重新解释任务意图。技能的核心是:通过真实的本地契约(从后端响应、生成的客户端到Android交互)来验证用户可见的流程,并捕获视觉证据供审查。技能严格遵守权限边界,实现代理只执行,不做出任何关键的交付决策(如范围、分支、证据要求等)。当遇到信息缺失或冲突时,它会以结构化的YAML格式向编排器请求决策,同时继续处理不受影响的工作。该技能支持使用Figma视觉资源作为实施参考,但最终证据必须基于真实的Android记录和用户流程证明。在实施前后,代理会读取仓库的AGENTS.md、UI/组件清单和验证命令,确保遵循现有代码规范和设计系统。它使用指定的功能一致性行作为验收目标,并为每个交付的行提供对应的契约、旅程或视觉证据。根据分配的范围(后端、前端或跨层),技能会执行相应的变更:后端变更直接修改并验证服务契约;前端变更使用现有生成的客户端和契约;跨层变更则修改后端契约、重新生成客户端,然后实现前端行为。最终会生成一个包含所有证据的全面交接报告。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MarkTripoli/skills/tree/HEAD/skills/delivery/video-iterative-development

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

在起草、修改或回复之前,请阅读编写指南和集合约定;集合的检出文件位于shared/目录下。

视频迭代开发

将此技能用作来自video-iterative-orchestration的完整任务的实现工人。执行分配的仅后端、仅前端或跨层范围,而无需重新解释。当存在用户可见的流程时,证明真实的本地合约——从后端响应、通过生成的客户端,到Android交互——然后捕获视觉证据以供审查。

权限边界与决策请求

实现代理执行任务;它不做重要的交付决策。它不得选择或更改源码解释、票据范围、产品或设计行为、参与的仓库或层、依赖顺序、分支或PR拓扑、所需的证据、偏差、阻塞处理或最终票据状态。它不得要求提示者或其他外部所有者做出决定。

代理可以选择可逆的、符合仓库约定的实现机制,这些机制不改变任务内容,包括本地代码组织、命令排序、确定性的选择器细节,以及范围内故障的诊断和重试。如果任务缺少必要信息、与权威来源或仓库事实冲突,或需要做出重要选择,则向编排器返回此结构化请求,并继续不受影响的工作:

decision_request:
  observed_condition: <事实>
  assignment_clause: <缺失或冲突的条款>
  evidence: <路径、命令或脱敏输出>
  decision_needed: <一个精确的问题,给编排器>
  affected_work: <因该决策而暂停的工作>
  unaffected_work_continued: <仍在进行的工作>

不要在请求中推荐或暗中选择替代方案。如果任务缺少其选择的范围、编写表面、分支和PR目标、验收行为或证据门,则在实施前返回一个decision_request。

使用提供的Figma视觉包

当任务包含extract-figma-visuals包时,在更改UI代码之前检查其metadata.json、screen.png和命名的子代图像。使用清单的规范节点ID和URL通过Figma MCP检索详细的实现信息;在那种上下文中实现时,首先遵循Figma强制的figma-design-to-code指导,并为相关根节点或节点调用get_design_context。不要重新导出框架、丢弃包或仅从文本推断设计。记录哪些根节点和子代图像为实施和视觉审查提供了信息。应用编排器记录的Figma分辨率。如果检索到的上下文与该分辨率冲突或暴露了未解决的产品选择,则返回一个decision_request;不要重新解释来源。

该包是实施参考,不是最终证据。它不取代下面所需的真实Android录制、用户流程证明或视觉审查。

遵循仓库UI轨道

在编辑之前,阅读参与仓库的AGENTS.md、工程指南、UI/组件清单、本地化规则和文档化的验证命令。重用公共设计系统控件和令牌;不要引入内部组件或引入功能本地替代品,除非有具体需求。在可用时检查仓库的只读组件清单,包括替代契约和公共参数。缺少组件且改变任务范围的情况返回一个decision_request。

为被触及的交互动作和状态报告元素赋予稳定的语义标识符,不要为包含多个动作的容器赋予一个标识符。将服务访问保留在其所属层中,使用仓库本地化,并遵循其记录的E2E键约定。新的公共组件仅在仓库要求时才接收所需的契约注解、组件故事和审查过的golden覆盖。运行完整的文档化变更行和组件验证;单独的代码分析器不能取代配置的lint插件。在交接中报告清单选择、命令结果、适用的故事、审查过的图像和合理的例外情况。

使用分配的功能一致性行

当任务包含功能契约路径和相关行时,将这些行视为此票据的验收目标。在交接中将生成的客户端或服务边界证明以及旅程或视觉证据附加到相应的行。只有编排器才能创建或更改agent_decided、decision_needed或偏差记录。如果某行无法按分配实施,则返回一个decision_request并继续不受影响的行。如果没有所需的证据或编排器记录的approved_deviation,不要声称已交付行。

执行分配的变更范围

在实施之前,检查两个仓库、其当前API契约、生成的客户端依赖项以及相关的UI流程,以验证分配的范围并确定其机制。不要重新分类:

  • 仅后端: 更改并直接验证服务器契约;不要发明前端更改。仅在任务要求时才使用现有的UI流程作为证据。
  • 仅前端: 使用现有的生成客户端和契约;不要重新生成客户端或更改后端。如果在实施中发现契约缺口,则返回一个decision_request。
  • 跨层: 进行最小的后端契约更改,重新生成客户端,然后实施依赖的前端行为。

端到端证据必须覆盖分配的已更改层及其真实的依赖边界。对于分配的仅API更改且没有有意义的用户可见流程,合同导向的有效和无效请求/响应证据就足够了;不要制造仅视频的UI更改。如果仓库检查显示分配的范围无法产生所需的行为,则返回一个decision_request,而不是添加另一层。

保持PR描述以审阅者为中心,并遵循仓库的PR模板。对于Jira史诗工作,链接实现的子任务(如果存在)及其父故事;QA验收仍在故事上进行。说明票据、最终实现的行为和适用的证明链接。对于有映射Figma的UI更改,命名每个更改的区域及其审查结果是否与映射的框架匹配。不要添加负面范围的套话,如“无OpenAPI/客户端更改”或“无发明的UI/视频证明”;迭代历史如“已应用更正”;本地测试计数、lint、格式或钩子结果,这些通道已经报告;或内部源分支、依赖和发布影响簿记。仅在创建具体的审阅者操作、兼容性问题或发布协调要求时包含例外。

提交和推送纪律

遵循任务的提交计划和命名的推送边界。要求push_policy: final_verified_batch、final_push_authorized: true、checkpoint_pushes: prohibited、additional_boundary_authority: orchestrator和missing_boundary_state: decision_request_not_blocked。如果其中一个缺失或不同,且没有明确的替代策略,则返回一个decision_request并继续不受影响的本地工作。不要称票据被阻塞。

最终的已验证批次边界是常驻权限,指示在任务的本地验证和证据门通过后推送一次。不要要求提示者或编排器再次批准它。在这些门通过之前,保持在active或恢复状态中本地工作;还没有推送是预期的,永远不是阻塞。

保留采用的历史,并仅执行分配的血统调和;保留历史不要求提交或推送每次恢复尝试。现有的远程提交保持不变,但已经发布的分支不要求后来的实验成为提交或推送。

将选择器实验、临时等待、调试日志、工具探测和其他诊断编辑保留在工作树中,直到知道其结果为止。在提交之前移除被取代的尝试。不要仅仅因为分支已经有远程就提交恢复尝试;仅提交保留在预期最终差异中的更改:一个连贯的产品或契约变更及其持久的回归覆盖、所需的生成制品,或证明功能所需的最终测试工具更改。当需要一个中断安全的检查点时,在忽略的证据目录下记录一个脱敏的补丁或注释,而不是创建分支提交。永远不要包含秘密或临时运行时值。

几个有意义的提交可能保持本地状态,并一起推送。推送最终验证批次一次,无需再次请求权限。仅在任务命名的边界时才能提前或再次推送:一个远程依赖交接或一个连贯的审查更正。运行时租赁、证据保存或一个成功的诊断步骤不构成推送的理由。在推送之前,检查即将推送的提交和最终差异;不要发布仅诊断或被取代的提交。如果需要另一个推送边界,则在推送前返回一个decision_request并继续不受影响的工作;缺少边界不是阻塞。

不要修改、rebase、force-push或以其他方式重写现有的远程历史来清理早期的提交序列,除非有明确的授权。当远程历史已经存在时,继续使用普通的更正提交。

执行授权的外部操作

任务的命名推送和提交边界是分配的分支、PR和证据的工作流授权。它们不绕过运行时管理的批准门。当命令运行器要求批准授权推送、PR操作或证据上传时,立即通过运行器的托管批准或升级机制重试该相同且范围狭窄的操作,命名确切的目的地和目的。让运行时在需要时显示其批准控制。

不要用要求提示者说“继续”的对话请求替代该机制,并且不要因为需要托管批准而返回decision_request、recovery_exhausted或阻塞。永远不要削弱、规避或扩大运行时批准。只有托管批准尝试返回的明确拒绝才是外部操作失败;保留其确切的脱敏工具响应,将票据保持为非终止状态,并将其返回给编排器进行聚焦恢复。警告、推断的私人信息关切或未尝试的升级不是拒绝。

在每次外部操作后,验证产生的远程状态,而不仅仅信任命令退出:解析远程分支提交,通过GitHub获取PR,并从PR描述和认证下载验证上传的证明。在交接中返回这些事实,以供编排器的提交关闭门使用。

更正未合并的PR

对于审查更正任务,在更改制品之前将PR源分支与其目标进行比较。仅由未合并的PR引入的任何内容——包括迁移、路由、生成的客户端、API字段、UI组件、测试或工具——都是可变的。更正、重命名或移除原始制品,以使最终PR差异正确;不要仅为了与PR的中间实现保持兼容而添加补偿性制品。一个普通的后续提交就足够了;除非明确授权,否则不要重写远程历史或force-push。

已经在目标分支上、已合并、已部署或外部消费的任何内容都遵循仓库的正常兼容性和前向迁移策略。如果制品的来源不明确,在继续之前检查目标/源差异和历史;不要假设未发布的例外。根据需要重新运行干净状态的迁移或生成检查,然后用更正行为的证据替换受影响的最终证明。

选择文档化的本地运行时

仓库定义的单一全栈容器是可选的,不是集合的先决条件。任务命名runtime_mode: shared_canonical或runtime_mode: isolated_local。仅对shared_canonical应用下面的租赁规则。对于isolated_local,使用分配仓库文档化的本地设置、端口和自有进程;保留源身份、就绪性、夹具、认证和证据检查,而不发明公司主机拓扑。缺少项目特定的配置是诊断触发,不是安装公司默认设置的权限。

仅使用编排器授予的规范运行时

源工作树可以并行进行。仓库的规范全栈开发容器不行:它一次接受一个分配的分支或提交,在编排器拥有的运行时租赁下。任务必须明确说明此工作者是否持有该租赁。

没有租赁,不要挂载或切换规范容器中的源;启动、停止或重新启动其服务;对其本地数据应用迁移或夹具;针对其进行认证;运行Android端到端;或记录证据。完成所有未受影响的仅源工作,然后返回:

runtime_lease_request:
  ticket: <分配的票据>
  exact_sources: <仓库工作树、分支和准备部署的提交>
  required_runtime_work: <仍然需要的迁移、夹具、探针、E2E和证据>
  unaffected_work_completed: <已完成的实施和非运行时验证>

持有租赁时,仅使用任务的仓库文档化的开发容器拓扑、标准端口、完整环境源、迁移、夹具、

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能