add-source
GitHub指导集成新的Agent CLI源，涉及多crate代码修改、测试配置及站点清单更新。强调必须运行完整测试套件以捕获被--lib忽略的集成测试缺陷，确保新功能正确注册和显示。
Trigger Scenarios
Install
npx skills add pixtuoid/pixtuoid --skill add-source -g -y
SKILL.md
Frontmatter
{
"name": "add-source",
"version": "1.2.0",
"metadata": {
"scope": "pixtuoid repo only"
},
"description": "Wire a new agent-CLI Source adapter into pixtuoid (a new coding CLI whose sessions become office sprites). Use when the user says 'add support for <CLI>', 'add a source for <tool>', or 'integrate <agent CLI>'. Orchestrates the cross-crate checklist whose steps have TEST TEETH — the ones a diff-scoped edit silently misses (site manifest bridge, per-source badge hue, home-dir fn, plus the two `pixtuoid\/tests\/*` integration goldens that `-p <crate> --lib` never builds)."
}
add-source
Adding an agent CLI spans pixtuoid-core (decoder + registry + tests), the
pixtuoid binary (runtime wiring + install target + badge hue), and the site
manifest.
When to use
- "Add support for <CLI>" / "integrate
" / "add a source for X". - A new transcript-bearing OR hook-only coding CLI should show up as sprites.
The checklist
Follow docs/CONTRIBUTING.md
"Adding a new agent CLI" step by step; its test steps are in
crates/pixtuoid-core/tests/AGENTS.md.
The trap: --lib is not the suite
The sources --json golden (cli_json) and the wire_to_pixels matrix live in
pixtuoid/tests/*.rs INTEGRATION BINARIES that -p <crate> --lib never builds —
the #692 (kimi) miss: a green --lib run AND a multi-lens review both passed
while these two were red, caught only by the full suite. Run
just test (NOT just --lib) before declaring green.
Finish
just gen-contractonly if you touched the--json/SourceStatus/OutcomeRowSHAPE (adding a row doesn't).- local-review when arc step 7 calls for it; CI runs the tests.
Version History
- d03b337 Current 2026-10-19 00:32
- 84da613 2026-08-19 17:51
-
9efcf99
2026-08-13 16:35
修复了多个源对 CLI home 目录解析不准确的问题，改为镜像各 CLI 自身的解析逻辑，解决了 Windows 路径及环境变量处理中的静默失败 bug。
-
6fce833
2026-07-23 06:31
移除 add-source/SKILL.md 中指向已不存在步骤的过时交叉引用，保持文档准确性。
- 0620ccd 2026-07-05 20:27
