Agent Skills
› growilabs/growi
growilabs/growi
GitHub扫描 CI 运行记录，识别非确定性（Flaky）测试失败并自动创建 GitHub Issue 进行追踪。仅检测不修改代码，状态持久化于 Issue 中，支持按时间窗口和阈值配置。
安装全部 Skills
npx skills add growilabs/growi --all -g -y
集合内 Skills (31)
扫描 CI 运行记录，识别非确定性（Flaky）测试失败并自动创建 GitHub Issue 进行追踪。仅检测不修改代码，状态持久化于 Issue 中，支持按时间窗口和阈值配置。
需要自动发现 CI 中的不稳定测试时
定时任务触发 Flaky 测试巡检时
npx skills add growilabs/growi --skill detect-flaky-ci -g -y
指导编写基于可观察行为契约的测试，避免实现细节耦合。通过边界断言和决策框架，确保测试能捕获真实回归并支持重构，适用于异步、节流等场景。
编写单元测试时
审查现有测试代码时
npx skills add growilabs/growi --skill essential-test-design -g -y
提供GROWI项目基于Vitest的测试规范，涵盖文件放置、类型划分及全局API。重点介绍使用vitest-mock-extended实现类型安全的Mock，确保单元测试和组件测试的质量与一致性。
编写或审查前端测试代码
需要创建TypeScript类型的Mock对象
配置Vitest测试环境
npx skills add growilabs/growi --skill essential-test-patterns -g -y
用于调查由CI检测到的不稳定测试问题，复现非确定性行为，定位根因并分类为测试修复、产品修复或隔离，最终生成PR。
收到flaky/confirmed或flaky/suspected标签的GitHub Issue
/investigate-flaky-test命令调用
npx skills add growilabs/growi --skill investigate-flaky-test -g -y
用于实施受阻或验证失败时的根因调查技能，通过收集证据、检查运行时状态及搜索文档来定位问题根源，而非盲目猜测修复方案。
实施者报告阻塞
修复后重复被拒
验证意外失败
同一故障多次修复无效
npx skills add growilabs/growi --skill kiro-debug -g -y
用于新项目启动或任务拆解的入口技能。通过轻量扫描项目元数据，判断需求归属并确定执行路径（如复用现有规范、新建规范或无需规范），澄清用户意图以输出可操作下一步。
用户提出新功能开发需求
需要对复杂任务进行工作分解
初始化新项目或进入新阶段
npx skills add growilabs/growi --skill kiro-discovery -g -y
kiro-impl技能用于基于TDD规范自主或手动执行开发任务。通过并行获取上下文、验证审批并确定验证命令，分发子代理进行编码与独立审查，确保代码符合设计且无回归。
需要按照已批准的任务列表实现新功能
要求使用TDD方法编写代码并进行自动测试
npx skills add growilabs/growi --skill kiro-impl -g -y
执行任务级对抗性审查，验证实现是否真实、完整且符合规范边界。通过运行测试、检查占位符和密钥、对比代码变更与任务范围等机械验证手段，确保交付物未越界并附带充分证据，最终给出批准或拒绝结论。
实现者报告任务就绪准备审查时
修复被拒问题后重新审查时
标记任务完成前
接受任务进入功能验证前
npx skills add growilabs/growi --skill kiro-review -g -y
根据roadmap.md批量生成特性完整规格说明，按依赖关系分组为并行子代理执行，确保跨规格一致性与依赖顺序。
需要批量创建或更新多个特性的规格文件
roadmap中存在多个待处理的特性且存在依赖关系
npx skills add growilabs/growi --skill kiro-spec-batch -g -y
实施后清理规范文档，移除代码测试等实现细节，保留设计决策与验收标准，确保文档作为未来重构的参考起点。
实现完成后的规范文档维护
准备进行功能重构时
npx skills add growilabs/growi --skill kiro-spec-cleanup -g -y
将需求转化为技术架构设计，通过上下文收集与分类发现流程，完成组件映射、接口定义及边界划分。支持并行子代理研究，确保设计符合规范并包含可视化图表，指导后续任务生成。
需要将业务需求转化为技术架构设计
创建新功能或扩展现有系统的技术方案
需要明确系统组件边界和接口定义
npx skills add growilabs/growi --skill kiro-spec-design -g -y
根据项目描述或发现简报初始化功能规范结构，生成唯一特性名称并创建 spec.json 和 requirements.md 文件。
需要新建功能规格说明时
从需求文档生成结构化规范时
npx skills add growilabs/growi --skill kiro-spec-init -g -y
支持自动与交互模式，顺序执行初始化、需求、设计、任务四个阶段生成规格说明，并在完成后进行轻量级自检。
用户输入功能描述并请求生成规格说明
使用--auto参数触发全自动规格生成流程
npx skills add growilabs/growi --skill kiro-spec-quick -g -y
根据项目描述和上下文生成符合EARS格式的规范需求文档。通过收集元数据、研究指南及并行调研，明确功能边界与验收标准，产出核心功能需求而不涉及实现细节。
需要生成项目需求文档
基于项目描述创建EARS格式的需求
npx skills add growilabs/growi --skill kiro-spec-requirements -g -y
根据需求和设计文档生成可执行的实施任务列表，确保任务粒度合理、依赖清晰并支持并行分析。
需要基于需求生成具体开发任务
创建功能实现的行动计划
npx skills add growilabs/growi --skill kiro-spec-tasks -g -y
用于为特定领域创建自定义指导文档，涵盖API、测试、安全等模板。通过并行研究分析代码库模式，生成结构化的领域规范文件。
需要制定特定领域的开发规范
创建API标准或测试指南
定义安全或数据库设计模式
npx skills add growilabs/growi --skill kiro-steering-custom -g -y
维护.kiro/steering目录作为持久化项目记忆，支持首次引导生成核心配置和后续同步代码变更。通过并行研究分析产品、技术和结构模式，检测代码漂移并提议更新，确保保留用户自定义内容。
初始化项目时生成核心引导文档
同步现有引导文档与代码库状态
npx skills add growilabs/growi --skill kiro-steering -g -y
用于在代码实现前对技术设计文档进行交互式质量审查，确保实施就绪。通过并行收集上下文、执行平衡评估并识别关键问题，最终给出明确的 GO/NO-GO 决策及可操作的改进建议。
需要评审技术方案或设计文档时
在编码前确认设计可行性和完整性时
npx skills add growilabs/growi --skill kiro-validate-design -g -y
分析需求与现有代码库的实现差距，评估集成挑战和多方案优劣，生成研究文档以指导后续设计与开发策略。
规划新功能集成
评估现有系统扩展能力
npx skills add growilabs/growi --skill kiro-validate-gap -g -y
用于在任务全部实现后验证特性级集成，检查跨任务一致性、完整测试套件及规格覆盖率，识别边界违规和集成问题。
所有子任务标记为已完成
执行特性级集成验证
检查跨组件数据流与接口匹配
npx skills add growilabs/growi --skill kiro-validate-impl -g -y
防止虚假完成声明，通过新鲜证据验证任务、修复、测试或功能的完成状态。在报告成功前强制检查退出码和覆盖率，确保证据与主张范围一致，避免过早判断。
验证任务是否真正完成
确认Bug修复有效
检查测试或构建是否通过
评估功能是否具备上线条件
npx skills add growilabs/growi --skill kiro-verify-completion -g -y
指导开发者将单个 Mongoose 模型文件迁移至 Prisma，遵循 GROWI 模式。通过分步交互并需人工确认，处理 Schema、方法签名兼容及 _id/__v 字段映射等细节。
需要将 Mongoose 模型迁移到 Prisma
调用 /mongoose-to-prisma 命令
npx skills add growilabs/growi --skill mongoose-to-prisma -g -y
定义GROWI主应用的全栈架构、目录结构与特性模块化规范，指导新代码开发及遗留代码迁移。
在 apps/app 目录下工作
询问应用架构或目录结构
需要创建新功能模块
npx skills add growilabs/growi --skill app-architecture -g -y
提供GROWI主应用apps/app的专用命令与脚本参考，涵盖质量检查、数据库迁移、OpenAPI生成及版本管理等开发辅助功能。
需要运行应用特定构建或测试命令时
执行数据库迁移或管理版本时
npx skills add growilabs/growi --skill app-commands -g -y
定义GROWI应用中Next.js、Jotai状态管理和SWR数据获取的代码规范与目录结构，并提供针对Next.js路由和Jotai的Vitest测试Mock模式。
在 apps/app 目录下进行开发
需要遵循 GROWI 应用特定的前端架构规范
编写涉及 Jotai 或 SWR 的组件代码
npx skills add growilabs/growi --skill app-specific-patterns -g -y
针对Next.js 16 Turbopack的构建优化指南，涵盖自定义Loader、解析别名及CSS兼容规范。
配置Turbopack
解决构建错误
优化前端构建性能
npx skills add growilabs/growi --skill build-optimization -g -y
检查 Next.js 客户端路由与 Express 服务端路由的一致性，防止 NextLink 误判路由归属。通过比对页面文件、Express 注册路径及配置列表，自动发现并报告路由漂移问题。
编辑 server/routes/index.js
编辑 src/utils/is-next-page-route.ts
新增 src/pages/** 下的页面文件
请求检查 NextLink 路由谓词是否过时
npx skills add growilabs/growi --skill next-express-route-consistency -g -y
解决Turbopack限制，通过Vite预编译将第三方CSS内联为JS模块，实现组件级按需加载，避免全局样式污染。
需要引入第三方库的CSS样式
在Turbopack环境下处理Vendor CSS
npx skills add growilabs/growi --skill vendor-styles-components -g -y
用于展示 Kiro 规范的状态与进度，分析各阶段完成度、识别阻塞点及依赖上下文，生成包含下一步行动和重新验证需求的清晰报告。
用户查询特定规范的当前状态或进度
需要检查规范文件的完整性或缺失项
查看多个规范的列表及其总体状态
npx skills add growilabs/growi --skill kiro-spec-status -g -y
评估GROWI建议路径的质量，对每个候选路径判定为可用、可优化或不可用。通过理解Wiki结构构建理想位置，提供基于合理性的评分而非唯一正确答案，辅助调试和优化路径建议算法。
evaluate suggest-path on this document
score / check / review these path suggestions
are these save paths usable
npx skills add growilabs/growi --skill suggest-path-evaluator -g -y
在合并旧版分支至ESM项目时，自动检测并转换遗留CJS代码，隔离需保留的CJS文件，驱动验证流程以完成迁移。
合并预ESM分支到主分支后
构建或Lint因遗留CJS代码失败时
npx skills add growilabs/growi --skill esm-merge-coverage -g -y
