Proposal: move task-specific procedures out of AGENTS.md into `.claude/skills`
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 48/100
- Issue 类型
- 重构
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- markdown
调研方向
Read the current AGENTS.md and compare it with the fork's approach in bompus/codegraph#241; the issue notes that the fork's version will not apply as-is. Identify which procedures belong in .claude/skills and which rules must remain in AGENTS.md, then check that the skills are discoverable by harnesses that do not load them. Done means the current repository's instructions are reorganized without carrying over fork-only rules.
由索引模型根据 Issue 内容生成。
描述
AGENTS.md loads into every agent session. At 36 KB, most of it is procedure that only matters for one kind of task: cross-platform validation setup, the release flow, installer internals, changelog format. In the bompus/codegraph fork we moved those parts into repo skills and kept the root file for rules an agent can break without noticing. The root file went from 31,790 to 11,792 bytes (bompus/codegraph#241).
Each skill covers one kind of task:
codegraph-build-validation: build and test commands, test layout, cross-platform and Windows validation.codegraph-retrieval: the evidence behind the retrieval rules, explore budgets, dynamic-dispatch channels, the Excalidraw worked example.codegraph-installer:src/installer/internals, agent targets, the Cursor--pathquirk.codegraph-release: changelog format and the release flow.codegraph-issue-triage: checking a report against released, merged and in-progress state.
These stayed in the root file, since an agent that never opens the matching skill would break them silently:
- A short retrieval block. Recoverable conditions return success-shaped guidance instead of
isError, explore output never tells the agent to use Read, both explore budgets stay monotonic with file count, and partial dynamic-dispatch coverage is worse than none. - The Windows-gated test rule.
- Installer changes need
installer-targetstests and a changelog entry. - The README and docs sync rule.
- A Skills section with one line per skill, telling the agent to read the matching
SKILL.mdbefore that work. Codex reads AGENTS.md but not.claude/skills, so this list is how skills reach harnesses that don't load them.
The fork's version won't apply here as-is. Some of its kept rules are fork-only (its branch and release policy, its Rust kernel build), and your AGENTS.md has changed since we split ours. If the idea fits, I can open a PR against the current file, or you can take the parts you want.
- 主要语言
- C
- 星标
- 73.2k
- 派生
- 4.7k
- 平均合并
- 5 小时 51 分钟
- 30 天内合并 PR
- 627
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
colbymchenry/codegraph 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
colbymchenry/codegraph#1900 · 2 条评论 · 5 个 reaction ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
colbymchenry/codegraph#1700 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 70/100
colbymchenry/codegraph#1535 · 2 条评论 · 2 个 reaction ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 63/100
colbymchenry/codegraph#1403 ·
维护者通常 1 天内回复
-
agent-target
难度 2/5 1-3 小时 新手友好度 68/100
colbymchenry/codegraph#649 · 5 条评论 · 50 个 reaction ·
维护者通常 1 天内回复
查看 colbymchenry/codegraph 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
libsdl-org/SDL#16584 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 63/100
FriendsofECCE/ECCE#519 · 2 条评论 ·
-
难度 1/5 1 小时以内 新手友好度 95/100
containers/crun#2415 ·
维护者通常 1 天内回复