Proposal: add a pointer to chsrc-skill (Agent Skill) in the README
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 1/5
- Temps estimé
- Moins d'une heure
- Accessibilité débutants
- 22/100
- Type d'issue
- Documentation
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- c, debian
- Domaine
- documentation
Piste de recherche
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.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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.
- Langage dominant
- C
- Étoiles
- 6.9k
- Forks
- 285
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Préparer son environnement
Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de RubyMetric/chsrc
-
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
RubyMetric/chsrc#396 ·
-
Bug：Windows 下 Bun 换源功能异常Ouverte
Difficulté 4/5 3-5 jours Accessibilité débutants 48/100
RubyMetric/chsrc#399 ·
-
是否考虑新增自定义源增加别名Ouverte
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 20/100
RubyMetric/chsrc#398 ·
-
[arch] 多次 chsrc set arch 后 mirrorlist 累积旧 Server 行，upstream 官方源地址无效Peut-être à nouveau libre @yayoinoyume l’a pris il y a 37 jours, et aucune pull request n’est ouverte. OuverteLinux os_dish 源
RubyMetric/chsrc#393 · 2 commentaires · 2 réactions · 1 personne assignée ·
-
`ls` 命令呈现 "可用源" 的界面有改进空间Peut-être à nouveau libre @ccmywish l’a pris il y a 38 jours, et aucune pull request n’est ouverte. Ouverte改善加强
RubyMetric/chsrc#389 · 6 commentaires · 1 personne assignée ·
Toutes les issues de RubyMetric/chsrc
Issues similaires
-
UB: (int) cast of a user double outside int range in dispatch / vm_index_is_int / flat_index_atOuvertearea:runtime-vm
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
InauguralSystems/EigenScript#1748 ·
Les mainteneurs répondent en général sous 1 jour
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
wasm-micro-runtime/wasm-micro-runtime#5159 ·
Les mainteneurs répondent en général sous 7 jours
-
chore: update release scheduleOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 62/100
Les mainteneurs répondent en général sous 4 jours
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 Une demi-journée Accessibilité débutants 62/100
Les mainteneurs répondent en général sous 1 jour