base

用途：为 AI 或工程师提供统一的编码约束与工作流规范，使系统规模保持可在一个会话内理解。主要能力包括四部分。一是简单性限制：函数不超过 20 行、参数不超过 3 个、嵌套不超过 2 层；文件不超过 200 行、函数不超过 10 个；目录嵌套不超过 3 层，禁止循环依赖，超出即拆分。二是架构与测试理念：函数式核心加命令式外壳，副作用仅限边界；组合优于继承；100% 业务逻辑覆盖、边界用集成测试；禁止全局状态、魔法值、重复代码、死代码等反模式。三是 TDD 强制流程：每个待办按 RED 写失败测试、GREEN 最小实现、VALIDATE 跑 lint/类型检查/覆盖率（≥80%）、PROVE 展示真实输出后标记完成；缺陷修复同样先生成复现测试并做测试缺口分析。四是工程管理：原子待办模板含验收标准、验证方式、测试用例、依赖与 TDD 执行日志；文档分 docs/ 与 _project_specs/；会话状态记录决策与检查点；凭据集中管理（如读取访问密钥文件生成 .env）；安全要求含密钥不入库、输入校验、参数化查询、密码哈希与依赖扫描。用法：按资料中 Node.js、Python、React/Next.js 对应命令执行，例如 npm run lint && npm run typecheck && npm test -- --coverage、ruff check . && mypy . && pytest --cov --cov-fail-under=80。限制：未提供安装方式、支持平台、收费信息与具体效果数据；内容为规范约定，不保证适配所有技术栈。