docs: rebalance prose cleanup and add trimming skill

2026-07-13 23:27:00 +08:00
parent fcdc318dda
commit 148046b9c8
392 changed files with 2801 additions and 1754 deletions
@@ -66,8 +66,8 @@ export function apply(ctx: Context, config: Config = {}): void {
    throw new Error('dsh-tool-skill: registered skill tool is not visible in the global registry')
  }

-  // Register after the tool so reverse-order fiber teardown removes this guidance listener
-  // before its referenced tool.
+  // Register after the tool so reverse teardown removes guidance first. Exact definition
+  // identity prevents a scoped shadow merely named `skill` from inheriting this catalog.
  ctx.on('agent/session-prefix', async (agent, _prefix, signal, next): Promise<Message[]> => {
    if (ctx.tools.get(skillTool.name, agent) !== registeredSkillTool) return await next()
    const skills = await ctx.skills.list({ cwd: agent.session.header.cwd, signal })