Back to Details

housekeeping

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Housekeeping (AGENTS/CLAUDE Architecture)

仓库整理（AGENTS/CLAUDE架构）

Use this skill when work is about organizing or modernizing 
AGENTS.md
/
CLAUDE.md
context systems.
当你需要对
AGENTS.md
/
CLAUDE.md
上下文系统进行整理或现代化改造时，可使用本skill。

Operating rules

操作规则

  • Keep root 
    AGENTS.md
    concise: critical guardrails, task router, canonical commands, and links.
  • Prefer scoped instruction files in dense areas (
    apps/frontend
    , 
    infra
    , 
    apps/agent
    , etc.).
  • Move deep or volatile details into 
    .agents/repo-context/*
    , not root 
    AGENTS.md
    .
  • Curate continuously: deduplicate, resolve contradictions, and remove stale guidance.
  • Preserve behavior intent during migrations; change structure first, then tighten wording.
  • 保持根目录
    AGENTS.md
    简洁：仅保留关键约束规则、任务路由、标准命令及链接。
  • 优先在特定领域目录（
    apps/frontend
    、
    infra
    、
    apps/agent
    等）中使用限定范围的指令文件。
  • 将深度或易变的细节迁移至
    .agents/repo-context/*
    ，而非根目录
    AGENTS.md
    。
  • 持续维护：去重、解决矛盾内容、移除过时指引。
  • 迁移过程中保留行为意图：先调整结构，再优化措辞。

Workflow

工作流

  1. Assess current state (concise router vs mixed/legacy monolith).
  2. Select target architecture from references.
  3. Migrate content into scoped 
    AGENTS.md
    files and deep docs.
  4. Rewrite root 
    AGENTS.md
    as a short router.
  5. Add freshness metadata for volatile facts where feasible.
  6. Verify links/routes and remove conflicting duplicate rules.
  1. 评估当前状态（简洁路由型 vs 混合/遗留单体型）。
  2. 从参考资料中选择目标架构。
  3. 将内容迁移至限定范围的
    AGENTS.md
    文件及深度文档中。
  4. 将根目录
    AGENTS.md
    重写为简短的路由文档。
  5. 尽可能为易变信息添加新鲜度元数据。
  6. 验证链接/路由，移除冲突的重复规则。

Reference triggers (open when clearly relevant)

参考触发条件（明确相关时打开）

  • AGENTS/CLAUDE architecture, progressive disclosure, or context-memory organization -> 
    skills/housekeeping/references/agents-architecture.md
  • Legacy monolithic AGENTS cleanup, contradiction pruning, or migration planning -> 
    skills/housekeeping/references/migration-playbook.md
  • AGENTS/CLAUDE架构、渐进式披露或上下文记忆组织 -> 
    skills/housekeeping/references/agents-architecture.md
  • 遗留单体AGENTS清理、矛盾内容梳理或迁移规划 -> 
    skills/housekeeping/references/migration-playbook.md

References

参考资料

  • skills/housekeeping/references/index.md
    - References index for this skill
  • skills/housekeeping/references/agents-architecture.md
    - Target architecture, file tree, and root template
  • skills/housekeeping/references/migration-playbook.md
    - Legacy-to-modern migration workflow and checklist
  • skills/housekeeping/references/index.md
    - 本skill的参考资料索引
  • skills/housekeeping/references/agents-architecture.md
    - 目标架构、文件树及根目录模板
  • skills/housekeeping/references/migration-playbook.md
    - 遗留系统到现代化系统的迁移工作流及检查清单