---
name: terminal-ops
description: 基于证据优先的仓库执行工作流，适用于ECC。当用户需要运行命令、检查仓库、调试CI失败或推送带有精确执行和验证证明的窄修复时使用。
origin: ECC
---

# 终端操作

当用户需要真实的仓库执行时使用此技能：运行命令、检查 git 状态、调试 CI 或构建、进行窄幅修复，并准确报告更改和验证的内容。

此技能有意比通用编码指导更窄。它是一种以证据为先的终端执行操作工作流。

## 技能栈

在相关时，将这些 ECC 原生技能引入工作流：

* `verification-loop` 用于更改后的精确验证步骤
* `tdd-workflow` 当正确的修复需要回归覆盖时
* `security-review` 当涉及密钥、认证或外部输入时
* `github-ops` 当任务依赖于 CI 运行、PR 状态或发布状态时
* `knowledge-ops` 当需要将验证结果捕获到持久的项目上下文中时

## 使用时机

* 用户说"修复"、"调试"、"运行这个"、"检查仓库"或"推送它"
* 任务依赖于命令输出、git 状态、测试结果或已验证的本地修复
* 答案必须区分：本地已更改、本地已验证、已提交和已推送

## 安全护栏

* 先检查再编辑
* 如果用户仅要求审计/审查，则保持只读
* 优先使用仓库本地的脚本和辅助工具，而非即兴的临时封装
* 在验证命令重新运行之前，不得声称已修复
* 除非分支确实已推送到上游，否则不得声称已推送

## 工作流

### 1. 确定工作表面

明确：

* 确切的仓库路径
* 分支
* 本地差异状态
* 请求的模式：
  * 检查
  * 修复
  * 验证
  * 推送

### 2. 首先读取失败表面

在更改任何内容之前：

* 检查错误
* 检查文件或测试
* 检查 git 状态
* 在盲目重新读取之前，使用任何已提供的日志或上下文

### 3. 保持修复的窄幅

一次解决一个主要失败：

* 首先使用最小的有用验证命令
* 仅在本地失败解决后，才升级到更大的构建/测试流程
* 如果某个命令持续以相同特征失败，停止广泛重试并缩小范围

### 4. 报告确切的执行状态

使用确切的状态词：

* 已检查
* 本地已更改
* 本地已验证
* 已提交
* 已推送
* 已阻塞

## 输出格式

```text
表面
- 仓库
- 分支
- 请求模式

证据
- 失败的命令 / 差异 / 测试

操作
- 变更内容

状态
- 已检查 / 本地已更改 / 本地已验证 / 已提交 / 已推送 / 已阻止
```

## 陷阱

* 当可以读取实时仓库状态时，不要依赖过时的记忆
* 不要将窄幅修复扩大为仓库范围的变动
* 不要使用破坏性的 git 命令
* 不要忽略不相关的本地工作

## 验证

* 响应中需指明验证命令或测试
* 与 git 相关的工作需指明仓库路径和分支
* 任何推送声明需包含目标分支和确切结果
