XTDB 仓库协作规约
XTDB 仓库的 issue、PR 与 2.x 看板该怎么开、怎么挂子任务、怎么认领卡片。
功能与用途
XTDB 仓库协作规约手册,用于规范 XTDB 项目中 GitHub Issue、PR、项目看板卡片与里程碑的管理。协助开发者在创建 Issue 或提交 PR 时判断任务归属与层级,执行里程碑准入双重测试,正确认领并更新卡片状态与工作流分类,避免错动关联项目或污染发布日志。适合参与 XTDB 核心开发与维护的工程师及开源贡献者。
适用场景
- 提交 PR 与任务归属判断:在提交代码时辨别是独立 PR 还是挂靠父级任务,规范子任务层级与看板卡片关联。
- 发布里程碑准入评估:对待发版本或 Bug 修复应用双重检验,确认是否直接面向最终用户并阻碍版本发布。
- 认领与更新看板卡片:在 2.x 看板接手任务时,查验关联项目认领情况并规范更新任务状态与 Stream 字段。
适用人群
- 开发者
- 技术团队
- 工程负责人
使用步骤
- 在开 issue/PR、加卡片、设里程碑或标签、认领卡片之前,先读这份规约。
- 判断任务是独立的还是某个上级 issue 的一部分,决定子任务父子挂法。
- 在认定某个 issue 无人跟踪前,先用接口查询它已被哪些项目认领。
- 命中其他项目即视为已跟踪,不要重复加卡片。
- 按 RFC 2119 解释文档中的 MUST/SHOULD/MAY 等强度词。
- 注意 2.x 里程碑名称固定为 2-NEXT,但编号与 ID 会随发布变化。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-14
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
XTDB-specific conventions for issues, PRs and the 2.x project board — what goes on the board, sub-issue parenting, the two tests a milestone has to pass, what to read and which edits to make when picking up a card, the cached project and field IDs, and driving all of it through chalk. Read this before opening an issue or PR, adding a card, setting a milestone or label, or picking up a card in this repo.
使用前准备
- XTDB 仓库访问权限
- GitHub 接口调用能力(查询 issue 所属项目)
- 已了解 chalk 技能为通用能力、需自行传入 XTDB 特有上下文
依赖与权限
- 读取用户主动提供的内容