القائمة
检测新合并到 te-cli 的 CLI 功能是否合理。从命令注册、业务域↔skill 配对、skill 文档覆盖、skill 内部一致性、用户文档同步、工程健壮性六个维度扫描，定位会导致命令加载失败、AI agent 读空文档瞎猜参数、用户文档滞后等问题。当合并了新命令域/命令、新增或修改 skill、做发版前自检、或需要评估 CLI 功能完整性时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
AE Engage capability gateway: config center, flows, push/config channels, strategies, templates, task management, and operation activities. Trigger words: config center, scene config, push channel, config channel, operation strategy, operation task, operation activity, template, config item, Engage, Hermes, engage-scene, engage-setting, engage-flow, engage-task, engage-activity.
AE Agent platform CLI for Agent, archived conversation, automation, model, MCP, Skill, attachment, and user-memory work. Use when managing these resources, browsing Agent markets, restoring archived conversations, creating scheduled automations, persisting user memory, or answering from user preferences, background, stable workflows, or historical conventions.
Use ae-cli for AE/TE analysis-side data questions, asset operations, and asset governance: reports, analysis boards, BI dashboards, ad-hoc models, drilldown, detail data, alerts, clusters, tags, metrics, metadata, project configuration, tracking plans, governance asset lists/rules/lineage/impact/dependency, batch asset operations, projects, and resource links. Use when the user asks to query data, explain a change, export evidence, or inspect/create/update/govern analysis assets.
AE Data Development and Operations: Data warehouse management, flow orchestration, IDE queries, and data integration
Interactive generation of AE tracking code, LogBus2 configuration, and debug scripts from a tracking plan. Trigger words: 代码埋点、埋点代码、tracking code、埋点落地、logbus 配置、AE 上报代码、generate tracking code、insert tracking、トラッキングコード、트래킹 코드. Supports independent output mode selection per platform (insert/snippet). Server-side defaults to LoggerConsumer + LogBus2 architecture.
AE/TE metadata capability-gateway CLI: metadata data-table management and property dimension-table binding. Metadata CLI routes through the analysis gateway. Input-file upload and event/property detail belong to ae-analysis.
| name | cli-self-check |
| version | 1.0.0 |
| description | 检测新合并到 te-cli 的 CLI 功能是否合理。从命令注册、业务域↔skill 配对、skill 文档覆盖、skill 内部一致性、用户文档同步、工程健壮性六个维度扫描，定位会导致命令加载失败、AI agent 读空文档瞎猜参数、用户文档滞后等问题。当合并了新命令域/命令、新增或修改 skill、做发版前自检、或需要评估 CLI 功能完整性时使用。 |
te-cli 的「新功能合理性」自检 skill。把一次人工 code review 中反复用到的结构化检查固化成可重复执行的脚本 + 判读规则。
src/commands/te-*）或新命令skills/ 下的 skill# 全量扫描（推荐发版前用）
node self-check/scan.mjs
# 只看相对某分支的变更域（推荐合并/提 PR 后用，聚焦本次改动）
node self-check/scan.mjs --since master
# 机器可读，便于接 CI
node self-check/scan.mjs --json
退出码：存在 P1 时返回 1，否则 0，可直接用于 CI 卡口。
脚本是纯 Node、零新依赖、只读不改仓库。判读和修复由你（agent）依据下方规则完成——脚本负责「发现」，你负责「确认 + 修」。
| 维度 | 名称 | 查什么 | 漏了会怎样 |
|---|---|---|---|
| D1 | 命令注册 | 新域是否在 src/index.ts 注册；MCP service 是否注册了 mapping | 命令根本不加载；buildMcpUrl 运行时抛错 |
| D2 | 域↔skill 配对 | 每个业务域是否有对应 skill；工具命令不应有 skill | agent 不知道怎么用新命令 |
| D3 | skill 文档覆盖 | 命令 ↔ references/*.md 是否一一对应 | agent 缺命令文档，被迫猜参数 |
| D4 | skill 内部一致性 | CRITICAL 规则「+cmd→cmd.md」是否与真实文件名相符；SKILL.md 内链接是否失效 | agent 按规则去读文档却读空，瞎猜 ID/参数 |
| D5 | 文档同步 | README（中/英）是否覆盖所有 service；版本号 vs CHANGELOG | 用户照 README 用，以为新功能不存在 |
| D6 | 工程健壮性 | 每个域是否有 verify 脚本；是否接入 tsc --noEmit | 回归无自动拦截；类型错误只在 build 暴露 |
src/index.ts 的 loadCommands()（业务域）或 registerXxxCommand()（工具命令）补上 import('./commands/<dir>/index.js')。index.ts 顶部调 registerMcpMappings({ '<service>': { componentName, mappingPath } })（参考 te-community/index.ts、te-engage/index.ts）。analysis / te_analysis_extend 在 core/mcp.ts 内置，不必重复。engage）≠ MCP 路由 key（如 engage_config）。脚本只检查后者，且只提取字面量传参；变量传参不报（宁可漏报不误报）。sync、model、auth、config、api 无 skill 是正确的。scan.mjs 顶部 DOMAIN_TO_SKILL 里登记映射；新增工具命令登记到 TOOL_DIRS。漏登记会被报 P2，提醒你补映射或确认归类。create-team.md 覆盖 +create，所以这里报的是真·缺文档。references/ 补 .md，并在 SKILL.md 命令清单里挂上链接。ae-dataops、ae-kb）在 GROUPED_DOC_SKILLS 中豁免逐命令检查——若新 skill 也走这种策略，加进去。+list 的文档叫 list-teams.md，agent 会去读不存在的 list.md。
list.md）——推荐，规则最自洽；② 改写顶部规则为「以下方命令清单中的链接为准」，删掉「filename = command name」的断言。references/xxx.md 指向的文件不存在——补文件或修链接。README.md 和 README.zh.md 的命令表。scripts/verify-te-<domain>.mjs（参考 verify-te-meta-tools.mjs：遍历命令源码、校验 flag/description 形状、对线上 catalog dry-run），并在 package.json 加 verify:<domain> 脚本。"typecheck": "tsc --noEmit"，把类型检查从 build 前移。scan.mjs 顶部有可调配置，新增模块时按需更新：
DOMAIN_TO_SKILL：业务域目录 → skill 名映射COMMAND_SKILL_OVERRIDES：同一命令域内由 overlay skill 负责的命令路径 → skill 名映射TOOL_DIRS：工具命令目录（豁免 skill 检查）GROUPED_DOC_SKILLS：走分组/内联文档策略的 skill（豁免逐命令 reference 检查）判读哲学：脚本只报「值得人看一眼」的线索，确认与修复由 agent 结合源码做。新增检测维度时，优先保证零误报——一个假 P1 比漏报更伤工具可信度。