Back to Details

trackops

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

TrackOps

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
    y 
    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一起安装，用于协调仓库内的工作。