larksuite / larksuite/cli

Skills 全局注入 27 个 skill 挤占 agent 上下文空间,建议改为渐进式披露

Open
#1,848 6 comments 12 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

domain/core
Dominant language
Go
Stars
17.3k
Forks
1.4k
Avg merge
2d 4h
Merged PRs (30d)
105

Description

现状

lark-cli 目前提供 27 个独立 skill(lark-cli skills list)。通过 npx skills add larksuite/cli -g -y 安装时,全部 27 个 skill 会注入到 agent 的 system prompt 中。

问题

在 bridge /agent harness 环境下,27 个 skill 的 description 和路由逻辑会显著挤占 token 预算。典型场景下,用户可能只用到其中的 3-5 个域(如 calendar、im、doc),但全部 27 个 skill 的描述都占用了上下文空间,影响 agent 对非 lark 域任务的响应质量。

现有缓解措施

-s 参数支持按需安装:
npx skills add larksuite/cli -s lark-calendar -y npx skills add larksuite/cli -s lark-im -y
但这对新用户不友好 —— 需要提前知道有哪些 skill、各自覆盖什么域。

建议方案

渐进式披露:合并为 1 个 meta skill + 内部子命令分发。

  • 对外只暴露 1 个 lark-cli skill(约 200-300 token 的描述)

  • 该 skill 内部维护 27 个子域的路由表

  • Agent 在运行时根据需要调用对应子域,而非一次性加载全部 27 个 skill 的完整描述

这样既保留了按域分发的灵活性,又大幅减少了 system prompt 的固定开销。

Contributor guide

No contributing guide indexed for this repository

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.

Research direction

Start by running lark-cli skills list and reviewing how npx skills add larksuite/cli -g -y exposes all 27 skills, then trace the skill installation and routing flow. Done means a single externally exposed lark-cli skill can route to the needed subdomain without loading every skill description into the agent system prompt.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.