菜单
Use when implementing a new sync provider adapter for doob — creating a new IssueTracker trait implementation, wiring config, and writing tests. Symptoms - "add GitHub Issues sync", "implement Linear adapter", "new sync provider".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | doob-new-provider |
| description | Use when implementing a new sync provider adapter for doob — creating a new IssueTracker trait implementation, wiring config, and writing tests. Symptoms - "add GitHub Issues sync", "implement Linear adapter", "new sync provider". |
All sync providers implement the IssueTracker trait in src/sync/domain.rs. Follow the BeadsAdapter (src/sync/adapters/beads.rs) as the canonical reference.
src/sync/adapters/<name>.rsIssueTracker trait — create_issue, is_available, provider_namesrc/sync/adapters/mod.rs~/.doob/sync_providers.toml schema doc#[async_trait]
pub trait IssueTracker: Send + Sync {
fn provider_name(&self) -> &str;
async fn is_available(&self) -> bool;
async fn create_issue(&self, todo: &SyncableTodo) -> Result<SyncRecord, SyncError>;
}
| Field | Type | Notes |
|---|---|---|
id | String | doob UUID |
title | String | todo content |
priority | u8 | 0–255 |
tags | Vec<String> | todo tags |
project | Option<String> | git-detected project |
due_date | Option<NaiveDate> |
pub struct BeadsAdapter;
impl BeadsAdapter {
fn map_priority(p: u8) -> u8 { p / 64 } // 0-255 → 0-4
}
#[async_trait]
impl IssueTracker for BeadsAdapter {
fn provider_name(&self) -> &str { "beads" }
async fn is_available(&self) -> bool {
Command::new("bd").arg("--version")
.output().await.map(|o| o.status.success()).unwrap_or(false)
}
async fn create_issue(&self, todo: &SyncableTodo) -> Result<SyncRecord, SyncError> {
let output = Command::new("bd")
.args(["create", &todo.title])
.output().await
.map_err(|_| SyncError::ProviderUnavailable("bd not found".into()))?;
// parse output for external ID
}
}
Unit — mock IssueTracker, verify SyncService calls it correctly
Service integration — real adapter, mock CLI (or env var gate)
CLI integration — requires actual CLI installed (#[ignore] or feature gate)
ProviderUnavailable | InvalidConfiguration | ExternalApiError | NetworkError | AuthenticationError | RateLimitError
Add entry to ~/.doob/sync_providers.toml:
[providers.<name>]
enabled = true
# provider-specific fields
| Mistake | Fix |
|---|---|
| Calling blocking CLI in async context | Use tokio::process::Command, not std::process::Command |
| Panicking on CLI parse failure | Return SyncError::ExternalApiError with context |
Skipping is_available check | SyncService calls it before create_issue — implement it |
Missing #[async_trait] | Trait has async methods — attribute is required |
Deep codebase analysis — architecture health, test coverage gaps, tech debt, and actionable findings
Run pre-commit checks (fmt, clippy, test) then stage, commit, and push with a conventional message
Review staged or recent changes for correctness, style, and Rust conventions before committing
Use when SSHing into remote machines, looking up credentials, renaming Tailscale devices, or accessing services on the tailnet. Symptoms - SSH auth failures, too many authentication failures, command not found tailscale, need to find credentials for remote machines.
Use when mixing Tokio async code with synchronous blocking I/O libraries (tar, flate2, zip, csv), or when seeing "cannot block the current thread from within the async context" panics, or needing to stream async bytes into a sync reader.
Structured BAML schema edit → validate → test loop for the devloop project. Use when editing any *.baml file in crates/baml/baml_src/ — covers version parity gotchas, uvx invocation, regeneration workflow, and the analyze verify step.