affaan-m/terminal-ops

终端操作

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

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

技能栈

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

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

使用时机

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

安全护栏

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

工作流

1. 确定工作表面

明确：

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

2. 首先读取失败表面

在更改任何内容之前：

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

3. 保持修复的窄幅

一次解决一个主要失败：

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

4. 报告确切的执行状态

使用确切的状态词：

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

输出格式

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

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

操作
- 变更内容

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

陷阱

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

验证

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