trackops

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TrackOps

Si la conversacion y el proyecto deben trabajar en ingles, lee

locales/en/SKILL.md

antes de seguir.

TrackOps es un sistema local de control y coordinación para desarrollo de software con agentes IA.

Esta skill es la puerta de entrada al sistema. Úsala cuando alguien:

quiere arrancar un proyecto con agentes IA
ya tiene un repo y necesita orden operativo
necesita activar TrackOps y, si hace falta, OPERA
quiere trabajar en espanol o en ingles con el mismo flujo

如果对话和项目需要使用英文进行，请先阅读

locales/en/SKILL.md

再继续。

TrackOps是一款用于AI Agent软件开发的本地控制与协调系统。

本Skill是该系统的入口。当出现以下情况时可以使用它：

想要使用AI Agent启动一个项目
已有仓库，需要操作指令
需要激活TrackOps，必要时还需激活OPERA
希望使用西班牙语或英文完成相同流程

Que hace esta skill

本Skill的功能

Esta skill:

explica qué es TrackOps y cuándo conviene usarlo
exige una instalación explícita y visible del runtime
guía la activación por repositorio
ayuda a decidir si OPERA debe seguir por
```
direct bootstrap
```
o por
```
agent handoff
```
explica que al instalar OPERA se activa un equipo de agentes coordinados por
```
opera-skill
```

本Skill可以：

介绍TrackOps是什么以及适合使用的场景
要求显式、可见地安装runtime
指导按仓库进行激活操作
帮助决定OPERA应选择
```
direct bootstrap
```
还是
```
agent handoff
```
方式
说明安装OPERA后会激活由
```
opera-skill
```
协调的Agent团队

Que no hace esta skill

本Skill不具备的功能

Esta skill no:

instala paquetes por su cuenta
ejecuta codigo remoto en silencio
modifica un repositorio antes de que el runtime exista
sustituye al runtime
```
trackops
```

本Skill不会：

自行安装包
静默执行远程代码
在runtime存在前修改仓库
替代
```
trackops
```
runtime

Flujo rapido

快速流程

Instala la skill del marketplace con:

bash

npx skills add Baxahaun/trackops

Despues, confirma que el runtime

trackops

existe. Si no esta disponible, pide al usuario que lo instale de forma explicita:

bash

npm install -g trackops
trackops --version

Reglas:

la skill no debe instalar paquetes ni ejecutar codigo remoto por si sola
el runtime se instala con un paso visible y auditable
la skill puede verificar
```
trackops --version
```
, pero no debe encadenar instalaciones silenciosas
la skill no debe crear archivos dentro de un repositorio por si sola

通过以下命令从市场安装本Skill：

bash

npx skills add Baxahaun/trackops

之后，确认

trackops

runtime是否存在。如果不可用，请要求用户显式安装：

bash

npm install -g trackops
trackops --version

规则：

Skill不得自行安装包或执行远程代码
runtime需通过可见、可审计的步骤安装
Skill可以检查
```
trackops --version
```
，但不得自动触发静默安装
Skill不得自行在仓库内创建文件

Activacion en un proyecto

项目激活

Dentro del repositorio:

bash

trackops init
trackops opera install

Reglas base:

trata la skill global como capa de instrucciones
trata la instalacion del runtime como explicita y separada
usa
```
ops/contract/operating-contract.json
```
como contrato de maquina cuando exista
usa
```
ops/project_control.json
```
como fuente de verdad operativa
usa
```
ops/policy/autonomy.json
```
antes de acciones sensibles
usa
```
/.env
```
y
```
/.env.example
```
como contrato de entorno
deja la documentacion operativa generada dentro de
```
ops/
```

usa

trackops locale get|set

trackops doctor locale

cuando el idioma importe

在仓库内执行：

bash

trackops init
trackops opera install

基础规则：

将全局Skill视为指令层
将runtime安装视为显式、独立的步骤
当
```
ops/contract/operating-contract.json
```
存在时，将其作为机器契约
将
```
ops/project_control.json
```
作为操作事实的来源
在执行敏感操作前使用
```
ops/policy/autonomy.json
```
将
```
/.env
```
和
```
/.env.example
```
作为环境契约
将生成的操作文档保存在
```
ops/
```
目录下

当语言重要时，使用

trackops locale get|set

和

trackops doctor locale

Como entra OPERA

OPERA的接入方式

OPERA ya no asume que todo usuario es tecnico.

TrackOps clasifica:

nivel tecnico del usuario
estado actual del proyecto
documentacion disponible

Luego elige una de dos rutas:

```
direct bootstrap
```
para usuarios tecnicos y repos ya definidos
```
agent handoff
```
para ideas tempranas, usuarios no tecnicos o documentacion debil

Una vez activo, OPERA instala automáticamente un equipo de agentes especializados en

ops/.agents/skills/

. La coordinadora (

opera-skill

) decide en qué fase está el proyecto, qué agente debe actuar, cuándo delegar y cuándo frenar el avance.

Si TrackOps deriva al agente:

lee
```
ops/bootstrap/agent-handoff.md
```
o imprímelo con
```
trackops opera handoff --print
```

exige como salida:

```
ops/bootstrap/intake.json
```
```
ops/bootstrap/spec-dossier.md
```
```
ops/bootstrap/open-questions.md
```
cuando queden huecos importantes

reanuda con:

bash

trackops opera bootstrap --resume

OPERA不再假设所有用户都是技术人员。

TrackOps会对以下内容进行分类：

用户的技术水平
项目的当前状态
可用的文档

然后选择以下两种路径之一：

```
direct bootstrap
```
适用于技术型用户和已定义好的仓库
```
agent handoff
```
适用于早期想法、非技术型用户或文档不完善的情况

激活后，OPERA会自动在

ops/.agents/skills/

中安装一组专业的Agent团队。协调器(

opera-skill

)会判断项目处于哪个阶段、应由哪个Agent执行操作、何时委派任务以及何时暂停推进。

如果TrackOps将任务转交给Agent：

阅读
```
ops/bootstrap/agent-handoff.md
```
或使用
```
trackops opera handoff --print
```
命令打印该文件

要求输出以下内容：

```
ops/bootstrap/intake.json
```
```
ops/bootstrap/spec-dossier.md
```
当存在重要信息缺口时，需输出
```
ops/bootstrap/open-questions.md
```

使用以下命令恢复流程：

bash

trackops opera bootstrap --resume

Que debe entender alguien que llega desde skills.sh

从skills.sh而来的用户需要了解的内容

la skill global instala instrucciones en el agente
el runtime se instala por separado con npm
```
trackops init
```
activa el proyecto
```
trackops opera install
```
anade el framework operativo completo solo cuando hace falta
TrackOps separa producto y operacion para que el repo no se vuelva caotico

全局Skill会在Agent中安装指令
runtime需通过npm单独安装
```
trackops init
```
用于激活项目
仅在需要时，使用
```
trackops opera install
```
添加完整的操作框架
TrackOps将产品与操作分离，避免仓库变得混乱

Que referencia leer y cuando

参考文档阅读指南

lee
```
references/activation.md
```
solo para instalación, verificación del runtime, locale bootstrap y activación de un repositorio
lee
```
references/workflow.md
```
solo cuando TrackOps ya está activo y haga falta operar el día a día del repositorio
lee
```
references/troubleshooting.md
```
solo cuando fallen la instalación explícita, la detección de
```
trackops
```
, el resume o el contrato de entorno
```
opera-skill
```
es una skill de proyecto, no una referencia de esta skill global. Se instala con OPERA y coordina el trabajo dentro del repositorio.

仅在安装、runtime验证、本地化启动和仓库激活时阅读
```
references/activation.md
```
仅在TrackOps已激活且需要处理仓库日常操作时阅读
```
references/workflow.md
```
仅在显式安装、
```
trackops
```
检测、流程恢复或环境契约出现问题时阅读
```
references/troubleshooting.md
```
```
opera-skill
```
是一款项目Skill，不属于本全局Skill的参考文档。它随OPERA一起安装，用于协调仓库内的工作。