Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

isolated 套件：lark-skill-maker/GUIDE.md 的前置链接被 guideRewrite 换成不存在的路径

Open Beginner friendly
  • Is something wrong?
#2,797 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
go, json, markdown
Domain
documentation

Research direction

Read skill-template/lark-suite-config.json and inspect the guideRewrite path override for lark-skill-maker; the issue identifies the incorrect replacement and the intended relative path. Check the generated isolated suite’s references/lark-skill-maker/GUIDE.md link against the sibling references/lark-shared/GUIDE.md. Done when the generated link resolves; consider adding the suggested assertion in internal/skillscheck/template_contract_test.go.

Written by the indexing model from the issue text.

Description

domain/core domain/doc enhancement

环境与产物

  • lark-cli 1.0.97
  • 套件产物：https://open.feishu.cn/lark-cli/skills/isolated/.well-known/agent-skills/lark-suite.tar.gz
  • sha256: f473572aa88486d144fe4ead4eac2a21177bc429e85158ab5057c20f362bba1e
  • 作者仓库：larksuite/cli @ 7beffb0

现象

安装后的套件里，references/lark-skill-maker/GUIDE.md 第 60 行：

前置条件： 先阅读 ../lark-suite/references/lark-shared/GUIDE.md。

从该文件所在目录 references/lark-skill-maker/ 解析，目标落在 references/lark-suite/references/lark-shared/GUIDE.md，该路径不存在。

对照组

其余 27 个 GUIDE 引用同一份共享指南时都写作 ../lark-shared/GUIDE.md，可正常解析。

复现

curl -fsSL -o /tmp/lark-suite.tar.gz \
  https://open.feishu.cn/lark-cli/skills/isolated/.well-known/agent-skills/lark-suite.tar.gz
tar -xzf /tmp/lark-suite.tar.gz -C /tmp/suite
grep -n "lark-suite/references/lark-shared" /tmp/suite/references/lark-skill-maker/GUIDE.md

不需要切 --skills-layout suite，因此不会改动本地已安装的 skills。

根因

skill-template/lark-suite-config.json：

"guideRewrite": {
  "pathOverrides": [
    {
      "skill": "lark-skill-maker",
      "match": "../lark-shared/SKILL.md",
      "replacement": "../lark-suite/references/lark-shared/GUIDE.md"
    }
  ]
}

crop 前的原文是 skills/lark-skill-maker/SKILL.md:60 的 ../lark-shared/SKILL.md，即同级 skill 目录的相对写法。
替换值里多带了一段 lark-suite/references/，等于假设了一个不存在的目录层级。

建议的正确值

"replacement": "../lark-shared/GUIDE.md"

与其余 27 个 GUIDE 的写法保持一致。

影响

lark-skill-maker 是教人和 agent 写自定义 skill 的入口，第 60 行位于它给出的 GUIDE 示例模板里。
路径错了会随示例被复制进新写的 skill，形成连锁的坏引用。该行在代码块内，常规文档体检不会报出来。

补充建议

internal/skillscheck/template_contract_test.go 已经在校验 suite 模板的占位符与命名，可以再加一条：
crop 后 references/*/GUIDE.md 里的相对 markdown 链接必须能解析，至少对 ../lark-shared/GUIDE.md 这个已知目标断言一次。

备注

仓库内只有这份配置声明了 guideRewrite，未见消费它的代码；crop 结果通过 isolated 通道产物体现，所以本 issue 以产物为准。

Dominant language
Go
Stars
17.5k
Forks
1.4k
Avg merge
1d 12h
Merged PRs (30d)
31

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from larksuite/cli

All issues in larksuite/cli

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.