命令与工作流参考

本页用于快速查看 LingXi 当前对外支持的前台能力与底层运行命令。

前台能力

LingXi 当前显式工作流表层聚焦在两个能力上：

能力	作用	典型产出
task	把粗糙请求整理成工程师可直接开工的任务文档	.lingxi/tasks/*.md
vet	在实现前挑战任务质量，输出结构化审查结果	VetReport（结构化输出）

这两个能力都只在你明确调用时运行。

后台能力

LingXi 还有一条后台持续运行的记忆链路：

能力	作用	典型产出
session-distill	从历史会话中提炼 durable engineering taste	写入 .lingxi/memory/，并更新 state 与 index
memory-retrieve	为当前工作检索最小必要的高信号记忆	memory brief / retrieval hits
memory-write	对通过裁决的候选执行治理并落盘	notes + INDEX.md 更新

常用脚本

LingXi 当前运行时最常用的脚本包括：

lx-bootstrap

npm run lx:bootstrap
# 或
node scripts/lx-bootstrap.mjs

作用：

• 初始化 .lingxi/，生成 AGENTS.md
• 生成或合并 .codex/config.toml、.codex/hooks.json（Codex adapter）
• 生成 .codex/agents/lingxi-session-distill.toml
• 生成或合并 .claude/settings.json（Claude Code adapter）
• 生成 .claude/agents/lingxi-session-distill.md，复制 skills 到 .claude/skills/
• 生成 CLAUDE.md、.lingxi/setup/automation.session-distill.toml
• 注册 session-distill automation（仅 Codex）

lx-distill-sessions

npm run lx:distill-sessions
# 或
node scripts/lx-distill-sessions.mjs

作用：

• 扫描历史 session artifact
• 选择有效 session
• 调用单 session worker 提炼 durable engineering taste

通用对话 memory 消费

当前主线不再保留 lx-memory-brief 这种手动命令。

普通的有意义仓库对话，会通过仓库级 UserPromptSubmit hook（Codex 或 Claude Code）自动注入最小必要的 memory brief。

补充说明：

• task 与 vet 继续直接调用底层 retrieval，不依赖 hook
• Windows 原生环境下，setup 会生成 hooks 配置，但 Codex 目前还不会原生执行这些 hooks

lingxi-setup

npm run lx:setup
# 或
node scripts/lingxi-setup.mjs

作用：

• 初始化 LingXi runtime 基础目录 .lingxi/
• 仅在缺失时生成 AGENTS.md
• 生成或合并 .codex/config.toml、.codex/hooks.json（Codex adapter）
• 生成 .codex/agents/lingxi-session-distill.toml
• 生成或合并 .claude/settings.json（Claude Code adapter）
• 生成 .claude/agents/lingxi-session-distill.md，复制 skills 到 .claude/skills/
• 仅在缺失时生成 CLAUDE.md
• 生成 .lingxi/setup/automation.session-distill.toml

支持 --host 参数：codex、claude、all（默认）。

lx-create-automation

npm run lx:create-automation
# 或
node scripts/lx-create-automation.mjs

作用：

• 根据 setup 产物注册或更新 LingXi 的 session-distill automation

卸载

npm run lx:uninstall
# 或
yarn lx:uninstall

非交互环境可使用：

yarn lx:uninstall --yes

测试与发布前检查

主仓当前用这些测试来保证安装面、工作流与 memory 主线的一致性：

• npm test
• install-manifest-exists
• install-manifest-coverage
• install-manifest-version-sync

下一步

• 核心工作流
• 记忆系统
• FAQ