@longzai-intelligence-agent-tools/core 0.0.12 → 0.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -164,53 +164,6 @@ type OptimizeSuggestion = {
164
164
  * 物化源目录(hub 侧)与目标目录(项目侧)由类别决定。
165
165
  */
166
166
  type SharedPromptsCategory = 'agents' | 'rules';
167
- /**
168
- * 单条订阅登记(hub 侧注册记录中该项目在本 hub 的一个命名空间订阅)
169
- */
170
- type SharedPromptsRegistrationSubscription = {
171
- /**
172
- * 订阅类别(决定 hub 条目库与项目物化目标目录)
173
- */
174
- readonly category: SharedPromptsCategory;
175
- /**
176
- * 物化命名空间(该类别项目侧物化基目录下的保留目录名,如
177
- * .lzi/agents/items/<ns>/ 或 .lzi/rules/<ns>/)
178
- */
179
- readonly namespace: string;
180
- /**
181
- * 订阅范围 glob 列表(相对 hub 侧该类别的条目库目录);null = 订阅全部
182
- */
183
- readonly include: readonly string[] | null;
184
- };
185
- /**
186
- * hub 侧项目注册记录(registry/projects/<项目名>.ts 模块形态)
187
- *
188
- * 形状与 hub 仓 registry/registration.types.ts 保持同步(双份维护由
189
- * CLI 侧 zod 运行时校验兜底;core 发布后 hub 侧可转发本类型收敛单一来源)。
190
- * v1 每项目仅支持订阅单一 hub,subscriptions 描述其全部命名空间订阅。
191
- */
192
- type SharedPromptsRegistration = {
193
- /**
194
- * 项目名(项目根目录名,如 longzai-intelligence-agent-tools)
195
- */
196
- readonly name: string;
197
- /**
198
- * 所在 monorepo 目录名(如 longzai-intelligence-m5-edition,纯信息性定位提示)
199
- */
200
- readonly monorepo: string;
201
- /**
202
- * 该项目在本 hub 的订阅列表
203
- */
204
- readonly subscriptions: readonly SharedPromptsRegistrationSubscription[];
205
- /**
206
- * 首次注册日期(YYYY-MM-DD,重复注册保持不变)
207
- */
208
- readonly registeredAt: string;
209
- /**
210
- * 最近一次注册/刷新时的 CLI 版本号
211
- */
212
- readonly toolVersion: string;
213
- };
214
167
  //#endregion
215
168
  //#region src/defaults.d.ts
216
169
  /**
@@ -220,19 +173,6 @@ type SharedPromptsRegistration = {
220
173
  */
221
174
  declare const DEFAULT_SOURCES: Readonly<Record<string, string>>;
222
175
  //#endregion
223
- //#region src/shared.templates.d.ts
224
- /**
225
- * 生成 hub 侧注册记录文件内容(registry/projects/<项目名>.ts)
226
- *
227
- * 类型引用指向 hub 仓自足类型文件(见 hub 仓 ADR 0002:hub 不依赖
228
- * 未发布的 agent-tools 类型,注册记录仍获得完整静态检查)。同目录导入
229
- * 不触发父目录相对导入规约。
230
- *
231
- * @param registration - 注册记录状态模型
232
- * @returns 完整 TS 模块源码(含 @generated 头与文件尾换行)
233
- */
234
- declare const buildSharedRegistrationFileContent: (registration: SharedPromptsRegistration) => string;
235
- //#endregion
236
176
  //#region src/optimizer.rules.d.ts
237
177
  /**
238
178
  * 优化阈值常量表
@@ -340,13 +280,6 @@ declare const COMMON_SOURCE: 'agents/agent.md';
340
280
  * items/ 缺失或无产出时,根指令合成行为与无条目机制时完全一致。
341
281
  */
342
282
  declare const AGENTS_ITEMS_SOURCE_DIR: 'agents/items';
343
- /**
344
- * 默认物化命名空间
345
- *
346
- * 共享条目默认物化到 .lzi/agents/items/shared/(项目 gitignore 的
347
- * 工具保留目录);多个 hub 订阅时各自使用不同命名空间避免冲突。
348
- */
349
- declare const SHARED_DEFAULT_NAMESPACE: 'shared';
350
283
  /**
351
284
  * 默认共享提示词中心仓名
352
285
  *
@@ -354,11 +287,32 @@ declare const SHARED_DEFAULT_NAMESPACE: 'shared';
354
287
  * hub 定位约定 fallback 为 <项目根>/../<hub 名>(m5-edition 内平铺布局)。
355
288
  */
356
289
  declare const DEFAULT_SHARED_PROMPTS_HUB_NAME: 'longzai-intelligence-agent-prompts';
290
+ /**
291
+ * 物化来源保留元信息键(0011 用户第四轮裁定)
292
+ *
293
+ * 物化副本在 frontmatter 注入 `hub: '<hub 名>'` 声明工具所有权:
294
+ * 携带本订阅 hub 标记的文件 = 工具所有(可重建/删除);标记文件不在
295
+ * 本次命中集 = 孤儿(sync 删除、check 上报 stale);命中路径已存在且
296
+ * 无标记 = 本地文件占位(碰撞 fail fast)。本地文件禁止使用该键。
297
+ * 分发产物一律剥离该键(IDE 只见内容语义 frontmatter)。
298
+ */
299
+ declare const HUB_META_KEY: 'hub';
300
+ /**
301
+ * rules 产物生成元信息键(0011 第六轮裁定)
302
+ *
303
+ * rules 产物(.trae/rules/<规则名>.md)在 frontmatter 携带 `lzi: true`
304
+ * 声明工具所有权:整文件工具管理(sync 整文件重写、--check 整文件
305
+ * 比对、孤儿按标记识别清理);正文纯 markdown,禁止注释符号污染。
306
+ * 无该键的既有文件 = 非工具产物,sync 接管时拒绝并引导迁真源。
307
+ * 仅适用于 rules 类别产物——根产物(AGENTS.md/CLAUDE.md)沿 0004
308
+ * 注释标记机制不变,不使用 frontmatter 元信息。
309
+ */
310
+ declare const PRODUCT_META_KEY: 'lzi';
357
311
  /**
358
312
  * hub 内条目库目录(相对 hub 根)
359
313
  *
360
314
  * 与项目侧 .lzi/agents/items/ 同构的共享条目真源目录,
361
- * 物化时按订阅 include/exclude 从此目录复制到项目命名空间目录。
315
+ * 物化时按订阅 include/exclude 从此目录复制到项目类别物化根。
362
316
  */
363
317
  declare const HUB_AGENTS_ITEMS_DIR: 'agents/items';
364
318
  /**
@@ -367,6 +321,9 @@ declare const HUB_AGENTS_ITEMS_DIR: 'agents/items';
367
321
  * 与项目侧 .lzi/rules/ 同构的共享规则真源目录。rules 类别项目侧无
368
322
  * items 层级(每个规则文件即独立单元,含 IDE schema frontmatter),
369
323
  * 故 hub 侧直接以 rules/ 为库根,不设 items 子层。
324
+ * **禁止平铺**(0011 用户第四轮裁定):库根只允许主题子目录,
325
+ * 出现平铺 .md 时 register/sync 机械报错;目录结构端到端保留
326
+ * (hub &lt;主题&gt;/ → .lzi/rules/&lt;主题&gt;/ → .trae/rules/&lt;主题&gt;/)。
370
327
  */
371
328
  declare const HUB_RULES_SOURCE_DIR: 'rules';
372
329
  /**
@@ -387,52 +344,17 @@ declare const SHARED_PROMPTS_CATEGORIES: readonly SharedPromptsCategory[];
387
344
  */
388
345
  declare const hubSharedSourceDir: (category: SharedPromptsCategory) => string;
389
346
  /**
390
- * 解析共享类别的项目侧物化命名空间目录(相对项目根,'/' 连接,无结尾斜杠)
347
+ * 解析共享类别的项目侧物化根目录(相对项目根,'/' 连接,无结尾斜杠)
391
348
  *
392
- * agents → .lzi/agents/items/&lt;ns&gt;(gitignore 受管块 + 物化目标 +
393
- * 占用守卫共用的规范路径);rules .lzi/rules/&lt;ns&gt;(类别分发
394
- * 管线自动扫入,产物为 .trae/rules/&lt;ns&gt;/&lt;base&gt;.md)。
395
- * .gitignore 目录忽略规则行由调用方追加结尾斜杠。
349
+ * agents → .lzi/agents/items;rules .lzi/rules(类别分发管线自动扫入,
350
+ * 产物为 .trae/rules/&lt;主题&gt;/&lt;base&gt;.md)。物化内容按 hub 主题目录
351
+ * 结构平铺并入(无命名空间包裹层);物化副本入库(0011 用户裁定):
352
+ * 随项目 git 提交,工具所有权由 frontmatter 保留元信息标记承载。
396
353
  *
397
354
  * @param category - 共享提示词类别
398
- * @param namespace - 物化命名空间
399
- * @returns 命名空间目录相对路径(无结尾斜杠)
400
- */
401
- declare const sharedNamespaceRelPath: (category: SharedPromptsCategory, namespace: string) => string;
402
- /**
403
- * hub 内注册记录目录(相对 hub 根)
404
- *
405
- * 每个已注册项目一个 <项目名>.ts 记录(机器生成),
406
- * 即共享条目变更的波及面清单。目录内另有自足类型文件
407
- * {@link HUB_REGISTRATION_TYPES_FILE}(非注册记录,扫描时排除)。
408
- */
409
- declare const HUB_REGISTRY_PROJECTS_DIR: 'registry/projects';
410
- /**
411
- * hub 注册记录目录内的自足类型文件名
412
- *
413
- * 与注册记录同目录放置:记录以同目录相对导入引用(`./registration.types.js`),
414
- * 不触发父目录相对导入规约;CLI 扫描注册记录时按本常量排除。
415
- */
416
- declare const HUB_REGISTRATION_TYPES_FILE: 'registration.types.ts';
417
- /**
418
- * 机器生成 TS 文件的头部标记
419
- *
420
- * 声明机器所有权:注册表/注册记录文件由 CLI 整文件再生成,禁止手工编辑。
421
- */
422
- declare const GENERATED_TS_HEADER: '// @generated by lzi-agent-cli shared(工具生成,请勿手改;变更请运行 shared register / shared unregister)';
423
- /**
424
- * 项目 .gitignore 受管块起始标记
425
- *
426
- * 共享命名空间的忽略规则包裹在受管块内,shared register / unregister
427
- * 幂等维护块内容,块外 .gitignore 内容永不触碰(按需添加,符合 ADR-0020)。
428
- */
429
- declare const GITIGNORE_SHARED_BEGIN: '# BEGIN Lzi Agent Tools Shared(工具维护,请勿手改)';
430
- /**
431
- * 项目 .gitignore 受管块结束标记
432
- *
433
- * 与 {@link GITIGNORE_SHARED_BEGIN} 成对使用,界定受管块尾部。
355
+ * @returns 类别物化根目录相对路径
434
356
  */
435
- declare const GITIGNORE_SHARED_END: '# END Lzi Agent Tools Shared';
357
+ declare const categoryMaterializeRoot: (category: SharedPromptsCategory) => string;
436
358
  /**
437
359
  * 各 IDE 的配置根目录名
438
360
  *
@@ -507,4 +429,4 @@ declare const AUTO_AGENT_KEYWORD: 'auto';
507
429
  */
508
430
  declare const detectAgentTypes: (projectRoot: string) => Promise<readonly AgentType[]>;
509
431
  //#endregion
510
- export { AGENTS_ITEMS_SOURCE_DIR, AUTO_AGENT_KEYWORD, type AgentItem, type AgentType, BUILTIN_PLACEHOLDERS, CATEGORY_RULES, COMMON_SOURCE, type Category, type CategoryRule, DEFAULT_SHARED_PROMPTS_HUB_NAME, DEFAULT_SOURCES, GENERATED_BLOCK_BEGIN, GENERATED_BLOCK_END, GENERATED_TS_HEADER, GITIGNORE_SHARED_BEGIN, GITIGNORE_SHARED_END, HUB_AGENTS_ITEMS_DIR, HUB_REGISTRATION_TYPES_FILE, HUB_REGISTRY_PROJECTS_DIR, HUB_RULES_SOURCE_DIR, IDE_OUTPUT_DIRS, LZI_DIR, OPTIMIZE_RULES, OPTIMIZE_SEVERITY_ORDER, OPTIMIZE_THRESHOLDS, type OptimizeRule, type OptimizeRuleId, type OptimizeSeverity, type OptimizeSuggestion, SHARED_DEFAULT_NAMESPACE, SHARED_PROMPTS_CATEGORIES, SYNTHESIS_RULES, type SharedPromptsCategory, type SharedPromptsRegistration, type SharedPromptsRegistrationSubscription, type SynthesisMode, type SynthesisRule, VALID_AGENTS, type VendorRule, buildSharedRegistrationFileContent, buildSuggestion, detectAgentTypes, hubSharedSourceDir, sharedNamespaceRelPath };
432
+ export { AGENTS_ITEMS_SOURCE_DIR, AUTO_AGENT_KEYWORD, type AgentItem, type AgentType, BUILTIN_PLACEHOLDERS, CATEGORY_RULES, COMMON_SOURCE, type Category, type CategoryRule, DEFAULT_SHARED_PROMPTS_HUB_NAME, DEFAULT_SOURCES, GENERATED_BLOCK_BEGIN, GENERATED_BLOCK_END, HUB_AGENTS_ITEMS_DIR, HUB_META_KEY, HUB_RULES_SOURCE_DIR, IDE_OUTPUT_DIRS, LZI_DIR, OPTIMIZE_RULES, OPTIMIZE_SEVERITY_ORDER, OPTIMIZE_THRESHOLDS, type OptimizeRule, type OptimizeRuleId, type OptimizeSeverity, type OptimizeSuggestion, PRODUCT_META_KEY, SHARED_PROMPTS_CATEGORIES, SYNTHESIS_RULES, type SharedPromptsCategory, type SynthesisMode, type SynthesisRule, VALID_AGENTS, type VendorRule, buildSuggestion, categoryMaterializeRoot, detectAgentTypes, hubSharedSourceDir };
package/dist/index.js CHANGED
@@ -40,26 +40,4 @@ IDE 差异化诉求请写在 agent.claude.md(仅进 CLAUDE.md)。
40
40
  # frontmatter 各 IDE 不同(claude paths / trae alwaysApply+globs),见 docs/vendors/
41
41
  `,"skills/.gitkeep":`# 此目录存放技能真源
42
42
  # 命名约定:<base>.md(共同)+ <base>.<type>.md(某 IDE 独有)
43
- `},i=`.lzi`,a=`agents/agent.md`,o=`agents/items`,s=`shared`,c=`longzai-intelligence-agent-prompts`,l=`agents/items`,u=`rules`,d=[`agents`,`rules`],f=e=>e===`agents`?l:u,p=(e,t)=>e===`agents`?`${i}/${o}/${t}`:`${i}/${e}/${t}`,m=`registry/projects`,h=`registration.types.ts`,g=`// @generated by lzi-agent-cli shared(工具生成,请勿手改;变更请运行 shared register / shared unregister)`,_=`# BEGIN Lzi Agent Tools Shared(工具维护,请勿手改)`,v=`# END Lzi Agent Tools Shared`,y={claude:`.claude`,trae:`.trae`,zcode:`.zcode`},b=`<!-- BEGIN Lzi Generated(工具维护,请勿手改;修改请编辑 .lzi/ 真源后运行 sync) -->`,x=`<!-- END Lzi Generated -->`,S={claude:[{output:`CLAUDE.md`,commonSource:a,agentSource:`agents/agent.claude.md`}],trae:[{output:`CLAUDE.md`,commonSource:a,agentSource:`agents/agent.claude.md`},{output:`AGENTS.md`,commonSource:a,agentSource:`agents/agent.trae.md`}],zcode:[{output:`AGENTS.md`,commonSource:a,agentSource:`agents/agent.zcode.md`}]},C={commands:{claude:{ideRoot:y.claude,mode:`append`},trae:{ideRoot:y.trae,mode:`append`},zcode:{ideRoot:y.zcode,mode:`append`}},rules:{claude:{ideRoot:y.claude,mode:`prepend`},trae:{ideRoot:y.trae,mode:`prepend`},zcode:{ideRoot:y.zcode,mode:`prepend`}},skills:{claude:{ideRoot:y.claude,mode:`append`},trae:{ideRoot:y.trae,mode:`append`},zcode:{ideRoot:y.zcode,mode:`append`}}},w=[`claude`,`trae`,`zcode`],T={DATE:()=>(/* @__PURE__ */ new Date()).toISOString().slice(0,10),PROJECT_NAME:()=>process.cwd().split(`/`).pop()??``},E=`auto`,D=async t=>{try{return await e(t),!0}catch{return!1}},O=async e=>{let n=t(e,i);if(!await D(n))return[];let r=[];for(let e of w){let i=S[e];(await Promise.all(i.map(async e=>D(t(n,e.agentSource))))).some(e=>e)&&r.push(e)}return r},k=e=>`'${e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}'`,A=e=>`[${e.map(e=>k(e)).join(`, `)}]`,j=e=>{let t=e.subscriptions.map(e=>` {
44
- category: ${k(e.category)},
45
- namespace: ${k(e.namespace)},
46
- include: ${e.include===null?`null`:A(e.include)},
47
- },`);return`${g}
48
- import type { SharedPromptsRegistration } from './registration.types.js';
49
-
50
- /**
51
- * ${e.name} 的注册记录(机器生成,禁止手工编辑)
52
- */
53
- const registration: SharedPromptsRegistration = {
54
- name: ${k(e.name)},
55
- monorepo: ${k(e.monorepo)},
56
- subscriptions: [
57
- ${t.join(`
58
- `)}
59
- ],
60
- registeredAt: ${k(e.registeredAt)},
61
- toolVersion: ${k(e.toolVersion)},
62
- };
63
-
64
- export default registration;
65
- `},M={HEAD_LINES:30,COMMON_MAX_LINES:400,COMMON_MAX_TOKENS:5e3,CODE_BLOCK_MAX_LINES:40,DUPLICATE_MIN_CHARS:60,SIMILARITY_THRESHOLD:.85,CATEGORY_INDEX_MIN_FILES:5,AGENT_SPLIT_MIN_ROLES:3},N={"volatile-prefix":{id:`volatile-prefix`,severity:`high`,title:`易变占位符位于文件头部,破坏稳定前缀`,reference:`原文优化八:稳定前缀设计(实测收益 >85%,对费用影响最大)`},"oversized-common":{id:`oversized-common`,severity:`medium`,title:`公共源文件过大,应渐进式披露拆分`,reference:`原文优化一:渐进式披露(实测收益 >10%)`},"low-freq-section":{id:`low-freq-section`,severity:`low`,title:`低频段落常驻公共文件,建议下沉为按需加载的独立文件`,reference:`原文优化一:渐进式披露,L2 按需层(实测收益 >10%)`},"type-content-in-common":{id:`type-content-in-common`,severity:`medium`,title:`公共文件包含类型专属内容,应移入 agent.<type>.md`,reference:`原文优化六:Agent 专属配置;原则二:减少不相关的`},"cross-type-duplicate":{id:`cross-type-duplicate`,severity:`medium`,title:`各类型独有文件间存在重复段落,建议上移公共文件`,reference:`原文优化九:避免重复加载 Skill(消除隐性重复膨胀);原则三:减少重复的`},"inline-code-block":{id:`inline-code-block`,severity:`low`,title:`大段内联代码块,建议改为文件引用`,reference:`原文优化一:渐进式披露,工具列表用扁平链接替代说明文档搬运`},"missing-tools-whitelist":{id:`missing-tools-whitelist`,severity:`low`,title:`command 源文件未声明 allowed-tools 白名单`,reference:`原文优化六:Agent 专属配置,tools 白名单`},"missing-index":{id:`missing-index`,severity:`low`,title:`类别目录文件较多且无 INDEX.md 索引`,reference:`原文优化四:长期记忆按需索引加载(实测收益 >10%)`},"sequential-instruction":{id:`sequential-instruction`,severity:`low`,title:`指令要求逐个/串行执行,建议固化为脚本或改为并行`,reference:`原文优化二:确定性操作由脚本执行;原文优化十一:工具调用并行化`},"multi-step-git-ops":{id:`multi-step-git-ops`,severity:`medium`,title:`指令要求 Agent 逐步执行 git 流程,建议改用专用工具一次调用`,reference:`原文优化二:确定性操作由脚本执行,一次脚本调用替代多轮模型交互(实测收益 >10%);原文优化十一:串行工具调用每次携带完整上下文`},"mcp-over-cli":{id:`mcp-over-cli`,severity:`medium`,title:`指令指示通过 MCP 工具执行操作,CLI 优先更省 token`,reference:`原文优化二:CLI 优先于 MCP——MCP 的 JSON 结构化返回往往比纯文本 CLI 输出消耗更多 token(实测收益 >10%)`},"mcp-data-subagent":{id:`mcp-data-subagent`,severity:`medium`,title:`指令让主 Agent 直接经 MCP 获取大数据,应数据获取子 Agent 化`,reference:`原文优化三:MCP 数据获取子 Agent 化——数据获取子 Agent 压缩归纳后只把结论返回主 Agent(实测单次交互 message tokens 从 800KB 降到 5K,降幅 90%+)`},"agent-split":{id:`agent-split`,severity:`medium`,title:`公共指令承载多个职能且体量过大,建议按职能拆分为多 Agent`,reference:`原文优化五:单 Agent 拆分为多 Agent——每个 Agent 的 system prompt 与工具集最小化,拆分后总账更优(降低单次交互成本)`},"blind-search":{id:`blind-search`,severity:`low`,title:`指令要求 Agent 盲搜定位代码,建议图谱查询或精确路径引用`,reference:`原文优化七:代码图谱替代盲搜——grep/glob 暴力遍历搜索范围大、读取文件多(实测任务平均耗时降低 30%+,graphify 已在 10+ 项目落地)`},"verbose-cli-output":{id:`verbose-cli-output`,severity:`low`,title:`指令包含高输出 CLI 命令,建议接入 rtk 输出压缩代理`,reference:`原文优化十:rtk 压缩 CLI 输出——构建日志、测试报告、文件列表经 rtk 压缩后再进入模型上下文(实测压缩率 85% 左右)`}},P=[`high`,`medium`,`low`],F=(e,t,n,r)=>({rule:N[e],file:t,line:n,detail:r});export{o as AGENTS_ITEMS_SOURCE_DIR,E as AUTO_AGENT_KEYWORD,T as BUILTIN_PLACEHOLDERS,C as CATEGORY_RULES,a as COMMON_SOURCE,c as DEFAULT_SHARED_PROMPTS_HUB_NAME,r as DEFAULT_SOURCES,b as GENERATED_BLOCK_BEGIN,x as GENERATED_BLOCK_END,g as GENERATED_TS_HEADER,_ as GITIGNORE_SHARED_BEGIN,v as GITIGNORE_SHARED_END,l as HUB_AGENTS_ITEMS_DIR,h as HUB_REGISTRATION_TYPES_FILE,m as HUB_REGISTRY_PROJECTS_DIR,u as HUB_RULES_SOURCE_DIR,y as IDE_OUTPUT_DIRS,i as LZI_DIR,N as OPTIMIZE_RULES,P as OPTIMIZE_SEVERITY_ORDER,M as OPTIMIZE_THRESHOLDS,s as SHARED_DEFAULT_NAMESPACE,d as SHARED_PROMPTS_CATEGORIES,S as SYNTHESIS_RULES,w as VALID_AGENTS,j as buildSharedRegistrationFileContent,F as buildSuggestion,O as detectAgentTypes,f as hubSharedSourceDir,p as sharedNamespaceRelPath};
43
+ `},i={HEAD_LINES:30,COMMON_MAX_LINES:400,COMMON_MAX_TOKENS:5e3,CODE_BLOCK_MAX_LINES:40,DUPLICATE_MIN_CHARS:60,SIMILARITY_THRESHOLD:.85,CATEGORY_INDEX_MIN_FILES:5,AGENT_SPLIT_MIN_ROLES:3},a={"volatile-prefix":{id:`volatile-prefix`,severity:`high`,title:`易变占位符位于文件头部,破坏稳定前缀`,reference:`原文优化八:稳定前缀设计(实测收益 >85%,对费用影响最大)`},"oversized-common":{id:`oversized-common`,severity:`medium`,title:`公共源文件过大,应渐进式披露拆分`,reference:`原文优化一:渐进式披露(实测收益 >10%)`},"low-freq-section":{id:`low-freq-section`,severity:`low`,title:`低频段落常驻公共文件,建议下沉为按需加载的独立文件`,reference:`原文优化一:渐进式披露,L2 按需层(实测收益 >10%)`},"type-content-in-common":{id:`type-content-in-common`,severity:`medium`,title:`公共文件包含类型专属内容,应移入 agent.<type>.md`,reference:`原文优化六:Agent 专属配置;原则二:减少不相关的`},"cross-type-duplicate":{id:`cross-type-duplicate`,severity:`medium`,title:`各类型独有文件间存在重复段落,建议上移公共文件`,reference:`原文优化九:避免重复加载 Skill(消除隐性重复膨胀);原则三:减少重复的`},"inline-code-block":{id:`inline-code-block`,severity:`low`,title:`大段内联代码块,建议改为文件引用`,reference:`原文优化一:渐进式披露,工具列表用扁平链接替代说明文档搬运`},"missing-tools-whitelist":{id:`missing-tools-whitelist`,severity:`low`,title:`command 源文件未声明 allowed-tools 白名单`,reference:`原文优化六:Agent 专属配置,tools 白名单`},"missing-index":{id:`missing-index`,severity:`low`,title:`类别目录文件较多且无 INDEX.md 索引`,reference:`原文优化四:长期记忆按需索引加载(实测收益 >10%)`},"sequential-instruction":{id:`sequential-instruction`,severity:`low`,title:`指令要求逐个/串行执行,建议固化为脚本或改为并行`,reference:`原文优化二:确定性操作由脚本执行;原文优化十一:工具调用并行化`},"multi-step-git-ops":{id:`multi-step-git-ops`,severity:`medium`,title:`指令要求 Agent 逐步执行 git 流程,建议改用专用工具一次调用`,reference:`原文优化二:确定性操作由脚本执行,一次脚本调用替代多轮模型交互(实测收益 >10%);原文优化十一:串行工具调用每次携带完整上下文`},"mcp-over-cli":{id:`mcp-over-cli`,severity:`medium`,title:`指令指示通过 MCP 工具执行操作,CLI 优先更省 token`,reference:`原文优化二:CLI 优先于 MCP——MCP 的 JSON 结构化返回往往比纯文本 CLI 输出消耗更多 token(实测收益 >10%)`},"mcp-data-subagent":{id:`mcp-data-subagent`,severity:`medium`,title:`指令让主 Agent 直接经 MCP 获取大数据,应数据获取子 Agent 化`,reference:`原文优化三:MCP 数据获取子 Agent 化——数据获取子 Agent 压缩归纳后只把结论返回主 Agent(实测单次交互 message tokens 从 800KB 降到 5K,降幅 90%+)`},"agent-split":{id:`agent-split`,severity:`medium`,title:`公共指令承载多个职能且体量过大,建议按职能拆分为多 Agent`,reference:`原文优化五:单 Agent 拆分为多 Agent——每个 Agent 的 system prompt 与工具集最小化,拆分后总账更优(降低单次交互成本)`},"blind-search":{id:`blind-search`,severity:`low`,title:`指令要求 Agent 盲搜定位代码,建议图谱查询或精确路径引用`,reference:`原文优化七:代码图谱替代盲搜——grep/glob 暴力遍历搜索范围大、读取文件多(实测任务平均耗时降低 30%+,graphify 已在 10+ 项目落地)`},"verbose-cli-output":{id:`verbose-cli-output`,severity:`low`,title:`指令包含高输出 CLI 命令,建议接入 rtk 输出压缩代理`,reference:`原文优化十:rtk 压缩 CLI 输出——构建日志、测试报告、文件列表经 rtk 压缩后再进入模型上下文(实测压缩率 85% 左右)`}},o=[`high`,`medium`,`low`],s=(e,t,n,r)=>({rule:a[e],file:t,line:n,detail:r}),c=`.lzi`,l=`agents/agent.md`,u=`agents/items`,d=`longzai-intelligence-agent-prompts`,f=`hub`,p=`lzi`,m=`agents/items`,h=`rules`,g=[`agents`,`rules`],_=e=>e===`agents`?m:h,v=e=>e===`agents`?`${c}/${u}`:`${c}/${e}`,y={claude:`.claude`,trae:`.trae`,zcode:`.zcode`},b=`<!-- BEGIN Lzi Generated(工具维护,请勿手改;修改请编辑 .lzi/ 真源后运行 sync) -->`,x=`<!-- END Lzi Generated -->`,S={claude:[{output:`CLAUDE.md`,commonSource:l,agentSource:`agents/agent.claude.md`}],trae:[{output:`CLAUDE.md`,commonSource:l,agentSource:`agents/agent.claude.md`},{output:`AGENTS.md`,commonSource:l,agentSource:`agents/agent.trae.md`}],zcode:[{output:`AGENTS.md`,commonSource:l,agentSource:`agents/agent.zcode.md`}]},C={commands:{claude:{ideRoot:y.claude,mode:`append`},trae:{ideRoot:y.trae,mode:`append`},zcode:{ideRoot:y.zcode,mode:`append`}},rules:{claude:{ideRoot:y.claude,mode:`prepend`},trae:{ideRoot:y.trae,mode:`prepend`},zcode:{ideRoot:y.zcode,mode:`prepend`}},skills:{claude:{ideRoot:y.claude,mode:`append`},trae:{ideRoot:y.trae,mode:`append`},zcode:{ideRoot:y.zcode,mode:`append`}}},w=[`claude`,`trae`,`zcode`],T={DATE:()=>(/* @__PURE__ */ new Date()).toISOString().slice(0,10),PROJECT_NAME:()=>process.cwd().split(`/`).pop()??``},E=`auto`,D=async t=>{try{return await e(t),!0}catch{return!1}},O=async e=>{let n=t(e,c);if(!await D(n))return[];let r=[];for(let e of w){let i=S[e];(await Promise.all(i.map(async e=>D(t(n,e.agentSource))))).some(e=>e)&&r.push(e)}return r};export{u as AGENTS_ITEMS_SOURCE_DIR,E as AUTO_AGENT_KEYWORD,T as BUILTIN_PLACEHOLDERS,C as CATEGORY_RULES,l as COMMON_SOURCE,d as DEFAULT_SHARED_PROMPTS_HUB_NAME,r as DEFAULT_SOURCES,b as GENERATED_BLOCK_BEGIN,x as GENERATED_BLOCK_END,m as HUB_AGENTS_ITEMS_DIR,f as HUB_META_KEY,h as HUB_RULES_SOURCE_DIR,y as IDE_OUTPUT_DIRS,c as LZI_DIR,a as OPTIMIZE_RULES,o as OPTIMIZE_SEVERITY_ORDER,i as OPTIMIZE_THRESHOLDS,p as PRODUCT_META_KEY,g as SHARED_PROMPTS_CATEGORIES,S as SYNTHESIS_RULES,w as VALID_AGENTS,s as buildSuggestion,v as categoryMaterializeRoot,O as detectAgentTypes,_ as hubSharedSourceDir};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@longzai-intelligence-agent-tools/core",
3
- "version": "0.0.12",
3
+ "version": "0.0.14",
4
4
  "private": false,
5
5
  "license": "UNLICENSED",
6
6
  "files": [