Proposal: add a pointer to chsrc-skill (Agent Skill) in the README
还没有人认领这个 Issue。
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 22/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- c, debian
调研方向
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.
由索引模型根据 Issue 内容生成。
描述
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.
- 主要语言
- C
- 星标
- 6.9k
- 派生
- 285
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
RubyMetric/chsrc 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 82/100
RubyMetric/chsrc#396 ·
-
是否考虑新增自定义源增加别名未关闭
难度 5/5 一周以上 新手友好度 20/100
RubyMetric/chsrc#398 ·
-
[arch] 多次 chsrc set arch 后 mirrorlist 累积旧 Server 行，upstream 官方源地址无效可能重新可做 @yayoinoyume 于 33 天前认领，目前没有进行中的 PR。 未关闭Linux os_dish 源
RubyMetric/chsrc#393 · 2 条评论 · 2 个 reaction · 已指派 1 人 ·
-
`ls` 命令呈现 "可用源" 的界面有改进空间可能重新可做 @ccmywish 于 35 天前认领，目前没有进行中的 PR。 未关闭改善加强
RubyMetric/chsrc#389 · 6 条评论 · 已指派 1 人 ·
-
对 `Omarchy`（基于 Arch Linux 的发行版）的支持可能重新可做 @yayoinoyume 于 35 天前认领，目前没有进行中的 PR。 未关闭Linux os_dish
RubyMetric/chsrc#387 · 8 条评论 · 1 个 reaction · 已指派 1 人 ·
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 72/100
UNIVERSE-HPC/course-material#283 ·
-
bug C/C++ code
难度 1/5 1 小时以内 新手友好度 78/100
webarkit/WebARKitLib#85 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 75/100
-
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 72/100