JobRadar/AGENTS.md

项目协作说明

项目定位

• 项目名称：JobRadar（职途雷达）
• 项目用途：面向个人求职者，以 Agent 编排岗位采集、企业调查、规则筛选、评分和结果管理，形成可追溯的岗位发现与决策流程。
• 项目类型：Django Web 应用，目前处于工程基线阶段。

技术与代码边界

技术栈、源码根、模块和依赖以 .craftkit/project.json 为结构化入口。未确认的信息不得自行补全。

• 当前语言为 Python 3.13，Web 框架为 Django 6.0.8。
• Django 配置位于 JobRadar/settings/，开发、测试、集成和生产环境必须使用对应配置。
• 业务模块按 docs/architecture.md 的边界增量建立，不提前创建尚不能验证的空业务模块。
• 框架记录精确版本和已存在的公共 profile；普通开发只使用当前 profile，升级或版本比较任务才读取源、目标两个版本。

项目资料

• 项目说明：README.md
• 架构设计：docs/architecture.md
• Agent 契约：docs/agent-contract.md
• 实施路线图：docs/roadmap.md
• AI 开发约定：docs/development-guide.md
• Agent 补充说明：.craftkit/agents/index.md
• 项目规范：.craftkit/standards/index.md
• 可复用知识：.craftkit/knowledge/index.md
• 共享设计文档：.craftkit/designs/；开发中过程文档使用 .craftkit/project.json 配置的 documents.workRoot。
• 文档维护规则：.craftkit/standards/document-maintenance.md；修改实现时检查并同步受影响的长期文档。

工作约束

• 所有回答、项目文档和代码注释使用中文。
• 修改前先说明方案；复杂改动取得确认后执行，简单改动可以直接处理，但必须说明调整内容。
• 新增或修改代码时沿用相邻代码的注释格式，并为关键边界、失败路径和不直观逻辑提供详尽注释。
• 修改前先阅读与目标目录和任务主题相关的项目资料。
• 区分明确项目规则、公共建议和从代码观察到的现状。
• 不提交凭据、个人机器路径、本地状态或可重新生成缓存。
• 外部采集必须遵守授权范围、站点条款和频率限制，不绕过验证码、登录保护或访问控制。
• 第一版不自动投递简历或联系招聘人员；高风险或不可逆操作必须经过人工确认。
• 发现规范冲突、信息缺失或多种并存风格时先向用户说明。

验证要求

• Django 配置检查：python manage.py check
• 自动化测试：python manage.py test
• 迁移完整性：python manage.py makemigrations --check --dry-run
• 静态检查：ruff check .
• 项目依赖默认在名为 JobRadar 的 Conda 环境中运行；若当前解释器缺少依赖，应先确认环境是否已同步。