oh-my-knowledge 1.0.0-beta.13 → 1.0.0-beta.14

package/dist/assets/agent-skills/omk/references/commands.md

@@ -136,7 +136,6 @@ omk eval [flags]
 - `--model` `option`:被测模型
 - `--no-debias-length` `boolean`:关 length-debias（默认开）
 - `--no-diagnostic` `boolean`:关闭基于 Core 失败、缺失、排除与稳定 reason code 的诊断投影。
-- `--no-evidence` `boolean`:不把本次评测写成证据追加进受管记录(默认会为已 install 的 skill 自动写)。
 - `--no-gate` `boolean`:关闭判定门禁
 - `--no-judge` `boolean`:跳过 LLM 评委
 - `--no-serve` `boolean`:不启 report server
@@ -297,7 +296,7 @@ omk evolve <skillPath> [flags]
 - `--rounds` `option` (默认 `5`):最大迭代轮数，默认 5
 - `--samples` `option`:指定已有样本源；省略时先找 skill 私有样本，再找项目样本，都不存在时自动生成
 - `--skip-doctor` `boolean`:跳过 doctor 门禁（escape hatch，自负 garbage-in 风险）
-- `--snapshot-only` `boolean`:只产候选、不写回 source：胜出版本留在 evolve/，再由你人工选择。受管 skill 默认会写回 source 并记 Core 证据。
+- `--snapshot-only` `boolean`:只产候选、不写回 source：胜出版本留在 evolve/，再由你人工选择。默认仅在最终 Core 门禁通过后写回 source。
 - `--target` `option`:目标 composite 分数，达到即停。不传则跑满 rounds
 - `--timeout` `option` (默认 `600`):单用例超时秒，默认 600
 
@@ -357,7 +356,7 @@ omk init my-project --samples 20
 
 ## omk install
 
-安装 omk 官方 Agent Skill，或登记并分发用户自己的 skill（内置 id omk-agent-skill，本地路径，或 git:<ref>:<name> 取当前仓库某个 ref 的 skill）。默认写入本机已检测 agent 目标；安装用户 skill 时同时登记一条受管记录。
+安装 omk 官方 Agent Skill，或安装用户自己的 skill（内置 id omk-agent-skill，本地路径，或 git:<ref>:<name> 取当前仓库某个 ref 的 skill）。默认写入本机已检测 agent 目标。
 
 **用法:**
 
@@ -400,7 +399,7 @@ omk install omk-agent-skill --to all
 omk install omk-agent-skill --dest ~/.my-agent/skills
 ```
 
-> 登记并分发用户自己的 skill（--kind 可省，命中 SKILL.md 自动推导）
+> 安装用户自己的 skill（--kind 可省，命中 SKILL.md 自动推导）
 
 ```bash
 omk install ./skills/review
@@ -412,48 +411,12 @@ omk install ./skills/review
 omk install git:main:skills/review
 ```
 
-> 从远端 git 仓库安装 skill（位置参数是仓库内路径；认证用本机 git 凭证；记录钉实际 SHA）
+> 从远端 git 仓库安装 skill（位置参数是仓库内路径；认证用本机 git 凭证）
 
 ```bash
 omk install --git-url https://github.com/org/repo.git --git-ref v1.0.0 skills/review
 ```
 
-## omk list
-
-列出受管 skill 及其证据状态：生命周期（installed / measurable / promoted / stale）、最新 verdict、证据数、源。
-
-**用法:**
-
-```bash
-omk list [flags]
-```
-
-**Flags:**
-
-- `--global` `boolean`:看全局受管目录（~/.oh-my-knowledge/governance/managed）而非项目 .omk/governance/managed
-- `--json` `boolean`:输出 JSON（含完整可比性 marker），供脚本消费
-- `--lang` `option`:输出语言 zh|en，优先级 CLI > OMK_LANG env > 全局设置 > 系统 locale > zh。
-
-**示例:**
-
-> 列出当前项目的受管 skill
-
-```bash
-omk list
-```
-
-> 列出全局受管 skill
-
-```bash
-omk list --global
-```
-
-> 机器可读 JSON 输出
-
-```bash
-omk list --json
-```
-
 ## omk observe
 
 把 Codex、Claude Code、OpenClaw 或 markdown trace 统一为 Trace IR，分析 skill 调用健康度（默认行为）。子命令：ingest / inbox / show。
@@ -470,7 +433,6 @@ omk observe [sessionsDir] [flags]
 
 **Flags:**
 
-- `--feedback` `boolean`:把生产健康观测反哺已纳管的同名 skill（--no-feedback 关闭）
 - `--from` `option`:起始时间 ISO，优先级高于 --last
 - `--global` `boolean`:写全局 ~/.oh-my-knowledge/observe/health，而非项目 .omk/observe/health
 - `--kb` `option`:知识库 root，启用 KB-aware 分析
@@ -547,23 +509,31 @@ omk observe knowledge <operation> [flags]
 
 **参数:**
 
-- `operation`(必填):操作：归档、生成、运行列表、恢复、列表、详情、保留、舍弃、修订、来源或删除来源。
+- `operation`(必填):归档、提炼、核对与维护知识；entities 核对实体，correct-entities 纠正实体，apply-entities 创建绑定实体的知识修订。
 
 **Flags:**
 
+- `--analysis` `option`:entities：读取指定分析，省略时检索工作区实体；纠正或应用时必填，与提炼运行身份一致。
 - `--end-record` `option`:最后一条记录序号，包含。
+- `--entity-revision` `option`:实体分析的明确修订身份；纠正或应用时必填。
 - `--executor` `option`:生成执行器，沿用 OMK 的运行配置。
 - `--generation` `option`:修改前读取的 generation，用于检测并发冲突。
 - `--id` `option`:知识身份；resume 时为运行身份。
-- `--input` `option`:revise：包含 title、content、entities、evidence 的 JSON 草稿。
+- `--identity-status` `all|proposed|unresolved`:entities：筛选身份对应状态。
+- `--identity-uncertainties` `option`:apply-entities：显式核对后的附加身份不确定性 JSON 数组；省略时保留原说明，[] 清除原说明，当前实体歧义仍自动保留。
+- `--input` `option`:revise／apply-entities：知识 JSON 草稿；correct-entities：entities、mentions 草稿，新身份使用 new: 前缀。
 - `--json` `boolean`:输出完整 JSON；默认输出可读摘要。
 - `--lang` `option`:输出语言 zh|en，优先级 CLI > OMK_LANG env > 全局设置 > 系统 locale > zh。
 - `--model` `option`:生成模型，沿用已配置模型。
+- `--page` `option`:entities：检索页码，从 1 开始。
+- `--page-size` `option`:entities：每页对象数，默认 20，最多 100。
+- `--query` `option`:entities：搜索名称、原文提及、限定条件及来源。
 - `--reason` `option`:保留、舍弃或修订的理由。
 - `--revision` `option`:查看或处理的明确修订身份。
 - `--run-id` `option`:generate：稳定 UUID，用于重试同一次运行。
 - `--snapshot` `option`:generate／source／delete-source：归档身份。
 - `--source` `option`:capture：一份已支持格式的 Agent 会话日志（Codex／Claude／Qoder 等）。
+- `--source-status` `all|available|unavailable`:entities：筛选原文可用状态。
 - `--start-record` `option`:从零开始的非空记录序号，包含。
 - `--workspace` `option`:本地知识工作区，默认使用全局设置；CLI 与 Studio 共用。
 
@@ -581,107 +551,33 @@ omk observe knowledge generate --workspace ./knowledge --snapshot <snapshot-id>
 omk observe knowledge list --workspace ./knowledge
 ```
 
-## omk observe show
-
-展开 observation inbox 中某条 item 的详情。
-
-**用法:**
-
 ```bash
-omk observe show <inboxId> [flags]
+omk observe knowledge entities --workspace ./knowledge --analysis <run-id>
 ```
 
-**参数:**
-
-- `inboxId`(必填):inbox item ID。
-
-**Flags:**
-
-- `--global` `boolean`:直接读取全局 ~/.oh-my-knowledge/observe/inbox（跳过项目级与兜底）。
-- `--input-dir` `option`:inbox 数据目录
-- `--lang` `option`:输出语言 zh|en，优先级 CLI > OMK_LANG env > 全局设置 > 系统 locale > zh。
-
-## omk promote
-
-把受管 skill 的当前版本按证据门禁「接受」为 promoted：默认仅放行 verdict=PROGRESS,在记录里追加一条带证据指针的人工决定。
-
-**用法:**
-
-```bash
-omk promote <name> [flags]
-```
-
-**参数:**
-
-- `name`(必填):受管 skill 名（omk list 里的 NAME）
-
-**Flags:**
-
-- `--accept-cautious` `boolean`:把 CAUTIOUS 也算可接受（默认仅 PROGRESS）
-- `--actor` `option`:决定的 actor（默认取 git config user.name）
-- `--force` `boolean`:越过可越门拦截强制 promote，记为人工 override 决定（无当前证据或源 hash 已变时仍拒）
-- `--global` `boolean`:操作全局受管目录而非项目 .omk/governance/managed
-- `--json` `boolean`:输出 JSON（版本化信封）供脚本消费
-- `--kind` `option` (默认 `skill`):artifact 类型（当前仅 skill）
-- `--lang` `option`:输出语言 zh|en，优先级 CLI > OMK_LANG env > 全局设置 > 系统 locale > zh。
-- `--reason` `option`:promote / 越门的理由（写入决定）
-
-**示例:**
-
-> promote 一个证据达标的 skill
-
-```bash
-omk promote review
-```
-
-> 接受 CAUTIOUS 结果（显式放宽门禁）
-
 ```bash
-omk promote review --accept-cautious
+omk observe knowledge entities --workspace ./knowledge --query Atlas --json
 ```
 
-> 越门 promote 并记录理由（人工 override）
-
-```bash
-omk promote review --force --reason "已人工复核"
-```
-
-## omk rollback
+## omk observe show
 
-回退受管 skill 当前版本的 promoted 接受：撤销最近一次 promote，在记录里追加一条 rollback 决定（源未漂移则状态回到 measurable，源已漂移则仍 stale）。
+展开 observation inbox 中某条 item 的详情。
 
 **用法:**
 
 ```bash
-omk rollback <name> [flags]
+omk observe show <inboxId> [flags]
 ```
 
 **参数:**
 
-- `name`(必填):受管 skill 名（omk list 里的 NAME）
+- `inboxId`(必填):inbox item ID。
 
 **Flags:**
 
-- `--actor` `option`:决定的 actor（默认取 git config user.name）
-- `--global` `boolean`:操作全局受管目录而非项目 .omk/governance/managed
-- `--json` `boolean`:输出 JSON（版本化信封）供脚本消费
-- `--kind` `option` (默认 `skill`):artifact 类型（当前仅 skill）
+- `--global` `boolean`:直接读取全局 ~/.oh-my-knowledge/observe/inbox（跳过项目级与兜底）。
+- `--input-dir` `option`:inbox 数据目录
 - `--lang` `option`:输出语言 zh|en，优先级 CLI > OMK_LANG env > 全局设置 > 系统 locale > zh。
-- `--reason` `option`:回退的理由（写入决定）
-
-**示例:**
-
-> 回退一个已 promoted 的 skill
-
-```bash
-omk rollback review
-```
-
-> 回退并记录理由
-
-```bash
-omk rollback review --reason "线上发现回归"
-```
 
 ## omk sample
 
@@ -748,7 +644,7 @@ omk studio [flags]
 - `--analyses-dir` `option`:观测健康报告目录（可选，默认项目级 .omk/observe/health，空则全局兜底）
 - `--dev` `boolean`:dev 模式：子进程启动 + 热更新
 - `--doctors-dir` `option`:体检报告目录（可选，默认项目级 .omk/doctor，空则全局兜底）
-- `--global` `boolean`:只看全局 eval / observe/health / doctor / observe/inbox 目录（~/.oh-my-knowledge/），而非机器级聚合 / 项目优先；governance/managed 不受影响
+- `--global` `boolean`:只看全局 eval / observe/health / doctor / observe/inbox 目录（~/.oh-my-knowledge/），而非机器级聚合 / 项目优先
 - `--host` `option`:监听 host，默认 localhost。改为 0.0.0.0 暴露给局域网
 - `--lang` `option`:输出语言 zh|en，优先级 CLI > OMK_LANG env > 全局设置 > 系统 locale > zh。
 - `--no-open` `boolean`:不自动打开浏览器
@@ -784,4 +680,4 @@ omk studio --port 8080 --no-open
 | `evaluationContext` | 否 | `rubric`、`assertions`、评分 `reference`、结构化 `checks` |
 | `annotations` | 否 | 来源、难度、能力、覆盖锚点和诱错标记 |
 
-完整契约与能力边界见 [样本格式](https://github.com/lizhiyao/oh-my-knowledge/blob/main/docs/zh/reference/eval-sample-format.md)。
+完整契约与能力边界见 [样本格式](https://github.com/lizhiyao/oh-my-knowledge/blob/main/docs/zh/reference/evaluation/eval-sample-format.md)。

package/dist/cli/commands/eval/index.d.ts

@@ -62,7 +62,6 @@ export default class Eval extends BaseCommand {
         'trivial-diff': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'report-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'no-gate': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'no-evidence': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/cli/commands/eval/index.js

@@ -406,12 +406,6 @@ export default class Eval extends BaseCommand {
         'no-gate': Flags.boolean({
             description: bilingual({ zh: '关闭判定门禁', en: 'Disable verdict gate' }),
         }),
-        'no-evidence': Flags.boolean({
-            description: bilingual({
-                zh: '不把本次评测写成证据追加进受管记录(默认会为已 install 的 skill 自动写)。',
-                en: 'Do not append this run as evidence to managed records (auto-written for installed skills by default).',
-            }),
-        }),
     };
     async run() {
         const { args, flags } = await this.parse(Eval);

package/dist/cli/commands/evolve.js

@@ -7,18 +7,7 @@ import { CliExit } from '../lib/cli-exit.js';
 import { tCli } from '../lib/i18n.js';
 import { formatSampleGenerationFailureHint } from '../lib/generation-failure-hint.js';
 import { ensureSkillSamples, SamplePreparationError } from '../../eval-workflows/sample-generation/skill-samples.js';
-import { sanitizeCell } from '../lib/cell-format.js';
 import { envJudgeModels, resolveRuntimeSelection } from '../lib/runtime-defaults.js';
-async function recordEvolveOutcomeSafely(input) {
-    try {
-        const { recordCoreEvolveOutcome } = await import('../../knowledge-artifacts/governance/evolve-outcome.js');
-        const value = recordCoreEvolveOutcome(input);
-        return value ? { status: 'recorded', value } : { status: 'not-applicable' };
-    }
-    catch (error) {
-        return { status: 'failed', error };
-    }
-}
 const VALID_EFFORTS = new Set(['low', 'medium', 'high', 'xhigh', 'max']);
 function validateEvolveEffort(raw, lang) {
     if (!VALID_EFFORTS.has(raw)) {
@@ -46,8 +35,6 @@ export async function runEvolve(args, flags, lang, signal) {
         throw new CliExit(1);
     }
     const skillPath = resolvedInput.skillPath;
-    // evolve 目标的形态(目录-skill / 文件-skill),供受管联动按形态精确匹配记录。**取解析后形态**而非「入参是不是
-    // 目录」:帮助文档鼓励传 `skills/foo/SKILL.md`,若按入参判会得 false、匹配不到 install 落的目录记录(漂移永不消)。
     const skillIsDir = resolvedInput.isDirectorySkill;
     const samplesFile = resolvedInput.samplesPath;
     // 参数校验必须早于任何昂贵副作用(自动生成用例 / LLM 调用)。
@@ -119,7 +106,6 @@ export async function runEvolve(args, flags, lang, signal) {
         timeout: Math.max(1, Math.ceil(Number(flags.timeout) || 600)),
         effort: evolveEffort,
         'skip-doctor': flags['skip-doctor'],
-        'no-evidence': true,
         'no-serve': true,
         'report-only': true,
     }, { lang });
@@ -143,7 +129,7 @@ export async function runEvolve(args, flags, lang, signal) {
             evaluatePair,
             editBudget: flags['no-edit-budget'] ? 0 : Number(flags['edit-budget']),
             rejectMemory: !flags['no-reject-memory'],
-            // --snapshot-only:不写回 source,候选只留在 evolve/<skillName>.r{N}.md(供人工挑选 / promote)。
+            // --snapshot-only:不写回 source,候选只留在 evolve/<skillName>.r{N}.md（供人工挑选）。
             writeBackToSource: !flags['snapshot-only'],
             improveMode: flags['improve-mode'] === 'rewrite' ? 'rewrite' : 'agent',
             onRoundProgress({ round, totalRounds: _totalRounds, phase, score, delta, accepted, costUSD, costReported, error, decisionAccepted }) {
@@ -189,36 +175,12 @@ export async function runEvolve(args, flags, lang, signal) {
             process.stderr.write(tCli('cli.evolve.report_link', lang, { id: result.runId }));
         }
         if (flags['snapshot-only']) {
-            // 不写回 source —— 候选留在 evolve/ 供人工挑选;受管记录不动。
+            // 不写回 source —— 候选留在 evolve/ 供人工挑选。
             process.stderr.write(tCli('cli.evolve.snapshot_only_hint', lang, {
                 dir: join(resolve(skillPath, '..'), 'evolve'),
             }));
         }
-        else {
-            // 受管 skill:把胜出版本记成带 verdict 的证据 + re-baseline → omk list 显 measurable。
-            // 升 promoted 仍由人 omk promote 决定(统计门 ≠ 人的接受)。未纳管 / 无改进 → 静默 no-op。
-            const recorded = await recordEvolveOutcomeSafely({
-                source: result.evidence,
-                bestRound: result.bestRound,
-                skillPath: resolvedInput.skillPath,
-                skillDir: resolvedInput.skillDir,
-                isDirectorySkill: skillIsDir,
-            });
-            if (recorded.status === 'failed') {
-                const message = sanitizeCell(recorded.error instanceof Error ? recorded.error.message : String(recorded.error));
-                process.stderr.write(lang === 'zh'
-                    ? `治理证据写入失败：${message}。评测产物已保留，请检查受管目录后补记证据。\n`
-                    : `Managed evidence write failed: ${message}. Evaluation artifacts are preserved; check the managed directory and record the evidence again.\n`);
-            }
-            if (recorded.status === 'recorded') {
-                process.stderr.write(tCli('cli.evolve.evidence_recorded_managed', lang, {
-                    name: recorded.value.name, verdict: recorded.value.verdict,
-                }));
-            }
-        }
-        const publicResult = { ...result };
-        delete publicResult.evidence;
-        console.log(JSON.stringify(publicResult, null, 2));
+        console.log(JSON.stringify(result, null, 2));
     }
     catch (err) {
         if (err instanceof CliExit)
@@ -334,8 +296,8 @@ export default class Evolve extends BaseCommand {
         }),
         'snapshot-only': Flags.boolean({
             description: bilingual({
-                zh: '只产候选、不写回 source：胜出版本留在 evolve/，再由你人工选择。受管 skill 默认会写回 source 并记 Core 证据。',
-                en: 'Produce candidates under evolve/ without writing the source. Managed skills normally write back only after a final Core gate and record Core evidence.',
+                zh: '只产候选、不写回 source：胜出版本留在 evolve/，再由你人工选择。默认仅在最终 Core 门禁通过后写回 source。',
+                en: 'Produce candidates under evolve/ without writing the source. By default, write back only after a final Core gate passes.',
             }),
             default: false,
         }),

package/dist/cli/commands/init.js

@@ -12,7 +12,7 @@ import { DEFAULT_INIT_SAMPLE_COUNT, FULL_INIT_SAMPLE_COUNT, serializeInitSamples
 // 项目从注释到 skill 正文都是中文。name／目录名等身份字段两版一致，只有文字随语言。
 const INIT_OMK_GITIGNORE = {
     // 预置 .omk/.gitignore:测量 bulk + doctor --fix 备份(项目本地、不该入库)默认不入库;
-    // managed/ 治理档案 + 配置不在此列,默认 track。
+    // 配置不在此列，默认 track。
     zh: `# omk 测量 bulk 与 doctor --fix 备份（项目本地）——不入库；前导 / 锚定 .omk/ 顶层，不误伤嵌套同名目录。
 /eval/
 /doctor/

package/dist/cli/commands/install.d.ts

@@ -20,5 +20,5 @@ export default class Install extends BaseCommand {
     };
     run(): Promise<void>;
     private installBuiltinAgentSkill;
-    private installManagedSkill;
+    private installUserSkill;
 }

package/dist/cli/commands/install.js

@@ -7,19 +7,7 @@ import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
 import { tCli } from '../lib/i18n.js';
 import { resolveInstallSource, resolveRemoteGitSource, usingInstallSource, SourceResolveError } from '../../knowledge-artifacts/sources/install-source.js';
-import { managedDir } from '../../knowledge-artifacts/governance/index.js';
-import { installManagedArtifact, InstallRegistrationError } from '../../knowledge-artifacts/governance/install.js';
 import { replaceDeployedArtifact } from '../../knowledge-artifacts/sources/deploy-artifact.js';
-function localizeInstallationError(error, lang) {
-    if (error instanceof InstallRegistrationError && lang === 'zh') {
-        return new Error(`分发已完成，但治理登记失败：${error.paths.join('、')}。请修复受管目录 ${error.store} 后，以相同参数加 --force 重试登记。`, { cause: error });
-    }
-    if (error instanceof AggregateError) {
-        const errors = error.errors.map((item) => localizeInstallationError(item, lang));
-        return new AggregateError(errors, errors.map(String).join('; '));
-    }
-    return error;
-}
 const BUILTIN_OMK_AGENT_SKILL_ID = 'omk-agent-skill';
 const INSTALLABLE_KINDS = ['skill', 'prompt', 'agent', 'workflow'];
 const TARGET_ORDER = ['codex', 'claude'];
@@ -110,7 +98,7 @@ function targetArtifactPath(target, name, isDirectorySkill) {
 function targetSkillDir(target) {
     return targetArtifactPath(target, 'omk', true);
 }
-/** 全部目标预检通过才拷任何一个(无部分安装)。源就是目标(就地接管)的目标跳过存在性检查。 */
+/** 全部目标预检通过才拷任何一个(无部分安装)。源就是目标(已在目标位置)的目标跳过存在性检查。 */
 function validateInstallTargets(params) {
     if (params.dryRun || params.force)
         return;
@@ -138,7 +126,7 @@ function realPathBestEffort(p) {
 }
 /**
  * 源与目标的物理关系(解析软链):
- *   - same:同一节点 → 就地接管(绝不删/拷);
+ *   - same:同一节点 → 已在目标位置(绝不删/拷);
  *   - overlap:一个是另一个的祖先 → rmSync(target) 会删掉源、或 cpSync 把目录拷进自身子目录,数据损坏,必须拒;
  *   - disjoint:正常拷贝。
  */
@@ -153,7 +141,7 @@ function classifyPaths(source, targetPath) {
 }
 /**
  * 通用拷贝:目录递归 cp(过滤 .omk / .git / evolve 等非分发产物 + 软链)、单文件 copyFile。
- * 清理失败单独提示，正常结果由调用方呈现。dry-run 不写。源即目标 → 就地接管(inPlace);重叠路径拒绝。
+ * 清理失败单独提示，正常结果由调用方呈现。dry-run 不写。源即目标 → 已在目标位置(inPlace);重叠路径拒绝。
  */
 function copyArtifactToTarget(params) {
     if (!existsSync(params.source)) {
@@ -163,7 +151,7 @@ function copyArtifactToTarget(params) {
         return { targetPath: params.targetPath, planned: true, inPlace: false };
     }
     const relation = classifyPaths(params.source, params.targetPath);
-    // 就地接管:源就是目标(接管已安装的 skill),绝不 rmSync 源。
+    // 已在目标位置:源就是目标(接管已安装的 skill),绝不 rmSync 源。
     if (relation === 'same') {
         return { targetPath: params.targetPath, planned: false, inPlace: true };
     }
@@ -188,7 +176,6 @@ function installOmkAgentSkill(params) {
         source: params.sourceDir,
         isDirectorySkill: true,
         targetPath: targetDir,
-        skillsDir: params.target.skillsDir,
         force: params.force,
         dryRun: params.dryRun,
         lang: params.lang,
@@ -198,7 +185,7 @@ function installOmkAgentSkill(params) {
 }
 /**
  * 是否当作用户 artifact 路径(否则按 typo 的内置 id 处理,报 unknown_input)。
- *   - 显式路径意图(含 `/`)或 `.md` 结尾 → 是(后续 installManagedSkill 经 resolver 给出精确的存在性 / SKILL.md 报错);
+ *   - 显式路径意图(含 `/`)或 `.md` 结尾 → 是(后续 installUserSkill 经 resolver 给出精确的存在性 / SKILL.md 报错);
  *   - 裸短名 → 仅当它确实解析到一个含 SKILL.md 的目录才算;裸的同名普通文件(如 cwd 里恰好有个
  *     `omk-agnt-skill` 文件)不该被当成 skill 安装,落回 unknown_input。
  */
@@ -215,8 +202,8 @@ function looksLikeArtifactPath(input) {
 }
 export default class Install extends BaseCommand {
     static description = bilingual({
-        zh: '安装 omk 官方 Agent Skill，或登记并分发用户自己的 skill（内置 id omk-agent-skill，本地路径，或 git:<ref>:<name> 取当前仓库某个 ref 的 skill）。默认写入本机已检测 agent 目标；安装用户 skill 时同时登记一条受管记录。',
-        en: 'Install the official omk Agent Skill, or register and distribute your own skill (built-in id omk-agent-skill, a local path, or git:<ref>:<name> for a skill at a ref of the current repo). Defaults to detected local agent targets; installing a user skill also records a managed entry.',
+        zh: '安装 omk 官方 Agent Skill，或安装用户自己的 skill（内置 id omk-agent-skill，本地路径，或 git:<ref>:<name> 取当前仓库某个 ref 的 skill）。默认写入本机已检测 agent 目标。',
+        en: 'Install the official omk Agent Skill, or install your own skill (built-in id omk-agent-skill, a local path, or git:<ref>:<name> for a skill at a ref of the current repo). Defaults to detected local agent targets.',
     });
     static examples = [
         {
@@ -242,8 +229,8 @@ export default class Install extends BaseCommand {
         },
         {
             description: bilingual({
-                zh: '登记并分发用户自己的 skill（--kind 可省，命中 SKILL.md 自动推导）',
-                en: 'Register and distribute your own skill (--kind optional; inferred from SKILL.md)',
+                zh: '安装用户自己的 skill（--kind 可省，命中 SKILL.md 自动推导）',
+                en: 'Install your own skill (--kind optional; inferred from SKILL.md)',
             }),
             command: '<%= config.bin %> install ./skills/review',
         },
@@ -256,8 +243,8 @@ export default class Install extends BaseCommand {
         },
         {
             description: bilingual({
-                zh: '从远端 git 仓库安装 skill（位置参数是仓库内路径；认证用本机 git 凭证；记录钉实际 SHA）',
-                en: 'Install a skill from a remote git repo (positional arg is the in-repo path; auth via local git credentials; record pins the actual SHA)',
+                zh: '从远端 git 仓库安装 skill（位置参数是仓库内路径；认证用本机 git 凭证）',
+                en: 'Install a skill from a remote git repo (positional arg is the in-repo path; auth via local git credentials)',
             }),
             command: '<%= config.bin %> install --git-url https://github.com/org/repo.git --git-ref v1.0.0 skills/review',
         },
@@ -330,7 +317,7 @@ export default class Install extends BaseCommand {
             }
             // 远端 git:--git-url 在场时,位置参数是仓库内 spec(repo 相对路径),先于其它分支判定。
             if (flags['git-url']) {
-                this.installManagedSkill(args.input, flags.kind, flags, lang, {
+                this.installUserSkill(args.input, flags.kind, flags, lang, {
                     url: flags['git-url'],
                     ref: flags['git-ref'] || 'HEAD',
                 });
@@ -341,7 +328,7 @@ export default class Install extends BaseCommand {
                 return;
             }
             if (args.input.startsWith('git:') || looksLikeArtifactPath(args.input)) {
-                this.installManagedSkill(args.input, flags.kind, flags, lang);
+                this.installUserSkill(args.input, flags.kind, flags, lang);
                 return;
             }
             throw new Error(tCli('cli.install.unknown_input', lang, { input: args.input }));
@@ -362,7 +349,7 @@ export default class Install extends BaseCommand {
         if (!flags['dry-run'])
             console.log(tCli('cli.install.next_hint', lang));
     }
-    installManagedSkill(input, kindFlag, flags, lang, remote) {
+    installUserSkill(input, kindFlag, flags, lang, remote) {
         // kind 推导:--kind 显式优先;否则缺省 skill(Phase 1 仅 skill)。
         const kind = kindFlag ?? 'skill';
         if (kind !== 'skill') {
@@ -391,35 +378,18 @@ export default class Install extends BaseCommand {
                 lang,
                 source: localRoot,
             });
-            const store = managedDir();
-            try {
-                installManagedArtifact({
-                    source: src,
-                    artifactKind: kind,
-                    targets: targets.map((target) => ({ label: target.label, path: targetArtifactPath(target, name, isDirectorySkill) })),
-                    store,
-                    installedAt: new Date().toISOString(),
-                    deploy: (target) => {
-                        const { planned, inPlace } = copyArtifactToTarget({
-                            source: localRoot,
-                            isDirectorySkill,
-                            targetPath: target.path,
-                            skillsDir: dirname(target.path),
-                            force: flags.force,
-                            dryRun: flags['dry-run'],
-                            lang,
-                        });
-                        return planned ? 'planned' : inPlace ? 'adopted' : 'copied';
-                    },
-                    onDeployment: (target, result) => {
-                        const key = result === 'planned' ? 'cli.install.plan_skill' : result === 'adopted' ? 'cli.install.adopted' : 'cli.install.copied';
-                        console.log(tCli(key, lang, { name, path: target.path }));
-                    },
-                    onRegistered: (record) => console.log(tCli('cli.install.registered', lang, { id: record.id, store })),
+            for (const target of targets) {
+                const targetPath = targetArtifactPath(target, name, isDirectorySkill);
+                const { planned, inPlace } = copyArtifactToTarget({
+                    source: localRoot,
+                    isDirectorySkill,
+                    targetPath,
+                    force: flags.force,
+                    dryRun: flags['dry-run'],
+                    lang,
                 });
-            }
-            catch (error) {
-                throw localizeInstallationError(error, lang);
+                const key = planned ? 'cli.install.plan_skill' : inPlace ? 'cli.install.adopted' : 'cli.install.copied';
+                console.log(tCli(key, lang, { name, path: targetPath }));
             }
         });
     }

package/dist/cli/commands/observe/index.d.ts

@@ -17,7 +17,6 @@ export default class Observe extends BaseCommand {
         skills: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        feedback: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }