@namewta/speculo 0.3.3 → 0.3.4

package/template/skills/typescript-engineering-standards/templates/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

package/template/skills/typescript-engineering-standards/templates/AGENTS.typescript.md

@@ -0,0 +1,21 @@
+# TypeScript Project Rules
+
+- 先按运行环境和业务领域组织代码，领域内部优先局部平铺。
+- 目录与普通 TypeScript 文件使用 `kebab-case`；组件文件沿用项目统一规则。
+- 文件名必须表达具体领域和职责，避免 `utils`、`helpers`、`common`、`misc`。
+- 一个文件只有一个主要职责；不要为单个普通文件创建目录。
+- 默认使用命名导出；仅在框架约定入口使用默认导出。
+- 禁止无意义全局 Barrel 和循环依赖。
+- TypeScript 必须开启严格模式；禁止无说明的 `any`、双重断言和 `@ts-ignore`。
+- 外部输入先作为 `unknown`，在系统边界运行时验证。
+- 优先使用可辨识联合表达互斥状态，并进行穷尽检查。
+- 导出函数和公共 API 写明确返回类型。
+- 所有 Promise 必须 `await`、`return` 或显式处理。
+- 监听器、Timer、连接、Worker 和进程必须有清理路径。
+- 注释解释 WHY、约束和权衡，不逐行翻译代码。
+- 单元测试与源码共置；集成和 E2E 测试放在根级 `tests/`。
+- 修复缺陷时添加回归测试。
+- 不引入未经要求的新框架或依赖。
+- 不通过关闭核心规则、删除测试或扩大 `any` 来绕过检查。
+- 合并前运行格式检查、Lint、类型检查、测试和构建。
+- 修改现有项目时优先遵守仓库已生效配置，避免无关重命名和格式噪声。

package/template/skills/typescript-engineering-standards/templates/code-review-checklist.md

@@ -0,0 +1,37 @@
+# TypeScript Code Review Checklist
+
+## 正确性与安全
+
+- [ ] 外部输入已验证。
+- [ ] 权限、安全和敏感信息处理正确。
+- [ ] 错误路径不会造成数据损坏或状态不一致。
+
+## 类型与 API
+
+- [ ] 没有无说明的 `any`、双重断言或 `@ts-ignore`。
+- [ ] 公共 API 输入、输出和错误契约明确。
+- [ ] 互斥状态使用可靠模型，分支穷尽。
+- [ ] 空值和可选语义清晰。
+
+## 异步与资源
+
+- [ ] Promise 已等待、返回或显式处理。
+- [ ] 超时、取消和重试策略合理。
+- [ ] 监听器、Timer、连接和进程已清理。
+- [ ] 无明显竞态或过期响应覆盖问题。
+
+## 架构与维护
+
+- [ ] 文件位于正确领域和运行环境。
+- [ ] 文件名具体，职责单一。
+- [ ] 依赖方向正确，无循环依赖。
+- [ ] 没有无意义共享抽象和 Barrel。
+- [ ] 文件、函数和状态复杂度合理。
+
+## 测试与交付
+
+- [ ] 新行为有适当测试。
+- [ ] 缺陷修复有回归测试。
+- [ ] 测试确定、可诊断且不过度 Mock。
+- [ ] 格式、Lint、类型检查、测试和构建通过。
+- [ ] 无无关格式化、重命名或生成文件变化。

package/template/skills/typescript-engineering-standards/templates/package-scripts.json

@@ -0,0 +1,11 @@
+{
+  "scripts": {
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "tsc -b",
+    "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build"
+  }
+}

package/template/skills/typescript-engineering-standards/templates/prettier.json

@@ -0,0 +1,6 @@
+{
+  "singleQuote": true,
+  "semi": false,
+  "printWidth": 100,
+  "trailingComma": "none"
+}

package/template/skills/typescript-engineering-standards/templates/pull-request-template.md

@@ -0,0 +1,37 @@
+## 背景
+
+<!-- 这个变更解决什么问题？ -->
+
+## 方案
+
+<!-- 核心实现、边界和主要取舍。 -->
+
+## 影响范围
+
+- [ ] 公共 API
+- [ ] 数据或配置迁移
+- [ ] 跨平台行为
+- [ ] 安全或权限
+- [ ] 性能
+- [ ] UI / 可访问性
+
+## 验证
+
+- [ ] 格式检查
+- [ ] Lint
+- [ ] TypeScript 类型检查
+- [ ] 单元测试
+- [ ] 集成 / E2E 测试
+- [ ] 构建
+
+## 证据
+
+<!-- 截图、录屏、日志、基准或测试结果。 -->
+
+## 风险与回滚
+
+<!-- 已知风险、兼容性和回滚方式。 -->
+
+## 后续工作
+
+<!-- 不属于本 PR 的工作，附任务编号。 -->

package/template/skills/typescript-engineering-standards/templates/tsconfig.base.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2022",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "useUnknownInCatchVariables": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  }
+}

package/template/skills/typescript-engineering-standards/templates/tsconfig.project-references.json

@@ -0,0 +1,8 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.node.json" },
+    { "path": "./tsconfig.web.json" },
+    { "path": "./tsconfig.test.json" }
+  ]
+}