Imported from summeredge/DataProject (
AGENTS.md). Install upstream withnpx skills add summeredge/DataProject. Copyright stays with the author.
DataProject Agent 工作规则
项目定位
DataProject 用于从工业历史时序数据中筛选与目标变量存在较强、稳定、可信统计关联，值得工艺工程师进一步复核的候选变量。
本项目不自动：
- 证明确定性因果；
- 确认根因；
- 识别控制变量；
- 生成控制策略。
核心规则
-
第一阶段主筛查必须独立于后续验证结果。
-
ranked_features.csv初筛排序必须以final_score为准。 -
Granger、条件 Granger、模型解释、综合复核、XGBoost 不得改变：
final_score- 初筛 Top-K
- 初筛推荐顺序
-
闭环状态和人工闭环标签不得影响初筛评分和排序。
-
未执行的后续分析不得在初筛页面、API 或报告中显示为已有结论。
-
缺失、未执行、不可计算和真实
0.0必须保持不同语义。 -
不得使用
abs(lag)、abs(best_lag)等方式丢失滞后方向。 -
统计相关、预测增量和 Granger 结果不得表述为确定性因果。
-
新增字段不得自动进入评分、排序或默认流程。
-
未经明确要求，不得扩大产品范围或修改核心算法。
文档读取规则
默认只读取必要文档，不加载全部 docs。
任务相关文档：
-
产品目标、算法边界：
docs/product.md -
系统结构、阶段流转：
docs/architecture.md -
评分、排序、CSV、API：
docs/contracts.md -
测试和回归：
docs/testing.md -
Review、多 Agent 流程：
docs/workflow.md -
术语定义：
docs/glossary.md -
功能范围：
docs/roadmap.md
涉及历史设计或恢复旧逻辑：
- 先查看
docs/decisions/README.md - 再读取相关 ADR
修改原则
修改前：
- 阅读任务和验收标准；
- 检查相关代码和测试；
- 检查
git status和git diff； - 保护已有修改。
修改时：
- 优先最小修改；
- 不重构无关代码；
- 不修改无关接口、字段和文件；
- 不引入未要求的新算法或依赖；
- 不自动提交、推送或合并。
同类逻辑存在多个位置时，必须检查并修复所有实现。
契约和兼容
必须保护：
- CSV 文件名、字段名、字段语义；
- API 输出结构；
- 中文 UI 字段；
- Windows 路径和中文路径；
- Excel/CSV 读取兼容。
新增行为必须通过测试约束，不得只依赖文档。
测试原则
修改后必须：
- 执行相关单元测试；
- 执行契约测试；
- 根据范围执行完整测试。
测试应优先验证：
- 用户可见行为；
- 数据流和接口契约；
- 必要的源码约束。
不得：
- 删除测试；
- 放宽断言绕过问题；
- 仅修改预期结果；
- 用 CI 通过替代 Review。
Review 原则
Review 必须检查：
- 完整 diff；
- 修改范围；
- 产品目标；
- 架构边界；
- 数据契约；
- 测试覆盖。
重点关注：
- 后续分析是否影响初筛；
- 是否修改
final_score语义； - 是否遗漏重复实现；
- 是否破坏兼容性；
- 是否引入无关修改。
CI 通过不等于 Review 通过。