@coralai/sps-cli 0.55.12 → 0.56.0

package/skills/swift/references/testing.md

@@ -1,229 +0,0 @@
-# Swift — Testing
-
-XCTest and Swift Testing (Swift 6+). For TDD, see `coding-standards/references/tdd.md`.
-
-## Runner choice
-
-- **XCTest** — mature, ships with Xcode, required for UI tests.
-- **Swift Testing** — Swift 6 stdlib, cleaner API, macros for parametrized tests. Use for new unit tests when your toolchain supports it.
-
-Both can coexist in the same target.
-
-## XCTest
-
-```swift
-import XCTest
-@testable import MyApp
-
-final class UserServiceTests: XCTestCase {
-    func test_createUser_returnsPersistedUser() async throws {
-        let service = UserService(repo: InMemoryUserRepo())
-        let user = try await service.create(email: "a@x.com")
-        XCTAssertEqual(user.email, "a@x.com")
-        XCTAssertFalse(user.id.isEmpty)
-    }
-
-    func test_createUser_rejectsEmptyEmail() async {
-        let service = UserService(repo: InMemoryUserRepo())
-        do {
-            _ = try await service.create(email: "")
-            XCTFail("expected ValidationError")
-        } catch is ValidationError {
-            // expected
-        } catch {
-            XCTFail("unexpected error: \(error)")
-        }
-    }
-}
-```
-
-Name tests `test_behaviour_expectation`. Structure: **Arrange → Act → Assert**.
-
-## Swift Testing (Swift 6+)
-
-```swift
-import Testing
-@testable import MyApp
-
-struct UserServiceTests {
-    @Test
-    func createUserReturnsPersistedUser() async throws {
-        let service = UserService(repo: InMemoryUserRepo())
-        let user = try await service.create(email: "a@x.com")
-        #expect(user.email == "a@x.com")
-        #expect(!user.id.isEmpty)
-    }
-
-    @Test
-    func createUserRejectsEmptyEmail() async throws {
-        let service = UserService(repo: InMemoryUserRepo())
-        await #expect(throws: ValidationError.self) {
-            try await service.create(email: "")
-        }
-    }
-}
-```
-
-Cleaner: `#expect(...)` macro, `@Test` annotation, real async support.
-
-## Parametrized tests
-
-```swift
-@Test("add cases", arguments: [
-    (1, 2, 3),
-    (0, 0, 0),
-    (-1, 1, 0),
-])
-func add(a: Int, b: Int, expected: Int) {
-    #expect(MyApp.add(a, b) == expected)
-}
-```
-
-XCTest equivalent requires manual loops or `XCTestCase` subclasses.
-
-## Assertions
-
-| XCTest | Swift Testing |
-|---|---|
-| `XCTAssertEqual(a, b)` | `#expect(a == b)` |
-| `XCTAssertTrue(x)` | `#expect(x)` |
-| `XCTAssertNil(x)` | `#expect(x == nil)` |
-| `XCTAssertThrowsError { ... }` | `#expect(throws: ...) { ... }` |
-| `XCTFail("msg")` | `Issue.record("msg")` |
-
-## Fakes over mocks
-
-Hand-roll fakes; Swift's strong type system makes them cheap.
-
-```swift
-final class InMemoryUserRepo: UserRepositoryProtocol {
-    private var users: [String: User] = [:]
-    func find(id: String) async -> User? { users[id] }
-    func save(_ u: User) async { users[u.id] = u }
-}
-```
-
-For mock libraries, `Cuckoo` and `Mockable` exist; most teams find hand-rolled cheaper in Swift than in JVM.
-
-## Async tests
-
-Swift Testing supports `async` natively. XCTest also, from iOS 13+ / macOS 10.15+:
-
-```swift
-func test_loads() async throws {
-    let user = try await service.load(id: "u1")
-    XCTAssertEqual(user.id, "u1")
-}
-```
-
-For code using completion callbacks (legacy), use `XCTestExpectation`:
-
-```swift
-func test_legacy() {
-    let exp = expectation(description: "callback")
-    legacy { result in
-        XCTAssertNotNil(result)
-        exp.fulfill()
-    }
-    wait(for: [exp], timeout: 5)
-}
-```
-
-New code shouldn't need this — bridge to `async` with `withCheckedContinuation`.
-
-## Timing / clock control
-
-Mock time with a `Clock` protocol:
-
-```swift
-protocol Clock { func now() -> Date }
-
-final class FixedClock: Clock {
-    var time: Date
-    init(_ t: Date) { self.time = t }
-    func now() -> Date { time }
-}
-```
-
-For `Task.sleep` in tests, use `ContinuousClock` with a manually advanced test clock (Swift Testing / swift-async-algorithms).
-
-Swift Testing integrates with the new `Clock` primitives and supports virtual time.
-
-## UI tests — XCUITest
-
-```swift
-final class AppUITests: XCTestCase {
-    func test_login_success() {
-        let app = XCUIApplication()
-        app.launch()
-        app.textFields["email"].tap()
-        app.textFields["email"].typeText("a@x.com")
-        app.buttons["Continue"].tap()
-        XCTAssertTrue(app.staticTexts["Welcome"].waitForExistence(timeout: 5))
-    }
-}
-```
-
-Rules:
-- Use `accessibilityIdentifier`, not labels — labels break when copy changes.
-- Reset app state in `setUp`; UI tests are order-dependent if you don't.
-- Keep to happy paths and critical flows; they're slow and brittle.
-
-## Snapshot tests
-
-`swift-snapshot-testing` (`point-free`) for views, JSON, formatted strings.
-
-```swift
-import SnapshotTesting
-import XCTest
-
-final class UserViewTests: XCTestCase {
-    func test_userView() {
-        let vc = UserViewController(user: .sample)
-        assertSnapshot(matching: vc, as: .image)
-    }
-}
-```
-
-Review diffs deliberately; don't mass-accept.
-
-## Coverage
-
-Xcode can emit `.xcresult` with coverage; `xcrun xccov view --report` for CLI. Set a threshold in your `fastlane` / CI.
-
-## Performance tests
-
-```swift
-func test_perf_parsing() {
-    measure {
-        _ = parse(sampleInput)
-    }
-}
-```
-
-Xcode stores baselines; regressions highlight on re-run. Keep perf tests to critical paths; they're slow and machine-dependent.
-
-## Test plans
-
-Use Xcode test plans to split fast unit tests, slower integration, UI tests into separate CI stages:
-
-```
-UnitTests.xctestplan           # fast, ~seconds
-IntegrationTests.xctestplan    # real deps, minutes
-UITests.xctestplan             # UI, slow
-```
-
-Run unit on every PR; integration and UI on merge-to-main.
-
-## Anti-patterns
-
-| Anti-pattern | Fix |
-|---|---|
-| `Thread.sleep` / `sleep()` in tests to wait for async | `XCTestExpectation` or `async/await` |
-| `try!` inside a test | Use `try` + `XCTAssertNoThrow` or Swift Testing `#expect(throws:)` |
-| Shared state across tests via singletons | Reset in `setUp`; prefer DI |
-| Snapshot test accepted without review | Always diff before committing |
-| UI tests finding by label (`"Log in"`) | Use `accessibilityIdentifier` |
-| Mocking the thing you're testing | Test via real public API |
-| `XCTFail` + guard + `return` scattered inline | Use Swift Testing `#expect(throws:)` or helper methods |
-| Tests depending on device locale / time | Inject locale / clock |

package/skills/tax-worker/SKILL.md

@@ -1,150 +0,0 @@
----
-name: tax-worker
-description: |
-  财税代理记账 worker — 处理客户公司财务资料：工资表Excel、发票PDF、银行流水PDF、
-  收据图片、电子回单PDF。提取数据、分类科目、计算税额、生成报表。
-  适用于小企业会计准则（五级科目）。(🪸 Coral SPS)
----
-
-# 财税 Worker 行为规范
-
-## 角色
-
-你是一名专业的代理记账会计。你负责处理客户公司的季度财务资料，完成从原始凭证提取到报税表生成的全过程。
-
-## 适用准则
-
-**小企业会计准则**（财会〔2011〕17号），五级科目体系。
-
-## 输入文件类型
-
-| 文件类型 | 格式 | 内容 |
-|---------|------|------|
-| 工资表 | .xlsx / .xls | 员工姓名、基本工资、社保、公积金、个税 |
-| 发票 | .pdf | 发票代码、号码、金额、税额、税率、购销方、日期 |
-| 银行流水 | .pdf | 日期、摘要、金额、对方户名、余额 |
-| 收据 | .jpg / .png | 金额、用途、日期 |
-| 电子回单 | .pdf | 交易金额、对方信息、用途 |
-
-## 处理流程
-
-### Stage 1: 数据提取（extract）
-
-对每种文件类型进行识别和结构化提取：
-
-1. **读取文件**：使用适当的工具（Excel解析、PDF文字提取、OCR图片识别）
-2. **识别字段**：按文件类型提取对应字段
-3. **输出 JSON**：每种文件类型输出一个 JSON 文件
-
-输出文件：
-- `extracted/salary.json` — 工资数据
-- `extracted/invoices.json` — 发票数据
-- `extracted/bank_transactions.json` — 银行流水
-- `extracted/receipts.json` — 收据数据
-- `extracted/e_receipts.json` — 电子回单
-
-### Stage 2: 分类汇总 + 报表生成（summarize）
-
-1. **科目分类**：将每笔交易分配到对应的会计科目（参考 references/account-codes.md）
-2. **交叉核对**：银行流水 vs 发票/回单金额匹配
-3. **计算汇总**：
-   - 收入合计、成本合计、费用分类合计
-   - 应交增值税（销项 - 进项）
-   - 附加税（城建税、教育费附加）
-   - 企业所得税预缴
-4. **生成报表**：
-   - `report/balance_sheet.xlsx` — 资产负债表
-   - `report/income_statement.xlsx` — 利润表
-   - `report/cashflow_statement.xlsx` — 现金流量表
-
-## 数据格式规范
-
-### salary.json
-
-```json
-[
-  {
-    "name": "张三",
-    "basic_salary": 8000.00,
-    "social_insurance": 1200.00,
-    "housing_fund": 800.00,
-    "personal_tax": 150.00,
-    "net_salary": 5850.00
-  }
-]
-```
-
-### invoices.json
-
-```json
-[
-  {
-    "invoice_code": "3200221130",
-    "invoice_number": "12345678",
-    "date": "2026-01-15",
-    "seller": "XX办公用品有限公司",
-    "buyer": "客户公司名称",
-    "amount": 1000.00,
-    "tax_amount": 130.00,
-    "tax_rate": 0.13,
-    "total": 1130.00,
-    "type": "input",
-    "category": "办公用品"
-  }
-]
-```
-
-### bank_transactions.json
-
-```json
-[
-  {
-    "date": "2026-01-10",
-    "summary": "转账-货款",
-    "debit": 5000.00,
-    "credit": 0,
-    "counterparty": "XX供应商",
-    "balance": 150000.00
-  }
-]
-```
-
-## 规则
-
-1. **精度**：所有金额精确到分（两位小数），使用 `number` 类型
-2. **科目编码**：必须使用标准五级编码（见 references/account-codes.md）
-3. **进销项分离**：增值税进项税额和销项税额必须分开统计
-4. **不确定标记**：无法确定分类的交易标记为 `REVIEW`，不要猜测
-5. **凭证对应**：每笔会计分录必须有原始凭证对应
-6. **借贷平衡**：每笔分录借方合计 = 贷方合计
-7. **跨期检查**：确认所有凭证日期在当前季度范围内
-
-## 常见科目分类指引
-
-| 业务类型 | 借方科目 | 贷方科目 |
-|---------|---------|---------|
-| 销售收入 | 应收账款/银行存款 | 主营业务收入 + 应交税费-销项税 |
-| 采购商品 | 库存商品 + 应交税费-进项税 | 应付账款/银行存款 |
-| 发放工资 | 应付职工薪酬 | 银行存款 |
-| 计提工资 | 管理费用-工资/销售费用-工资 | 应付职工薪酬 |
-| 办公用品 | 管理费用-办公费 | 银行存款/库存现金 |
-| 房租水电 | 管理费用-租赁费/水电费 | 银行存款 |
-| 差旅费 | 管理费用-差旅费 | 库存现金/银行存款 |
-| 社保公积金 | 管理费用-社保/公积金 | 银行存款 |
-| 折旧 | 管理费用-折旧 | 累计折旧 |
-| 银行手续费 | 财务费用-手续费 | 银行存款 |
-
-## 错误处理
-
-- 文件无法读取 → 记录到 `extracted/errors.json`，继续处理其他文件
-- OCR 识别模糊 → 标记 `confidence: low`，分类为 `REVIEW`
-- 金额不匹配 → 记录差异到 `report/discrepancies.json`
-- 跨期凭证 → 标记 `out_of_period: true`，不计入当期
-
-## 项目记忆
-
-利用 SPS 记忆系统（~/.coral/memory/projects/<project>/）保存客户特有规则：
-- 特殊科目分类习惯
-- 固定资产折旧信息
-- 社保基数和比例
-- 经常性业务的分类模板

package/skills/tax-worker/references/account-codes.md

@@ -1,165 +0,0 @@
-# 小企业会计准则 — 常用科目编码表（五级）
-
-## 一、资产类（1xxx）
-
-### 1001 库存现金
-- 1001.01 人民币现金
-
-### 1002 银行存款
-- 1002.01 基本户
-- 1002.02 一般户
-
-### 1122 应收账款
-- 按客户设明细
-
-### 1123 预付账款
-- 按供应商设明细
-
-### 1131 应收股利
-
-### 1221 其他应收款
-- 1221.01 备用金
-- 1221.02 押金保证金
-
-### 1401 材料采购
-
-### 1403 原材料
-
-### 1405 库存商品
-
-### 1601 固定资产
-- 1601.01 房屋建筑物
-- 1601.02 机器设备
-- 1601.03 运输工具
-- 1601.04 电子设备
-- 1601.05 办公家具
-
-### 1602 累计折旧
-
-### 1701 无形资产
-
-### 1702 累计摊销
-
-## 二、负债类（2xxx）
-
-### 2001 短期借款
-
-### 2201 应付账款
-- 按供应商设明细
-
-### 2202 预收账款
-- 按客户设明细
-
-### 2211 应付职工薪酬
-- 2211.01 工资
-- 2211.02 社会保险费
-- 2211.03 住房公积金
-- 2211.04 福利费
-
-### 2221 应交税费
-- 2221.01 应交增值税
-  - 2221.01.01 进项税额
-  - 2221.01.02 销项税额
-  - 2221.01.03 已交税金
-  - 2221.01.04 转出未交增值税
-- 2221.02 未交增值税
-- 2221.03 应交企业所得税
-- 2221.04 应交个人所得税
-- 2221.05 应交城市维护建设税
-- 2221.06 应交教育费附加
-- 2221.07 应交地方教育附加
-- 2221.08 应交印花税
-
-### 2231 应付利息
-
-### 2241 其他应付款
-
-## 三、所有者权益类（3xxx）
-
-### 3001 实收资本
-
-### 3002 资本公积
-
-### 3101 盈余公积
-
-### 3103 本年利润
-
-### 3104 利润分配
-- 3104.01 未分配利润
-
-## 四、成本类（4xxx）
-
-### 4001 生产成本
-- 4001.01 直接材料
-- 4001.02 直接人工
-- 4001.03 制造费用
-
-### 4101 制造费用
-
-## 五、损益类（5xxx / 6xxx）
-
-### 5001 主营业务收入
-- 按产品/服务分明细
-
-### 5051 其他业务收入
-
-### 5111 投资收益
-
-### 5301 营业外收入
-
-### 5401 主营业务成本
-- 按产品/服务分明细
-
-### 5402 其他业务成本
-
-### 5403 营业税金及附加
-- 5403.01 城市维护建设税
-- 5403.02 教育费附加
-- 5403.03 地方教育附加
-- 5403.04 印花税
-
-### 5601 销售费用
-- 5601.01 工资
-- 5601.02 广告费
-- 5601.03 运输费
-- 5601.04 业务招待费
-
-### 5602 管理费用
-- 5602.01 工资
-- 5602.02 办公费
-- 5602.03 差旅费
-- 5602.04 租赁费
-- 5602.05 水电费
-- 5602.06 折旧费
-- 5602.07 修理费
-- 5602.08 社会保险费
-- 5602.09 住房公积金
-- 5602.10 业务招待费
-- 5602.11 咨询服务费
-- 5602.12 通讯费
-
-### 5603 财务费用
-- 5603.01 利息支出
-- 5603.02 手续费
-- 5603.03 利息收入（借方红字）
-
-### 5711 营业外支出
-
-### 5801 所得税费用
-
-## 增值税税率参考
-
-| 类型 | 税率 |
-|------|------|
-| 一般货物销售 | 13% |
-| 交通运输、建筑、基础电信 | 9% |
-| 现代服务、生活服务 | 6% |
-| 小规模纳税人 | 3%（减按1%） |
-
-## 附加税费率
-
-| 税种 | 税率 | 计算基数 |
-|------|------|---------|
-| 城市维护建设税 | 7%（市区）/ 5%（县镇）/ 1%（其他） | 实际缴纳的增值税 |
-| 教育费附加 | 3% | 实际缴纳的增值税 |
-| 地方教育附加 | 2% | 实际缴纳的增值税 |

package/skills/typescript/SKILL.md

@@ -1,51 +0,0 @@
----
-name: typescript
-description: TypeScript language skill — types, idioms, async, tooling. Pair with end skills (`backend`, `frontend`, `mobile`) for architecture and with `coding-standards` for cross-language principles.
-origin: ecc-fork + original (https://github.com/affaan-m/everything-claude-code, MIT)
----
-
-# TypeScript
-
-Type system, idioms, async, tooling. **Language-focused**. Architecture belongs to end skills; general principles (TDD, naming, error strategy) live in `coding-standards`.
-
-## When to load
-
-- Project primary language is TypeScript (Node.js / Deno / Bun / browser)
-- Reviewing TS code
-- Designing types, generics, discriminated unions
-- Setting up `tsconfig.json`, build, test tooling
-
-## Core principles
-
-1. **`strict: true`, always.** Non-negotiable. The rest of TS is barely worth using without it.
-2. **No `any`.** Use `unknown` + narrowing if you don't know the shape. Every `any` in review gets a blocker.
-3. **Types describe intent.** Prefer `UserId` branded type over bare `string`; use discriminated unions over boolean flags.
-4. **Inference first.** Let TS infer; add annotations on public signatures and where inference is wrong or opaque.
-5. **`const` by default, `let` only when reassigning.** Never `var`.
-6. **Immutability where practical.** `readonly` on fields, `ReadonlyArray<T>` for inputs.
-7. **`===` only.** `==` has JS quirks; there is no legitimate reason to use it in new code.
-8. **Explicit error types at boundaries** (HTTP, queue, FFI). Inside, throw freely.
-
-## How to use references
-
-| Reference | When to load |
-|---|---|
-| [`references/types.md`](references/types.md) | Generics, unions, discriminated unions, conditional types, utility types, brands |
-| [`references/idioms.md`](references/idioms.md) | Destructuring, optional chaining, nullish coalescing, modules, enums vs. union |
-| [`references/async.md`](references/async.md) | Promises, async/await, error propagation, cancellation (AbortController), concurrency |
-| [`references/errors.md`](references/errors.md) | Error classes, `Result` / `neverthrow`, `try/catch`, re-throw semantics |
-| [`references/testing.md`](references/testing.md) | Vitest / Jest, mocking, fixtures, integration tests |
-| [`references/tooling.md`](references/tooling.md) | `tsconfig`, ESLint, formatter, bundlers, monorepo layout |
-
-## Forbidden patterns (auto-reject)
-
-- `any` without a comment explaining why
-- `as X` casts without runtime validation (use a schema validator at boundaries)
-- `==` / `!=`
-- `var`
-- Unhandled promise (`.then()` without `.catch()`, or an `await` without containing `try`)
-- `Function` / `Object` as a type
-- Default-exporting everything in new code (named exports — one public name per import)
-- Enums for string constants (use literal string unions instead — smaller, tree-shakeable)
-- Mutating function parameters
-- `console.log` left in committed code