📄️ 代理钩子
已提交的生命周期钩子只做一件事：通过已安装的 oxfmt 格式化成功编辑过的 JavaScript/TypeScript 文件。共享逻辑位于 scripts/agent-hooks/format.mjs；每个原生包装器都委托给它。
📄️ 技能与工具
共享技能位于 .agents/skills/。编辑这些源文件，然后运行 yarn ai-workflow:sync，为 Claude Code 生成 .claude/skills/。Codex 和 Cursor 会直接发现 .agents/skills/；不要恢复重复的 .codex/skills/ 或 .cursor/skills/ 根目录。
📄️ 错误调查工作流程
当特定文件/行/代码块中报告错误时使用此选项。
📄️ 翻译
about 站点使用位于 about/public/translations//default.json 的 i18next JSON。Docusaurus 的源翻译单独存放在 docs/i18n/ 中。
📄️ 提交和发布格式
在提出或实施有意义的代码更改时使用此选项。
📄️ 长时间运行的代理工作
当工作需要恢复或交接，或者单次运行长到上下文压缩可能丢失剩余工作的线索时，使用持久化的任务状态。小任务不需要看板或进度文件。对于共享的工作，在任务专属的 docs/agent-runs// 中保留简洁的 feature-list.json 和 progress.md，有帮助时使用现有模板。
📄️ 已知意外情况
本文件记录本仓库特有的、曾经导致代理犯错的混淆点。
🗃️ 模板
2 个项目