원클릭으로 Manus에서 모든 스킬 실행

시작하기

gc

스타2

포크0

업데이트2026년 7월 3일 02:23

工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

dd-xiaozhi

dd-xiaozhi/dev-agent-flow

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

GC — 工作流熵管理

定期清理主流程积累的元数据熵,保持工作流状态可维护。

触发

方式	说明
每日定时(session-start)	每天首次 session 自动触发 dry_run
手动	`python .claude/skills/gc/scripts/gc.py` 或 `/gc`

边界

✅ 默认 dry_run,只产报告
✅ 报告写到 docs/reports/gc/YYYY-MM-DD.json
❌ 永远不删 source 快照(审计链不可破)
❌ 永远不自动删除(dry_run 优先)
❌ _index.jsonl orphan 之外的扫描项默认仅产报告,不自动 apply

扫描项

扫描类型	来源	阈值	动作
`stale_ticket_cache`	`docs/tapd/tickets/*.json`	30 天未更新	`archive_to_reports_gc`
`orphaned_index_entry`	`_index.jsonl` 中 task_id 目录不存在	7 天持续孤儿	`remove_from_index`(常规 `--apply` 可自动清理)
`stale_task_report`	`reports/tasks/TASK-*/meta.json`	60 天未更新 + terminal phase	`archive_to_reports_gc`
`stale_source_snapshots`	`tasks/stories//source/.md`	单 story > 10 快照	`review_snapshots`(不自动删)
`archivable_tasks`	主 `_index.jsonl` 中 `completed_at`	90 天前完成	`archive_to_quarter`(需 `--archive --apply` 双开关)

Gotchas

默认 dry_run,只产报告不删(新手以为已清理 → 文件并没动)
常规扫描 --apply 仅自动处理 orphaned_index_entry,其他扫描项都要人工 review
归档动作必须 --archive --apply 双开关——常规 --apply 不会触发归档(归档危险性高于 orphan remove)
永远不能删 source 快照(审计链不可破,即使 --apply 也只 review 不删)
session-start hook 每日首次自动触发常规扫描,不自动跑归档(--archive 必须人工触发)
手动多次跑会重复产报告(覆盖前一份)

模式

# 常规熵扫描(stale ticket / orphan / stale report / 快照超量)
python .claude/skills/gc/scripts/gc.py             # dry_run(默认)
python .claude/skills/gc/scripts/gc.py --apply     # 执行 orphan 清理

# 归档(单独模式,只看 completed_at > 90 天的任务)
python .claude/skills/gc/scripts/gc.py --archive            # dry_run 候选清单
python .claude/skills/gc/scripts/gc.py --archive --apply    # 执行归档:移目录 + 季度索引 + 主索引清除

归档动作详解

--archive --apply 会:

移目录:docs/task/{store|bug-fix}/<id>/ → docs/task/archive/<YYYY-QN>/<id>/
append entry 到 docs/task/archive/<YYYY-QN>/_index.jsonl(季度索引)
从主 _index.jsonl 移除 entry(备份到 _index.jsonl.archive.bak)
重建 docs/task/archive/_index.jsonl(跨季度总索引)

归档后用 task.py search --include-archive 可继续检索。

流程

flowchart LR
  A[扫描各项] --> B[与阈值对比]
  B --> C[产报告 YYYY-MM-DD.json]
  C --> D{--apply?}
  D -->|否| E[退出,人工 review]
  D -->|是 + 常规| F[执行 orphan 清理]
  D -->|是 + --archive| G[移目录 + 季度索引 + 主索引清除]

关联

脚本:.claude/skills/gc/scripts/gc.py
报告:docs/reports/gc/(常规)/ docs/reports/gc/YYYY-MM-DD-archive.json(归档模式)
归档目录:docs/task/archive/<YYYY-QN>/
关联 schema:.claude/skills/task/references/task-index-entry.schema.md（task skill 托管）

이 저장소의 다른 Skills

같은 저장소

flow-engine

dd-xiaozhi/dev-agent-flow

流程编排引擎。推进 task.json.flow 步骤（init/check/complete/reset）并维护任务级事件流 task.json.events（emit/check/recent）。触发关键词：flow advance、推进流程、当前步骤、初始化流程、emit event、查事件、task.json.events、flow-engine。

2026-07-032

tapd

dd-xiaozhi/dev-agent-flow

TAPD 统一入口 skill。工单拉取、共识管理、子任务回填、事件驱动同步。触发关键词：tapd、初始化、ticket sync、共识、Wiki 评审、子任务、工时回填、QA 通过、QA 打回、TAPD 事件、契约推送、同步工单、拉工单。

2026-07-032

context-reset

dd-xiaozhi/dev-agent-flow

产出结构化 handoff 工件，让新 session 无痕接续当前任务。ctx-guard 阻断或主动切换 session 时使用。触发关键词：context reset、上下文重置、新开 session、切换 session、handoff。

2026-07-032

fitness-run

dd-xiaozhi/dev-agent-flow

运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。

2026-07-032

git

dd-xiaozhi/dev-agent-flow

Git 操作统一入口。分支生命周期（create/merge/cleanup）、worktree（create/remove）、提交推送（commit-push）。按 docs/git-brance-spec.md + Conventional Commits 中文规范执行。触发关键词：创建分支、合并到 dev、合并到 uat、删除分支、清理分支、git push、commit、推送代码、worktree、提交代码。

2026-07-032

integration-test

dd-xiaozhi/dev-agent-flow

统一集成测试入口。按 env.yaml 显式指定 / 文件名约定 fallback 探测被测项目的 testing skill,委托其跑测试输出统一 schema 的 verdict.json。

2026-07-032

name	gc
description	工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。
model	haiku

GC — 工作流熵管理

定期清理主流程积累的元数据熵,保持工作流状态可维护。

触发

方式	说明
每日定时(session-start)	每天首次 session 自动触发 dry_run
手动	`python .claude/skills/gc/scripts/gc.py` 或 `/gc`

边界

✅ 默认 dry_run,只产报告
✅ 报告写到 docs/reports/gc/YYYY-MM-DD.json
❌ 永远不删 source 快照(审计链不可破)
❌ 永远不自动删除(dry_run 优先)
❌ _index.jsonl orphan 之外的扫描项默认仅产报告,不自动 apply

扫描项

扫描类型	来源	阈值	动作
`stale_ticket_cache`	`docs/tapd/tickets/*.json`	30 天未更新	`archive_to_reports_gc`
`orphaned_index_entry`	`_index.jsonl` 中 task_id 目录不存在	7 天持续孤儿	`remove_from_index`(常规 `--apply` 可自动清理)
`stale_task_report`	`reports/tasks/TASK-*/meta.json`	60 天未更新 + terminal phase	`archive_to_reports_gc`
`stale_source_snapshots`	`tasks/stories//source/.md`	单 story > 10 快照	`review_snapshots`(不自动删)
`archivable_tasks`	主 `_index.jsonl` 中 `completed_at`	90 天前完成	`archive_to_quarter`(需 `--archive --apply` 双开关)

Gotchas

默认 dry_run,只产报告不删(新手以为已清理 → 文件并没动)
常规扫描 --apply 仅自动处理 orphaned_index_entry,其他扫描项都要人工 review
归档动作必须 --archive --apply 双开关——常规 --apply 不会触发归档(归档危险性高于 orphan remove)
永远不能删 source 快照(审计链不可破,即使 --apply 也只 review 不删)
session-start hook 每日首次自动触发常规扫描,不自动跑归档(--archive 必须人工触发)
手动多次跑会重复产报告(覆盖前一份)

模式

# 常规熵扫描(stale ticket / orphan / stale report / 快照超量)
python .claude/skills/gc/scripts/gc.py             # dry_run(默认)
python .claude/skills/gc/scripts/gc.py --apply     # 执行 orphan 清理

# 归档(单独模式,只看 completed_at > 90 天的任务)
python .claude/skills/gc/scripts/gc.py --archive            # dry_run 候选清单
python .claude/skills/gc/scripts/gc.py --archive --apply    # 执行归档:移目录 + 季度索引 + 主索引清除

归档动作详解

--archive --apply 会:

移目录:docs/task/{store|bug-fix}/<id>/ → docs/task/archive/<YYYY-QN>/<id>/
append entry 到 docs/task/archive/<YYYY-QN>/_index.jsonl(季度索引)
从主 _index.jsonl 移除 entry(备份到 _index.jsonl.archive.bak)
重建 docs/task/archive/_index.jsonl(跨季度总索引)

归档后用 task.py search --include-archive 可继续检索。

流程

flowchart LR
  A[扫描各项] --> B[与阈值对比]
  B --> C[产报告 YYYY-MM-DD.json]
  C --> D{--apply?}
  D -->|否| E[退出,人工 review]
  D -->|是 + 常规| F[执行 orphan 清理]
  D -->|是 + --archive| G[移目录 + 季度索引 + 主索引清除]

关联

脚本:.claude/skills/gc/scripts/gc.py
报告:docs/reports/gc/(常规)/ docs/reports/gc/YYYY-MM-DD-archive.json(归档模式)
归档目录:docs/task/archive/<YYYY-QN>/
关联 schema:.claude/skills/task/references/task-index-entry.schema.md（task skill 托管）