可追溯性同步
MiguelALRendon2026-10-27查看 969复制 1110
Reconstruye .bossdream-project/traceability.json del proyecto activo desde los Markdown reales (requirements.md + tests/cases/* .md) cuando se sospecha que se desincronizo. El JSON es un cache derivado, nunca la fuente de verdad.触发器— el usuario lo pide a demanda, o/bossdream-update-docs la invoca internamente tras un edit manual.
📘如何使用这个技能
- 1复制技能内容·点击上方「Copy SKILL.md」复制全部内容，或 Download 下载到本地
- 2打开你的 AI 客户端·支持 Claude Code、Trae、Cursor、ChatGPT、DeepSeek、Kimi 等任意 AI 助手
- 3粘贴为系统提示/知识文件·Claude Code：放入 .claude/skills/ 目录；普通对话：作为首条消息发送并说「请严格按这份技能文档执行」
- 4直接提出你的需求·AI 会按技能定义的工作流、格式和约束来处理，无需再解释背景
💡 提示：技能生效后，每次对话只需一句需求，AI 会按 SKILL.md 的流程执行。
SKILL.md1768 chars
---
name: traceability-sync
description: Reconstruye .bossdream-project/traceability.json del proyecto activo desde los Markdown reales (requirements.md + tests/cases/*.md) cuando se sospecha que se desincronizo. El JSON es un cache derivado, nunca la fuente de verdad. TRIGGER — el usuario lo pide a demanda, o /bossdream-update-docs la invoca internamente tras un edit manual.
arguments:
- name: proyecto
description: "slug del proyecto activo (normalmente ya viene de .claude/.active-project)"
---
# traceability-sync — el grafo se regenera, nunca se edita a mano
## Proceso
1. Localiza el proyecto activo (`.claude/.active-project`).
2. Corre `scripts/traceability-build.ps1 -ProjectSlug <slug>` — parsea `requirements.md` (Epic/Feature/US/AC segun la jerarquia que aplique por clasificacion) y `tests/cases/*.md` (enlaza cada TC a la US/AC que declara cubrir), y **reescribe `traceability.json` completo desde cero**.
3. Reporta un resumen breve de lo que quedo registrado (cuantos Epics/Features/US/AC/TC), y si algo esperado no aparecio (ej. un TC que menciona una US que no existe en `requirements.md` — en ese caso el TC simplemente no se enlaza, y `validation-trace-check.ps1` lo marcara huerfano en la siguiente corrida de `/bossdream-validate`).
## Reglas
- **`traceability.json` nunca se edita a mano.** Si algo esta mal, se corrige en el Markdown y se vuelve a correr esta skill — el JSON siempre se puede regenerar.
- No decide nada por su cuenta (a diferencia de `epic-planner`): es puramente mecanica, no propone ni pregunta, solo re-sincroniza IDs que ya estan escritos en los documentos.
- No toca `validation.json` — eso es responsabilidad de `mark-project-dirty.ps1` (hook) o de quien invoque esta skill (ej. `/bossdream-update-docs`).