chore(project): 初始化项目协作与知识基线

AGENTS.md

@@ -1,30 +1,49 @@
-# JobRadar 项目协作说明
+# 项目协作说明
 
 ## 项目定位
 
 - 项目名称：JobRadar（职途雷达）
-- 项目用途：面向个人使用、以 Agent 为核心的智能岗位发现与决策系统
-- 项目类型：Django Web 应用与 Agent 工程
+- 项目用途：面向个人求职者，以 Agent 编排岗位采集、企业调查、规则筛选、评分和结果管理，形成可追溯的岗位发现与决策流程。
+- 项目类型：Django Web 应用，目前处于工程基线阶段。
 
 ## 技术与代码边界
 
 技术栈、源码根、模块和依赖以 `.craftkit/project.json` 为结构化入口。未确认的信息不得自行补全。
 
-当前项目处于工程基线阶段。只把仓库中已存在的源码和配置视为已实现能力；README、架构文档和路线图中的后续模块均属于规划，不能描述为已完成。
+- 当前语言为 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`
-- 项目总览：`README.md`
+- 共享设计文档：`.craftkit/designs/`；开发中过程文档使用 `.craftkit/project.json` 配置的 `documents.workRoot`。
+- 文档维护规则：`.craftkit/standards/document-maintenance.md`；修改实现时检查并同步受影响的长期文档。
 
 ## 工作约束
 
+- 所有回答、项目文档和代码注释使用中文。
+- 修改前先说明方案；复杂改动取得确认后执行，简单改动可以直接处理，但必须说明调整内容。
+- 新增或修改代码时沿用相邻代码的注释格式，并为关键边界、失败路径和不直观逻辑提供详尽注释。
 - 修改前先阅读与目标目录和任务主题相关的项目资料。
-- 区分明确项目规则、公共建议、规划目标和从代码观察到的现状。
-- 采用增量、小步、可验证的实现方式，不一次性生成所有规划模块。
+- 区分明确项目规则、公共建议和从代码观察到的现状。
 - 不提交凭据、个人机器路径、本地状态或可重新生成缓存。
-- 不伪造 Agent 浏览、查询、工具调用、入库结果或验证结论。
-- 高风险或不可逆操作必须由用户确认；不得自动投递简历或联系招聘人员。
+- 外部采集必须遵守授权范围、站点条款和频率限制，不绕过验证码、登录保护或访问控制。
+- 第一版不自动投递简历或联系招聘人员；高风险或不可逆操作必须经过人工确认。
 - 发现规范冲突、信息缺失或多种并存风格时先向用户说明。
+
+## 验证要求
+
+- Django 配置检查：`python manage.py check`
+- 自动化测试：`python manage.py test`
+- 迁移完整性：`python manage.py makemigrations --check --dry-run`
+- 静态检查：`ruff check .`
+- 项目依赖默认在名为 `JobRadar` 的 Conda 环境中运行；若当前解释器缺少依赖，应先确认环境是否已同步。