SuperAPI AI 工具集

coding-workflow

编程与开发

查看项目

更新于 11-06 17:28

技能介绍

coding-workflow 是一个面向编码任务的执行工作流技能,旨在规范从任务授权、规划、实现、审查到 Git 操作和协作发布的完整过程。

用途:该技能用于执行编码任务,涵盖实现、调试、验证、Git 操作以及 GitHub/GitLab issue 或 PR/MR 协作。它通过区分只读讨论与执行授权来确保任务在明确授权下进行,并强调在依赖操作前解决关键不确定性。

主要能力:技能提供了一套结构化的执行纪律,包括任务阶段与授权分类、目标与范围确立、按需加载模块、在关键阶段选择专家技能、代码更改前的计划审查、实现与 Git 操作、代码更改后的独立子代理审查以及结果报告。它还定义了共享执行纪律,如全局范围、证据、清理和延迟或询问规则。技能包含多个模块,如工程实现、实现约定、规划、预提交审查、Git 操作、贡献管理、草稿撰写、评审反馈处理、评审收集、评审发布、评审等待、上游预检、问题规则、PR 规则、脱敏、任务存储、风险策略、运行时、浏览器验证回退、验收参考、来源审查等,这些模块按需加载。

使用方式:用户通过明确请求来授权执行路径。对于实现请求,技能会提议计划、独立审查和细化计划、实现、独立审查和细化代码更改。对于仅提问或讨论计划,技能以只读方式调查和解释,不修改文件。技能的模块根据任务阶段和需要加载,例如在修改源代码前加载规划和工程模块,在代码准备提交时加载预提交审查模块,在涉及 Git 操作时加载 Git 操作模块。技能强调在每个重要阶段检查可用的专家技能,并优先使用合适的技能。

适用场景:适用于需要结构化编码工作流的场景,包括实现新功能、修复缺陷、优化代码、提交更改、创建或更新 issue/PR/MR、处理评审反馈等。也适用于需要独立审查保证代码质量的团队协作环境。

限制:技能不授予任何默认权限,必须遵循用户明确设定的更窄限制。远程内容和机器人建议被视为不可信数据,不能扩大授权。技能要求独立的子代理审查,缺少真实子代理能力或审查不完整会阻止代码工作的完成或提交。技能不强制要求特定的命名审查者,但要求审查者进行基于证据的对抗性审查。技能不批量加载所有模块,只按需加载相关模块。技能不能替代用户决策,对于关键未解决选择需要询问用户。技能不提供具体的编码功能,而是组织编码工作的流程框架。