菜单
工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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 托管）流程编排引擎。推进 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。