Menu
工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
流程编排引擎。推进 task.json.flow 步骤（init/check/complete/reset）并维护任务级事件流 task.json.events（emit/check/recent）。触发关键词：flow advance、推进流程、当前步骤、初始化流程、emit event、查事件、task.json.events、flow-engine。
TAPD 统一入口 skill。工单拉取、共识管理、子任务回填、事件驱动同步。触发关键词：tapd、初始化、ticket sync、共识、Wiki 评审、子任务、工时回填、QA 通过、QA 打回、TAPD 事件、契约推送、同步工单、拉工单。
产出结构化 handoff 工件，让新 session 无痕接续当前任务。ctx-guard 阻断或主动切换 session 时使用。触发关键词：context reset、上下文重置、新开 session、切换 session、handoff。
运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。
Git 操作统一入口。分支生命周期（create/merge/cleanup）、worktree（create/remove）、提交推送（commit-push）。按 docs/git-brance-spec.md + Conventional Commits 中文规范执行。触发关键词：创建分支、合并到 dev、合并到 uat、删除分支、清理分支、git push、commit、推送代码、worktree、提交代码。
统一集成测试入口。按 env.yaml 显式指定 / 文件名约定 fallback 探测被测项目的 testing skill,委托其跑测试输出统一 schema 的 verdict.json。
Based on SOC occupation classification
| name | gc |
| description | 工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。 |
| model | haiku |
定期清理主流程积累的元数据熵,保持工作流状态可维护。
| 方式 | 说明 |
|---|---|
| 每日定时(session-start) | 每天首次 session 自动触发 dry_run |
| 手动 | python .claude/skills/gc/scripts/gc.py 或 /gc |
docs/reports/gc/YYYY-MM-DD.json_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 双开关) |
--apply 仅自动处理 orphaned_index_entry,其他扫描项都要人工 review--archive --apply 双开关——常规 --apply 不会触发归档(归档危险性高于 orphan remove)--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>/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.pydocs/reports/gc/(常规)/ docs/reports/gc/YYYY-MM-DD-archive.json(归档模式)docs/task/archive/<YYYY-QN>/.claude/skills/task/references/task-index-entry.schema.md（task skill 托管）