Skip to content

fix(skills): update tsfile skills to follow current version - #916

Open
Alchuang22-dev wants to merge 3 commits into
apache:developfrom
Alchuang22-dev:feat/skills
Open

fix(skills): update tsfile skills to follow current version#916
Alchuang22-dev wants to merge 3 commits into
apache:developfrom
Alchuang22-dev:feat/skills

Conversation

@Alchuang22-dev

Copy link
Copy Markdown
Contributor

Summary

The PR is an update for tsfile skills.

Contents

The PR contains the following changes:

  • fix routing problems found in experiments
  • update tsfile content from 2026-02-19 to 2026-08-18

@ColinLeeo
ColinLeeo requested a lite review from CopilotAugust 21, 2026 10:17

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Warning

Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.

Updates the TsFile skill documentation/routing to reflect the current (2026-08-18) baseline and fix routing mismatches found in experiments.

Changes:

  • Add new “current capabilities” reference docs (properties/TAG filters, encoding/compression, Java tools, DataFrame/Arrow, C++ build/write, advanced APIs).
  • Refine skill scope and routing guidance between tsfile and tsfile-cli.
  • Expand docs-map.yaml authorities and restructure tool routing entries.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 6 comments.

Show a summary per file
FileDescription
skills/tsfile/references/properties-filters.mdNew reference for file properties and Table TAG filter behavior across bindings.
skills/tsfile/references/performance.mdAdds pointer to the encoding/compression factory matrix reference.
skills/tsfile/references/java-tools.mdNew reference for Java CLI tooling (import + point-count).
skills/tsfile/references/encoding-compression.mdNew matrix reference for supported encoding/compression factories.
skills/tsfile/references/docs-map.yamlUpdates local authorities and adds “current_capabilities” and restructured tool routing.
skills/tsfile/references/dataframe-arrow.mdNew reference for Python DataFrame and Arrow batch I/O.
skills/tsfile/references/cpp-build-write.mdNew reference for C++ build/linkage and parallel write configuration.
skills/tsfile/references/advanced-apis.mdNew reference for advanced APIs (row queries, metadata, recovery, TsBlock, etc.).
skills/tsfile/SKILL.mdExpands scope/routing rules and links to new reference docs.
skills/tsfile-cli/SKILL.mdClarifies scope separation vs Java tools and point-count behavior.
cpp/tools/skills/tsfile-cli/SKILL.mdAligns embedded skill doc with updated tsfile-cli scope and routing guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

- cpp/tools/
java:
owner_skill:
path: SKILL.md

## Encoding and Compression

- Read `references/encoding-compression.md` for the current constructible
`cpp/src/cwrapper/tsfile_cwrapper.h`; do not guess buffer ownership.

The Java table point-count metadata is a reserved use of file properties. Use
`references/java-tools.md` for inspection or backfill instead of editing those
- Use `TsFileDataFrame` for a lazy unified numeric view across one or more
TsFile shards, metadata selection, or timestamp-aligned series access.
- Use Arrow batches for columnar interoperability without Python row loops.
- Use `references/java-tools.md` instead for Arrow file import through the Java
Comment on lines +32 to +39
| data type | current supported encodings |
|---|---|
| `BOOLEAN` | `PLAIN`, `RLE` |
| `INT32`, `INT64`, `DATE`, `TIMESTAMP` | `PLAIN`, `RLE`, `TS_2DIFF`, `GORILLA`, `ZIGZAG`, `CHIMP`, `SPRINTZ`, `RLBE` |
| `FLOAT` | `PLAIN`, `RLE`, `TS_2DIFF`, `GORILLA_V1`, `GORILLA`, `CHIMP`, `SPRINTZ`, `RLBE` |
| `DOUBLE` | the FLOAT set plus `CAMEL` |
| `TEXT`, `STRING` | `PLAIN`, `DICTIONARY` |
| `BLOB`, `OBJECT` | `PLAIN` |
Comment on lines +53 to +60
| value encoding | current accepted data types |
|---|---|
| `PLAIN` | all types handled by `PlainEncoder`/`PlainDecoder` |
| `DICTIONARY` | `STRING`, `TEXT` |
| `RLE` | `INT32`, `DATE`, `INT64`, `TIMESTAMP` |
| `TS_2DIFF`, `GORILLA` | `INT32`, `DATE`, `INT64`, `TIMESTAMP`, `FLOAT`, `DOUBLE` |
| `ZIGZAG` | `INT32`, `INT64` |
| `SPRINTZ` | `INT32`, `INT64`, `FLOAT`, `DOUBLE` |
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Alchuang22-dev