beo-reference

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Beo Reference

Beo 参考

Complete reference for the CLI-driven beo workflow. Load this skill when another beo skill says "see beo-reference" or when you need lookup tables for status mapping, artifact protocol, or CLI commands.

This skill is the canonical source for shared beo workflow conventions. When another beo skill and a shared protocol seem to disagree, reconcile against the reference files here rather than inventing a hybrid rule.

这是CLI驱动的beo工作流的完整参考。当其他beo skill注明“参见beo-reference”，或者你需要查询状态映射、工件协议或CLI命令的查找表时，请加载本skill。

本skill是beo共享工作流约定的权威来源。如果其他beo skill的内容与共享协议出现分歧，请参考此处的参考文件进行协调，不要自行创建混合规则。

Source of Truth Rule

事实源规则

Use this reference layer as the maintenance anchor for shared beo behavior.

update shared protocol docs here before or alongside dependent skill summaries
when a skill body and a shared protocol disagree, the shared protocol wins
keep high-risk shared concepts centralized here: approval rules, status mapping, state/handoff shape, slug safety, artifact semantics, dependency conventions
dependent skills should summarize these rules, not fork them

将本参考层作为beo共享行为的维护锚点：

在更新依赖skill的说明之前或同时，在此处更新共享协议文档
当skill内容与共享协议不一致时，以共享协议为准
将高风险的共享概念集中维护在此处：审批规则、状态映射、状态/交接结构、slug安全、工件语义、依赖约定
依赖skill应当对这些规则进行摘要说明，而非自行分叉修改

Default Use Rule

默认使用规则

Load

beo-reference

whenever another beo skill:

says to use the canonical rule
points to a shared protocol or lookup table
depends on status mapping, slug safety, approval gates, handoff format, or artifact semantics

当其他beo skill出现以下情况时，请加载

beo-reference

：

注明使用标准规则
指向共享协议或查找表
依赖状态映射、slug安全、审批关口、交接格式或工件语义

Quick Routing Guide

快速路由指南

Need exact
```
br
```
syntax ->
```
references/br-cli-reference.md
```
Need exact
```
bv
```
syntax ->
```
references/bv-cli-reference.md
```
Need approval behavior ->
```
references/approval-gates.md
```

Need

STATE.md

HANDOFF.json

shape ->

references/state-and-handoff-protocol.md

Need task or epic status interpretation ->
```
references/status-mapping.md
```
Need artifact storage or read/write protocol ->
```
references/artifact-protocol.md
```
Need slug preservation or artifact path safety ->
```
references/slug-protocol.md
```
Need dependency or scheduling rules ->
```
references/dependency-and-scheduling.md
```

需要准确的
```
br
```
语法 ->
```
references/br-cli-reference.md
```
需要准确的
```
bv
```
语法 ->
```
references/bv-cli-reference.md
```
需要审批行为说明 ->
```
references/approval-gates.md
```

需要

STATE.md

HANDOFF.json

结构说明 ->

references/state-and-handoff-protocol.md

需要任务或史诗状态释义 ->
```
references/status-mapping.md
```
需要工件存储或读写协议说明 ->
```
references/artifact-protocol.md
```
需要slug保留或工件路径安全说明 ->
```
references/slug-protocol.md
```
需要依赖或调度规则说明 ->
```
references/dependency-and-scheduling.md
```

Planning-Aware Notes

规划相关说明

The shared references now distinguish between:

```
approach.md
```
as the strategy artifact
```
phase-plan.md
```
as the optional whole-feature sequencing artifact for multi-phase work
```
phase-contract.md
```
and
```
story-map.md
```
as current-phase artifacts

When a feature is multi-phase, use the shared references to avoid treating current-phase artifacts as whole-feature artifacts.

目前共享参考对以下工件进行了区分：

```
approach.md
```
作为策略工件
```
phase-plan.md
```
作为多阶段工作可选的全功能序列工件
```
phase-contract.md
```
和
```
story-map.md
```
作为当前阶段工件

当功能涉及多阶段时，请参考共享约定，避免将当前阶段工件误认为全功能工件。

Quick Navigation

快速导航

Need	Reference File
Run a br command	`references/br-cli-reference.md`
Run a bv command	`references/bv-cli-reference.md`
Map task status to br commands	`references/status-mapping.md`
Read/write task artifacts	`references/artifact-protocol.md`
Use canonical Markdown templates for bead descriptions	`references/bead-description-templates.md`
Preserve and recover feature slugs	`references/slug-protocol.md`
Read/write STATE.md and HANDOFF.json safely	`references/state-and-handoff-protocol.md`
Read prior learnings before planning/debugging/validation	`references/learnings-read-protocol.md`
Apply canonical human approval rules	`references/approval-gates.md`
Sync dependencies or check scheduling	`references/dependency-and-scheduling.md`
Integrate with knowledge store	`references/knowledge-store.md`
Locate pipeline artifacts and state files	`references/file-conventions.md`
State routing, HANDOFF schema, label lifecycle, task enumeration	`references/pipeline-contracts.md`

需求	参考文件
运行br命令	`references/br-cli-reference.md`
运行bv命令	`references/bv-cli-reference.md`
映射任务状态到br命令	`references/status-mapping.md`
读写任务工件	`references/artifact-protocol.md`
使用bead描述的标准Markdown模板	`references/bead-description-templates.md`
保留和恢复功能slug	`references/slug-protocol.md`
安全读写STATE.md和HANDOFF.json	`references/state-and-handoff-protocol.md`
在规划/调试/验证前阅读过往经验总结	`references/learnings-read-protocol.md`
应用标准人工审批规则	`references/approval-gates.md`
同步依赖或检查调度情况	`references/dependency-and-scheduling.md`
与知识库集成	`references/knowledge-store.md`
查找流水线工件和状态文件	`references/file-conventions.md`
状态路由、HANDOFF schema、标签生命周期、任务枚举	`references/pipeline-contracts.md`