@longzai-intelligence-agent-tools/core 0.0.10 → 0.0.11

package/dist/index.d.ts

@@ -156,24 +156,46 @@ type OptimizeSuggestion = {
   readonly detail: string;
 };
 /**
- * Agent Tools 配置
+ * 单条订阅登记（hub 侧注册记录中该项目在本 hub 的一个命名空间订阅）
+ */
+type SharedPromptsRegistrationSubscription = {
+  /**
+   * 物化命名空间（该项目 .lzi/agents/items/ 下的保留目录名）
+   */
+  readonly namespace: string;
+  /**
+   * 订阅范围 glob 列表（相对 hub 的 agents/items/）；null = 订阅全部
+   */
+  readonly include: readonly string[] | null;
+};
+/**
+ * hub 侧项目注册记录（registry/projects/<项目名>.ts 模块形态）
  *
- * 通过 lzi.config.ts 的 agentTools 字段提供。
+ * 形状与 hub 仓 registry/registration.types.ts 保持同步（双份维护由
+ * CLI 侧 zod 运行时校验兜底；core 发布后 hub 侧可转发本类型收敛单一来源）。
+ * v1 每项目仅支持订阅单一 hub，subscriptions 描述其全部命名空间订阅。
  */
-type AgentToolsConfig = {
+type SharedPromptsRegistration = {
   /**
-   * 目标 Agent 类型输入串
-   *
-   * 支持单值（claude）、多值（逗号分隔，如 claude,trae）或 auto（按真源推断）。
-   * 优先级低于环境变量 LZI_AGENT_TYPE，高于默认 auto。
+   * 项目名（项目根目录名，如 longzai-intelligence-agent-tools）
    */
-  readonly agentType?: string;
+  readonly name: string;
   /**
-   * 占位符值
-   *
-   * 替换源 markdown 中的 {{KEY}}。机器特定绝对路径应写在此处。
+   * 所在 monorepo 目录名（如 longzai-intelligence-m5-edition，纯信息性定位提示）
+   */
+  readonly monorepo: string;
+  /**
+   * 该项目在本 hub 的订阅列表
+   */
+  readonly subscriptions: readonly SharedPromptsRegistrationSubscription[];
+  /**
+   * 首次注册日期（YYYY-MM-DD，重复注册保持不变）
    */
-  readonly placeholders?: Record<string, string>;
+  readonly registeredAt: string;
+  /**
+   * 最近一次注册/刷新时的 CLI 版本号
+   */
+  readonly toolVersion: string;
 };
 //#endregion
 //#region src/defaults.d.ts
@@ -184,6 +206,19 @@ type AgentToolsConfig = {
  */
 declare const DEFAULT_SOURCES: Readonly<Record<string, string>>;
 //#endregion
+//#region src/shared.templates.d.ts
+/**
+ * 生成 hub 侧注册记录文件内容（registry/projects/<项目名>.ts）
+ *
+ * 类型引用指向 hub 仓自足类型文件（见 hub 仓 ADR 0002：hub 不依赖
+ * 未发布的 agent-tools 类型，注册记录仍获得完整静态检查）。同目录导入
+ * 不触发父目录相对导入规约。
+ *
+ * @param registration - 注册记录状态模型
+ * @returns 完整 TS 模块源码（含 @generated 头与文件尾换行）
+ */
+declare const buildSharedRegistrationFileContent: (registration: SharedPromptsRegistration) => string;
+//#endregion
 //#region src/optimizer.rules.d.ts
 /**
  * 优化阈值常量表
@@ -291,6 +326,61 @@ declare const COMMON_SOURCE: 'agents/agent.md';
  * items/ 缺失或无产出时，根指令合成行为与无条目机制时完全一致。
  */
 declare const AGENTS_ITEMS_SOURCE_DIR: 'agents/items';
+/**
+ * 默认物化命名空间
+ *
+ * 共享条目默认物化到 .lzi/agents/items/shared/（项目 gitignore 的
+ * 工具保留目录）；多个 hub 订阅时各自使用不同命名空间避免冲突。
+ */
+declare const SHARED_DEFAULT_NAMESPACE: 'shared';
+/**
+ * 默认共享提示词中心仓名
+ *
+ * 工作区当前唯一的 hub 仓，shared register 未显式指定 --hub 时的默认值；
+ * hub 定位约定 fallback 为 <项目根>/../<hub 名>（m5-edition 内平铺布局）。
+ */
+declare const DEFAULT_SHARED_PROMPTS_HUB_NAME: 'longzai-intelligence-agent-prompts';
+/**
+ * hub 内条目库目录（相对 hub 根）
+ *
+ * 与项目侧 .lzi/agents/items/ 同构的共享条目真源目录，
+ * 物化时按订阅 include/exclude 从此目录复制到项目命名空间目录。
+ */
+declare const HUB_AGENTS_ITEMS_DIR: 'agents/items';
+/**
+ * hub 内注册记录目录（相对 hub 根）
+ *
+ * 每个已注册项目一个 <项目名>.ts 记录（机器生成），
+ * 即共享条目变更的波及面清单。目录内另有自足类型文件
+ * {@link HUB_REGISTRATION_TYPES_FILE}（非注册记录，扫描时排除）。
+ */
+declare const HUB_REGISTRY_PROJECTS_DIR: 'registry/projects';
+/**
+ * hub 注册记录目录内的自足类型文件名
+ *
+ * 与注册记录同目录放置：记录以同目录相对导入引用（`./registration.types.js`），
+ * 不触发父目录相对导入规约；CLI 扫描注册记录时按本常量排除。
+ */
+declare const HUB_REGISTRATION_TYPES_FILE: 'registration.types.ts';
+/**
+ * 机器生成 TS 文件的头部标记
+ *
+ * 声明机器所有权：注册表/注册记录文件由 CLI 整文件再生成，禁止手工编辑。
+ */
+declare const GENERATED_TS_HEADER: '// @generated by lzi-agent-cli shared（工具生成，请勿手改；变更请运行 shared register / shared unregister）';
+/**
+ * 项目 .gitignore 受管块起始标记
+ *
+ * 共享命名空间的忽略规则包裹在受管块内，shared register / unregister
+ * 幂等维护块内容，块外 .gitignore 内容永不触碰（按需添加，符合 ADR-0020）。
+ */
+declare const GITIGNORE_SHARED_BEGIN: '# BEGIN Lzi Agent Tools Shared（工具维护，请勿手改）';
+/**
+ * 项目 .gitignore 受管块结束标记
+ *
+ * 与 {@link GITIGNORE_SHARED_BEGIN} 成对使用，界定受管块尾部。
+ */
+declare const GITIGNORE_SHARED_END: '# END Lzi Agent Tools Shared';
 /**
  * 各 IDE 的配置根目录名
  *
@@ -339,19 +429,6 @@ declare const CATEGORY_RULES: Readonly<Record<string, CategoryRule>>;
  * 用于校验环境变量 LZI_AGENT_TYPE。
  */
 declare const VALID_AGENTS: readonly AgentType[];
-/**
- * 环境变量名称常量
- */
-declare const ENV_KEYS: {
-  /**
-   * 当前 Agent 类型
-   */
-  readonly AGENT_TYPE: 'LZI_AGENT_TYPE';
-  /**
-   * 占位符环境变量前缀
-   */
-  readonly PLACEHOLDER_PREFIX: 'LZI_PLACEHOLDER_';
-};
 /**
  * 内置占位符
  *
@@ -378,4 +455,4 @@ declare const AUTO_AGENT_KEYWORD: 'auto';
  */
 declare const detectAgentTypes: (projectRoot: string) => Promise<readonly AgentType[]>;
 //#endregion
-export { AGENTS_ITEMS_SOURCE_DIR, AUTO_AGENT_KEYWORD, type AgentItem, type AgentToolsConfig, type AgentType, BUILTIN_PLACEHOLDERS, CATEGORY_RULES, COMMON_SOURCE, type Category, type CategoryRule, DEFAULT_SOURCES, ENV_KEYS, GENERATED_BLOCK_BEGIN, GENERATED_BLOCK_END, IDE_OUTPUT_DIRS, LZI_DIR, OPTIMIZE_RULES, OPTIMIZE_SEVERITY_ORDER, OPTIMIZE_THRESHOLDS, type OptimizeRule, type OptimizeRuleId, type OptimizeSeverity, type OptimizeSuggestion, SYNTHESIS_RULES, type SynthesisMode, type SynthesisRule, VALID_AGENTS, type VendorRule, buildSuggestion, detectAgentTypes };
+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, IDE_OUTPUT_DIRS, LZI_DIR, OPTIMIZE_RULES, OPTIMIZE_SEVERITY_ORDER, OPTIMIZE_THRESHOLDS, type OptimizeRule, type OptimizeRuleId, type OptimizeSeverity, type OptimizeSuggestion, SHARED_DEFAULT_NAMESPACE, SYNTHESIS_RULES, type SharedPromptsRegistration, type SharedPromptsRegistrationSubscription, type SynthesisMode, type SynthesisRule, VALID_AGENTS, type VendorRule, buildSharedRegistrationFileContent, buildSuggestion, detectAgentTypes };

package/dist/index.js

@@ -1,4 +1,11 @@
-import"./rolldown-runtime-BqT_7tdF.js";import{stat as e}from"node:fs/promises";import{join as t}from"node:path";const n={"agents/agent.md":`# 共同部分
+import"./rolldown-runtime-BqT_7tdF.js";import{stat as e}from"node:fs/promises";import{join as t}from"node:path";const n=`# AGENTS.md 独有部分（trae / zcode 共享）
+
+AGENTS.md 由 trae 与 zcode 共享：本文件内容须与另一侧独有源保持一致
+（agent.trae.md ≡ agent.zcode.md），否则 auto 多 type sync 将直接报错；
+IDE 差异化诉求请写在 agent.claude.md（仅进 CLAUDE.md）。
+
+<!-- 在此添加 trae / zcode 一致的独有指令 -->
+`,r={"agents/agent.md":`# 共同部分
 
 所有 AI IDE 都会读取此文件的内容。此文件与各 IDE 独有部分（agent.<ide>.md）拼接后，
 分别输出为 CLAUDE.md / AGENTS.md。
@@ -21,17 +28,7 @@ import"./rolldown-runtime-BqT_7tdF.js";import{stat as e}from"node:fs/promises";i
 此文件的内容仅出现在 CLAUDE.md 中（claude 和 trae 场景）。
 
 <!-- 在此添加 Claude 专属的指令 -->
-`,"agents/agent.trae.md":`# Trae 专属指令
-
-此文件的内容仅出现在 trae 场景的 AGENTS.md 中。
-
-<!-- 在此添加 Trae 专属的指令 -->
-`,"agents/agent.zcode.md":`# ZCode 专属指令
-
-此文件的内容仅出现在 zcode 场景的 AGENTS.md 中。
-
-<!-- 在此添加 ZCode 专属的指令 -->
-`,"agents/items/.gitkeep":`# 此目录存放条目真源（agent.md 共同部分的条目化拆分）
+`,"agents/agent.trae.md":n,"agents/agent.zcode.md":n,"agents/items/.gitkeep":`# 此目录存放条目真源（agent.md 共同部分的条目化拆分）
 # 命名约定：<path>.md（全类型条目）+ <path>.<type>.md（某 IDE 变体或独有条目）
 # 子文件夹任意层级组织；解析后正文为空 = 该条目对该类型暂不产出
 # 定序：条目 frontmatter 元信息 order: <数值>，按 (order, 路径) 升序，未声明者排最后
@@ -43,4 +40,25 @@ import"./rolldown-runtime-BqT_7tdF.js";import{stat as e}from"node:fs/promises";i
 # frontmatter 各 IDE 不同（claude paths / trae alwaysApply+globs），见 docs/vendors/
 `,"skills/.gitkeep":`# 此目录存放技能真源
 # 命名约定：<base>.md（共同）+ <base>.<type>.md（某 IDE 独有）
-`},r={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},i={"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% 左右）`}},a=[`high`,`medium`,`low`],o=(e,t,n,r)=>({rule:i[e],file:t,line:n,detail:r}),s=`.lzi`,c=`agents/agent.md`,l=`agents/items`,u={claude:`.claude`,trae:`.trae`,zcode:`.zcode`},d=`<!-- BEGIN Lzi Generated（工具维护，请勿手改；修改请编辑 .lzi/ 真源后运行 sync） -->`,f=`<!-- END Lzi Generated -->`,p={claude:[{output:`CLAUDE.md`,commonSource:c,agentSource:`agents/agent.claude.md`}],trae:[{output:`CLAUDE.md`,commonSource:c,agentSource:`agents/agent.claude.md`},{output:`AGENTS.md`,commonSource:c,agentSource:`agents/agent.trae.md`}],zcode:[{output:`AGENTS.md`,commonSource:c,agentSource:`agents/agent.zcode.md`}]},m={commands:{claude:{ideRoot:u.claude,mode:`append`},trae:{ideRoot:u.trae,mode:`append`},zcode:{ideRoot:u.zcode,mode:`append`}},rules:{claude:{ideRoot:u.claude,mode:`prepend`},trae:{ideRoot:u.trae,mode:`prepend`},zcode:{ideRoot:u.zcode,mode:`prepend`}},skills:{claude:{ideRoot:u.claude,mode:`append`},trae:{ideRoot:u.trae,mode:`append`},zcode:{ideRoot:u.zcode,mode:`append`}}},h=[`claude`,`trae`,`zcode`],g={AGENT_TYPE:`LZI_AGENT_TYPE`,PLACEHOLDER_PREFIX:`LZI_PLACEHOLDER_`},_={DATE:()=>new Date().toISOString().slice(0,10),PROJECT_NAME:()=>process.cwd().split(`/`).pop()??``},v=`auto`,y=async t=>{try{return await e(t),!0}catch{return!1}},b=async e=>{let n=t(e,s);if(!await y(n))return[];let r=[];for(let e of h){let i=p[e];(await Promise.all(i.map(async e=>y(t(n,e.agentSource))))).some(e=>e)&&r.push(e)}return r};export{l as AGENTS_ITEMS_SOURCE_DIR,v as AUTO_AGENT_KEYWORD,_ as BUILTIN_PLACEHOLDERS,m as CATEGORY_RULES,c as COMMON_SOURCE,n as DEFAULT_SOURCES,g as ENV_KEYS,d as GENERATED_BLOCK_BEGIN,f as GENERATED_BLOCK_END,u as IDE_OUTPUT_DIRS,s as LZI_DIR,i as OPTIMIZE_RULES,a as OPTIMIZE_SEVERITY_ORDER,r as OPTIMIZE_THRESHOLDS,p as SYNTHESIS_RULES,h as VALID_AGENTS,o as buildSuggestion,b as detectAgentTypes};
+`},i=`.lzi`,a=`agents/agent.md`,o=`agents/items`,s=`shared`,c=`longzai-intelligence-agent-prompts`,l=`agents/items`,u=`registry/projects`,d=`registration.types.ts`,f=`// @generated by lzi-agent-cli shared（工具生成，请勿手改；变更请运行 shared register / shared unregister）`,p=`# BEGIN Lzi Agent Tools Shared（工具维护，请勿手改）`,m=`# END Lzi Agent Tools Shared`,h={claude:`.claude`,trae:`.trae`,zcode:`.zcode`},g=`<!-- BEGIN Lzi Generated（工具维护，请勿手改；修改请编辑 .lzi/ 真源后运行 sync） -->`,_=`<!-- END Lzi Generated -->`,v={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`}]},y={commands:{claude:{ideRoot:h.claude,mode:`append`},trae:{ideRoot:h.trae,mode:`append`},zcode:{ideRoot:h.zcode,mode:`append`}},rules:{claude:{ideRoot:h.claude,mode:`prepend`},trae:{ideRoot:h.trae,mode:`prepend`},zcode:{ideRoot:h.zcode,mode:`prepend`}},skills:{claude:{ideRoot:h.claude,mode:`append`},trae:{ideRoot:h.trae,mode:`append`},zcode:{ideRoot:h.zcode,mode:`append`}}},b=[`claude`,`trae`,`zcode`],x={DATE:()=>(/* @__PURE__ */ new Date()).toISOString().slice(0,10),PROJECT_NAME:()=>process.cwd().split(`/`).pop()??``},S=`auto`,C=async t=>{try{return await e(t),!0}catch{return!1}},w=async e=>{let n=t(e,i);if(!await C(n))return[];let r=[];for(let e of b){let i=v[e];(await Promise.all(i.map(async e=>C(t(n,e.agentSource))))).some(e=>e)&&r.push(e)}return r},T=e=>`'${e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`)}'`,E=e=>`[${e.map(e=>T(e)).join(`, `)}]`,D=e=>{let t=e.subscriptions.map(e=>`    {
+      namespace: ${T(e.namespace)},
+      include: ${e.include===null?`null`:E(e.include)},
+    },`);return`${f}
+import type { SharedPromptsRegistration } from './registration.types.js';
+
+/**
+ * ${e.name} 的注册记录（机器生成，禁止手工编辑）
+ */
+const registration: SharedPromptsRegistration = {
+  name: ${T(e.name)},
+  monorepo: ${T(e.monorepo)},
+  subscriptions: [
+${t.join(`
+`)}
+  ],
+  registeredAt: ${T(e.registeredAt)},
+  toolVersion: ${T(e.toolVersion)},
+};
+
+export default registration;
+`},O={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},k={"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% 左右）`}},A=[`high`,`medium`,`low`],j=(e,t,n,r)=>({rule:k[e],file:t,line:n,detail:r});export{o as AGENTS_ITEMS_SOURCE_DIR,S as AUTO_AGENT_KEYWORD,x as BUILTIN_PLACEHOLDERS,y as CATEGORY_RULES,a as COMMON_SOURCE,c as DEFAULT_SHARED_PROMPTS_HUB_NAME,r as DEFAULT_SOURCES,g as GENERATED_BLOCK_BEGIN,_ as GENERATED_BLOCK_END,f as GENERATED_TS_HEADER,p as GITIGNORE_SHARED_BEGIN,m as GITIGNORE_SHARED_END,l as HUB_AGENTS_ITEMS_DIR,d as HUB_REGISTRATION_TYPES_FILE,u as HUB_REGISTRY_PROJECTS_DIR,h as IDE_OUTPUT_DIRS,i as LZI_DIR,k as OPTIMIZE_RULES,A as OPTIMIZE_SEVERITY_ORDER,O as OPTIMIZE_THRESHOLDS,s as SHARED_DEFAULT_NAMESPACE,v as SYNTHESIS_RULES,b as VALID_AGENTS,D as buildSharedRegistrationFileContent,j as buildSuggestion,w as detectAgentTypes};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-agent-tools/core",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "private": false,
   "license": "UNLICENSED",
   "files": [