| name | dev-ocs |
| description | 运维操作中心(Operations Center)通用适配器——为团队的运营/运维操作(开关、灰度、限流、降级)提供统一调用约定。具体实现按团队接入。 |
| allowed-tools | Read, Bash |
Skill: dev-ocs
原文 §8.3 工程工具类。适配器型 Skill——本仓只定义协议与契约,具体后端由各团队对接。
设计目标
把"按按钮"类操作(在团队私有运营平台执行)抽象为结构化 Intent + 审计记录:
Intent → 确认 → 执行 → 记录
Intent 规格
intent: switch.toggle
target:
feature: tag-grant
scope: scenario=campaign-618
operation: enable|disable|grayscale
parameters:
ratio: 0.01
whitelist: [u1, u2]
reason: "灰度第一阶段 1%"
related:
requirement: T12345
ft: FT-002
通用工作流
- 校验 Intent schema 合法
- 查询权限(依赖团队的 RBAC)
- 人类二次确认(任何写操作必须)
- 执行(通过团队的 ocs CLI / API / MCP)
- 审计记录写到
requirements/{p}/{r}/ops/{ts}-{intent}.md
默认操作命名空间
| 命名空间 | 用途 |
|---|
switch.* | feature flag 开关 |
gray.* | 灰度比例调整 |
limit.* | 限流阈值调整 |
degrade.* | 降级开关 |
data.* | 数据迁移触发 |
monitor.* | 告警阈值临时调整 |
团队接入
团队需在 .harness/local.yaml 添加:
ocs:
endpoint: https://ops.example.com/api
auth_token_env: OCS_TOKEN
反模式
- ❌ 无 reason 字段就执行
- ❌ 跳过人类二次确认
- ❌ 操作不写审计记录
- ❌ 把 token 写到代码或日志