用途
本技能用于帮助首次贡献者向 SolidCraft 仓库(tangency-labs/solidcraft)提交代码或文档。它把仓库现有的贡献规则串联成一套可执行的流程,而不是替代 CONTRIBUTING.md、AGENTS.md、贡献者手册页面和技能索引中的现行规则。技能只处理仓库层面的贡献事务,不涉及通过 MCP 对零件进行建模。
主要能力
- 指导检查本地环境,包括 gh、git、Rust 工具链、磁盘空间、内存、CPU 与显示环境,并对照 CONTRIBUTING.md 中的最低 Rust 版本。
- 指导派生与克隆仓库,确认 origin 指向本人 fork、upstream 指向官方仓库,且绝不向 upstream 推送。
- 帮助挑选未被认领的问题:先完整拉取开放的 Issue 与 PR(含草稿),排除内核暂停相关工作,再结合 interests 与标签(help wanted、good first issue、needs-triage)选择任务。
- 指导用草稿 PR 认领任务:基于最新 origin/main 建分支、空提交 claim: #N、推送并创建草稿 PR;同一问题以编号最小的开放 PR 为准。
- 指导每 72 小时内有推送(避免草稿被接管)、每个 PR 只含一个主题和一个 Issue、不提交 plan/、target*/ 或生成的参考数据。
- 指导运行 cargo xtask ci、cargo clippy、cargo fmt 与针对性测试,并在修复缺陷时先证明测试失败、修复后通过。
- 指导采集可观察证据:对 CAD、UI 或模型行为使用截图或短视频,优先提供前后对比;无显示环境时用 solidcraft-cli snapshot 或 Xvfb。
- 指导完成 PR 标题与正文(Fixes #N、问题、结果行为、验证与证据),标记就绪并跟进审阅、CI 与合并队列状态。
使用方式
技能以对话式步骤推进:先解释正在检查什么及原因,运行环境检查命令;在每次公开操作(创建公开 fork、推送、创建或更新 PR、上传证据、标记就绪、评论)之前,展示拟提交的确切内容与目标并征得用户批准;随后按“派生与克隆 → 共同选题 → 草稿 PR 认领 → 做出并检查一处聚焦改动 → 展示结果 → 完成并回应审阅”的顺序执行。维护者添加 approved-for-ci 后才会启动重型 CI;贡献者不得自行添加该标签。合并通过合并队列进行(squash 自动合并),main 分支禁止强推。
适用场景
适合准备首次或早期为 SolidCraft 贡献代码、文档的开发者,尤其是需要弄清选题、认领和审阅流程的人。技能也覆盖共享构建机的负载检查、小环境下的针对性测试替代完整测试套件、以及云端沙箱无显示时的证据采集方式。
限制
技能中未提供 SolidCraft 的功能范围、收费信息、支持的平台或具体技术架构细节;内核相关工作当前处于暂停状态,应跳过。各类规则以 CONTRIBUTING.md 等现行文档为准,技能本身不编造仓库之外的规则。