/maestro-knowhow

name: maestro-knowhow
disable-model-invocation: true
description: Intent-driven knowhow precipitation — describe what you want to capture (记一个关于X的决策 / 保存这段代码模板 / 写个部署配方 / 存个调试技巧) and the workflow infers the type and records it into .workflow/knowhow/. Pure capture surface; knowhow 的管理/审计走 /maestro-knowledge；项目约束规则走 /maestro-spec add。Triggers on "knowhow capture", "知识沉淀", "沉淀经验", "记录模板", "记录决策", "adr", "存个技巧".
argument-hint: "[intent — e.g. '记录一个 JWT 刷新的决策' | 'template 这段重试代码' | 'tip: redis 管道陷阱']"
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
  - AskUserQuestion
session-mode: brief

<purpose> Intent-driven knowhow precipitation path (沉淀路径) — captures reusable knowledge into `.workflow/knowhow/`. No fixed grammar — state your intent; the `knowhow` step infers the content type and extracts the content. Type keywords still work as deterministic shortcuts:

| Type | Keywords | Prefix | |------|----------|--------| | session | `session` / `compact` / 压缩 | KNW- | | template | `template` / `tpl` / 模板 | TPL- | | recipe | `recipe` / `rcp` / 配方 / 步骤 | RCP- | | reference | `reference` / `ref` / 参考 | REF- | | decision | `decision` / `dcs` / `adr` / 决策 | DCS- | | tip | `tip` / `note` / 技巧 / 记录 | TIP- | </purpose>

<dispatch> Run `maestro run skill knowhow` with the full `$ARGUMENTS` passed through as the user's intent (first arg `capture` is implied). The step infers the content type from the intent, extracts the content, and writes the entry.

• A recognized type keyword anywhere in the intent pins the type deterministically.
• Otherwise the step infers the type from the intent (e.g. "决策/决定用X" → decision, "模板/这段代码" → template, "步骤/怎么部署" → recipe).
• No clear type signal → the step asks the user to pick (6-option picker).
• This command only captures; for knowhow store management use /maestro-knowledge.

</dispatch>