forgeplan untag

Удаляет один или несколько тегов из артефакта. Обратная операция для forgeplan tag. Используйте это для удаления устаревших меток (legacy, которая больше не является устаревшей, wip для того, что уже выпущено) или для исправления ошибок, возникших в результате массового тегирования.

Использование

forgeplan untag <ID> <TAGS>...

Аргументы

  <ID>       ID артефакта
  <TAGS>...  Теги для удаления

Опции

  -h, --help     Вывести справку
  -V, --version  Вывести версию

Как это работает

1. Загружает фронтматтер артефакта.
2. Канонизирует каждый входящий тег так же, как это делает tag (приводит к нижнему регистру, обрезает пробелы), чтобы Legacy, legacy и legacy соответствовали сохранённому значению.
3. Удаляет каждое совпадение из списка tags:.
4. Перезаписывает фронтматтер и переиндексирует артефакт в LanceDB.

Неизвестные теги игнорируются без уведомления - untag идемпотентен и безопасен для использования в скриптах.

Примеры

Удалить один тег:

forgeplan untag PRD-001 legacy

Удалить несколько тегов за один вызов:

forgeplan untag PRD-018 wip experimental source=draft

Исправить ошибку массового тегирования (сначала тегировать, затем сразу удалить тег):

forgeplan tag PRD-001 securiti   # опечатка
forgeplan untag PRD-001 securiti
forgeplan tag PRD-001 security   # правильно

Массовая очистка

Чтобы удалить тег из каждого артефакта (например, при выводе таксономии из употребления), используйте в сочетании с list --tag:

forgeplan list --tag wip --format ids | \
  xargs -I {} forgeplan untag {} wip

Для канонизации тегов по всему рабочему пространству (исправление PROB-026) предпочтительнее использовать forgeplan reindex - он нормализует каждый тег на месте, не требуя явных пар untag/tag.

Примечания

• untag нечувствителен к регистру при вводе: forgeplan untag PRD-001 Legacy удалит legacy.
• Если вы хотите переместить артефакт из одного тега в другой, выполните untag, а затем tag - вспомогательной команды retag нет.
• Удаление тега не влияет на связи или оценку - теги являются чистыми метаданными.

См. также

• Обзор CLI
• forgeplan tag - добавить теги
• forgeplan reindex - канонизировать теги по всему рабочему пространству
• forgeplan list - фильтровать артефакты по тегу
• Руководство по методологии