record

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Record Business Artifact

记录业务工件

Write a structured markdown file to
.oh/
with YAML frontmatter. Use the templates below for each type.
编写带YAML前置元数据的结构化Markdown文件并保存至
.oh/
目录。针对不同类型,使用以下对应模板。

Arguments

参数说明

$ARGUMENTS
should be:
<type> <slug> [options]
Example:
/rna-mcp:record metis protocol-mismatch-hangs
$ARGUMENTS
的格式应为:
<类型> <别名> [选项]
示例:
/rna-mcp:record metis protocol-mismatch-hangs

Templates

模板

Metis (learning)

Metis(经验总结)

Write to
.oh/metis/<slug>.md
:
markdown
---
id: <slug>
title: "<title>"
outcome: <related-outcome-id>
---

<body  what was learned and why it matters>
写入至
.oh/metis/<slug>.md
markdown
---
id: <slug>
title: "<标题>"
outcome: <关联成果ID>
---

<正文  记录所学到的内容及其重要性>

Signal (measurement)

Signal(度量指标)

Write to
.oh/signals/<slug>.md
:
markdown
---
id: <slug>
outcome: <related-outcome-id>
type: slo|metric|qualitative
threshold: "<measurable threshold>"
---

<body  what this measures and how>
写入至
.oh/signals/<slug>.md
markdown
---
id: <slug>
outcome: <关联成果ID>
type: slo|metric|qualitative
threshold: "<可度量阈值>"
---

<正文  说明该指标的度量对象与方式>

Guardrail (constraint)

Guardrail(约束条件)

Write to
.oh/guardrails/<slug>.md
:
markdown
---
id: <slug>
severity: candidate|soft|hard
statement: "<one-line constraint>"
outcome: <related-outcome-id>
---

<body  rationale for this constraint>
写入至
.oh/guardrails/<slug>.md
markdown
---
id: <slug>
severity: candidate|soft|hard
statement: "<单行约束描述>"
outcome: <关联成果ID>
---

<正文  说明该约束条件的制定依据>

Outcome (update existing)

Outcome(更新现有成果)

Edit the existing file at
.oh/outcomes/<slug>.md
— update
status
,
mechanism
, or
files
in the frontmatter.
编辑
.oh/outcomes/<slug>.md
文件的现有内容——更新前置元数据中的
status
mechanism
files
字段。

Process

操作流程

  1. Parse
    $ARGUMENTS
    to determine type and slug
  2. Check if the file already exists — if so, confirm before overwriting (metis/signal/guardrail) or merge updates (outcome)
  3. Read one existing artifact of the same type for frontmatter format reference
  4. Write the file using the Write tool
  5. Confirm: "Recorded <type> at
    .oh/<subdir>/<slug>.md
    "
  1. 解析
    $ARGUMENTS
    以确定类型和别名
  2. 检查文件是否已存在——若存在,对于metis/signal/guardrail需先确认是否覆盖,对于outcome则合并更新内容
  3. 读取一个同类型的现有工件,作为前置元数据格式的参考
  4. 使用Write工具写入文件
  5. 确认提示:“已在
    .oh/<子目录>/<slug>.md
    记录<类型>工件”

Slug Rules

别名规则

  • Lowercase, alphanumeric + hyphens only
  • No path separators (
    /
    ,
    \
    ,
    ..
    )
  • Example:
    protocol-mismatch-hangs
    ,
    agent-scoping-accuracy
  • 仅使用小写字母、数字和连字符
  • 不得包含路径分隔符(
    /
    \
    ..
  • 示例:
    protocol-mismatch-hangs
    agent-scoping-accuracy