Proposal: add a pointer to chsrc-skill (Agent Skill) in the README
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 1/5
- Tempo stimato
- Meno di un'ora
- Idoneità per principianti
- 22/100
- Tipo di issue
- Documentazione
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- c, debian
- Ambito
- documentation
Direzione di ricerca
This is a proposal to add a one-line pointer to a third-party Agent Skill, so the first step is the maintainer's decision, not an edit. Look at the README and the doc/ directory to see where third-party tooling is currently listed. Done means the maintainer has explicitly chosen the README or doc/ location, or declined. The apt dry-run bypass is a separate issue, #396, and is out of scope here.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Summary
I built chsrc-skill, an Agent Skill that teaches an LLM how to use chsrc correctly, and I'd like to propose including a pointer to it in the README.
Repository: https://github.com/Swcmb/chsrc-skill
What it is
SKILL.md plus 10 reference documents, all fact-checked against the chsrc v0.2.7.2 source. It contains no chsrc source code.
The premise: using chsrc correctly requires knowing details that are easy for a model to get wrong.
Behaviors that are easy to get wrong
Measured while building this (35 scenarios, 135 assertions):
| Behavior | What happens if you do not know it |
|---|---|
| CLI options must precede the dish name | chsrc get pip -no-color → "暂不支持的换源菜品", exit code 2 |
-scope accepts both -scope=system and -scope system |
the = form silently fails on some shells |
-local is deprecated |
prints a deprecation warning; use -scope=project |
71 dishes, grouped pl_ / os_ / wr_; combo dishes operate per sub-dish |
py_group looks like a single target |
chsrc ls lists mirror sites, chsrc list <dish> lists one dish |
they read as interchangeable |
| Old chsrc versions print the config instead of writing it | the correct first move is to upgrade chsrc, not to hand-edit |
On Windows the home directory is USERPROFILE, not HOME |
setting HOME as isolation has no effect |
With no -scope, the dish decides |
-scope=user on an apt dish is rejected with exit code 4 |
Evaluation
Two configurations, same 35 prompts:
| Configuration | Assertions passed |
|---|---|
| With the skill | 135/135 (100%) |
| Without the skill | 108/134 (80.6%) |
The prompt set covers trigger positives and negatives, six platform-detection scenarios, the bootstrap deadlock, scope safety, container boundaries, and rollback.
A finding along the way
Building this surfaced a dry-run bypass in the apt recipe, already reported separately: #396.
ensure_debian_or_ubuntu_old_sourcelist() writes /etc/apt/sources.list with a raw fopen, bypassing the in_dry_run_mode() guard in chsrc_overwrite_file(). On a Debian-family system without that file, chsrc set -dry debian writes to disk. The sibling DEB822 branch goes through chsrc_run() and honors -dry; only the legacy path does not.
Proposal
A one-line addition to the README pointing at the skill, for anyone driving chsrc through an LLM. I am happy to adjust the wording, the location, or the format.
If you would prefer not to list third-party tooling in the README, an alternative would be a line in doc/ instead. Either way I would rather have your explicit call than assume.
Note on scope
This repository contains only the Skill. It does not track your releases, does not vendor your source, and carries no code from the project.
- Lingua principale
- C
- Stelle
- 6.9k
- Fork
- 285
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di RubyMetric/chsrc
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
RubyMetric/chsrc#396 ·
-
[arch] 多次 chsrc set arch 后 mirrorlist 累积旧 Server 行，upstream 官方源地址无效Forse di nuovo libera @yayoinoyume l’ha presa 33 giorni fa e non c’è nessuna pull request aperta. ApertaLinux os_dish 源
RubyMetric/chsrc#393 · 2 commenti · 2 reazioni · 1 assegnatario ·
-
`ls` 命令呈现 "可用源" 的界面有改进空间Forse di nuovo libera @ccmywish l’ha presa 35 giorni fa e non c’è nessuna pull request aperta. Aperta改善加强
RubyMetric/chsrc#389 · 6 commenti · 1 assegnatario ·
-
对 `Omarchy`（基于 Arch Linux 的发行版）的支持Forse di nuovo libera @yayoinoyume l’ha presa 35 giorni fa e non c’è nessuna pull request aperta. ApertaLinux os_dish
RubyMetric/chsrc#387 · 8 commenti · 1 reazione · 1 assegnatario ·
-
`curl` 测速 段错误 (核心已转储)Aperta
Difficoltà 3/5 1-2 giorni Idoneità per principianti 48/100
RubyMetric/chsrc#386 · 6 commenti ·
Tutte le issue di RubyMetric/chsrc
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
I maintainer di solito rispondono entro 1 giorno
-
severity: low
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
luainkernel/lunatik#1853 ·
I maintainer di solito rispondono entro 1 giorno
-
encoding.binary: bounds check guard is compiled away, so decode functions read past the sliceAperta
Difficoltà 2/5 Mezza giornata Idoneità per principianti 70/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
resetes12/pokeemerald#204 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
I maintainer di solito rispondono entro 6 giorni