研发协作
维护 k6 文档/发布说明/TypeScript…
适用于在 k6 相关仓库中编写或审查用户文档、发布说明、API 参考和 TypeScript 类型定义,并确保代码示例能在 k6@master 上运行。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
维护 k6 文档/发布说明/TypeSc特定
解决思路
- 在 k6-DefinitelyTyped(TypeScript 类型)、k6-docs(用户文档)、k6(发布说明/变更日志)三个仓库中记录或审查 k6 功能。
- 按用户意图选择工作流:写文档时遵循 `references/workflows/write.md`;审查文档时遵循 `references/workflows/review.md`。
- 查阅 `references/repository-structure.md`,用于了解仓库结构和功能类型识别。
- 查阅 `references/typescript-patterns.md`,用于了解 TypeScript 模式和故障排除。
- 查阅 `references/testing-workflow.md`,用于了解使用并行子代理的测试工作流。
- 查阅 `references/agent-browser-reference.md`,用于了解 agent-browser 命令参考。
- 查阅 `references/troubleshooting.md`,用于故障排除。
- 绝不自动 push,始终先询问。
- 绝不使用 `&&` 或 `;` 串联命令,每个命令单独运行,以防止失败。
- 只记录面向用户的功能,不记录内部实现。
- 每个编号列表项都使用 `1.`,而不是 `1.`、`2.`、`3.`。
- 提交前针对 `k6@master` 测试每个代码示例。
- 提交中不要包含 `Co-Authored-By: Claude` 或 AI 署名。
- 提交前始终验证示例:k6 文档和发布说明中的每个代码示例都必须能在 `k6@master` 上干净执行。
- 验证最小循环第 1 步:cd 到 k6 仓库,不是 k6-docs 或 k6-DefinitelyTyped:`cd ~/path/to/k6`。
- 验证最小循环第 2 步:确保位于最新提交的 `master`,因为契约是 `k6@master`:运行 `git checkout master`。
- 验证最小循环第 2 步继续:运行 `git pull`。
- 验证最小循环第 3 步:将每个示例作为单独命令运行,不要使用 `&&`:`go run . run /path/to/script.js`。
- 如果运行失败:阅读错误,修复源(文档或发布说明)中的示例,然后重新运行。
- 不要提交示例无法在当前 `master` 上干净运行的更改。
- 完整的多示例工作流与并行子代理,参见 `references/testing-workflow.md`。
适用边界 · 注意事项
- 任务与 k6 无关,或不在 k6、k6-docs、k6-DefinitelyTyped 仓库中。
- 没有 k6 源码仓库、Go 环境或无法针对 k6@master 验证示例。
- 需要记录内部实现细节,而非用户可见功能。