Editing a symlinked SKILL.md never refreshes its imported shelf entry
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 52/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- go
- 领域
- cli, documentation, testing
调研方向
Read #1410 alongside internal/skills/skills.go:277 and internal/resident/skills.go:226, then trace ReconcileImportedSkills at :715. Add the linked-file case to an internal/resident test and run the relevant tests. Done means the chosen safe policy is consistent for reading and digesting, nonregular targets cannot block discovery, use-skill.md is aligned, and invalidates records the behavior.
由索引模型根据 Issue 内容生成。
描述
Found on santos/dev2 at 008363c98 (#1410). It reaches dev when #1410 merges.
What happened
A skill folder containing a SKILL.md symlink to a regular file loads through the link. Its import digest omits that link, so changing the target leaves the active shelf fact unchanged at the next launch. The manual says an edited SKILL.md is read again. Linked folders are already handled at this head and are outside this issue.
Replication
Deterministic (no model). In an internal/resident test, create a valid skill file outside a skill folder, link the folder's SKILL.md to it, call ReconcileImportedSkills, edit the target text, and call reconciliation again. Compare the active fact's digest and description. Today they remain the first version. A regular-file control refreshes.
Field (real models). On a fresh home, attach that skill in codeaf chat, edit its target, relaunch, and ask a question that distinguishes the two bodies. Allow OPENROUTER_API_KEY, deepseek/deepseek-v4-flash, about a minute and a small charge.
Where
internal/skills/skills.go:277, readSkillFile, follows the link. internal/resident/skills.go:226, contentDigest, skips its nonregular directory entry; ReconcileImportedSkills compares that digest at :715. The contrary manual promise is in internal/manual/chat/use-skill.md.
The fix
Choose one link policy together with the launch-hang fix being made on #1410 (a committed SKILL.md or .claude/settings.json that links to /dev/tty or a FIFO blocks launch): either safely follow regular targets in both reading and digesting, or reject linked files in both. This issue covers the digest half of that policy.
Acceptance
- e2e: relaunching
codeaf chatafter a target edit uses the new skill body, or consistently reports that the linked file is unsupported. - Unit: a linked file and a regular file follow the same chosen policy, while a link to a nonregular target cannot block discovery.
- Align
use-skill.mdand record the changed behavior ininvalidates.
- 主要语言
- Go
- 星标
- 115
- 派生
- 14
- 平均合并
- 9 小时 38 分钟
- 30 天内合并 PR
- 749
环境准备
我们还没有检查这个项目的环境配置文件。先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
Agent-Field/CodeAF 的其他 Issue
-
area:chat feature
难度 2/5 1-3 小时 新手友好度 88/100
Agent-Field/CodeAF#1510 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
Agent-Field/CodeAF#1489 ·
维护者通常 1 天内回复
-
area:chat bug good first issue sev:papercut
难度 2/5 1-3 小时 新手友好度 78/100
Agent-Field/CodeAF#1470 ·
维护者通常 1 天内回复
-
area:chat bug good first issue sev:papercut
难度 2/5 1-3 小时 新手友好度 85/100
Agent-Field/CodeAF#1469 ·
维护者通常 1 天内回复
-
area:chat bug sev:papercut
难度 2/5 1-3 小时 新手友好度 88/100
Agent-Field/CodeAF#1468 ·
维护者通常 1 天内回复
查看 Agent-Field/CodeAF 的全部 Issue
相似的 Issue
-
bug needs triage
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
bug P2 reliability
难度 2/5 1-3 小时 新手友好度 88/100
afreidah/s3-orchestrator#1564 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 84/100
blinklabs-io/gouroboros#2577 ·
维护者通常 1 天内回复
-
agentic-workflows
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复