[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6ACEVB6C9RC8G17RYSRE29F":3,"skill-same:01M6ACEVB6C9RC8G17RYSRE29F":78},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":50,"linkOnly":51,"markdownContent":52,"markdownBody":53,"frontMatter":54,"refName":55,"commitSha":56,"skillDirectory":57,"forksCount":58,"repositoryHtmlUrl":59,"repositoryHomepageUrl":60,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":6,"updatedAt":63,"install":64,"resources":77},"01M6ACEVB6C9RC8G17RYSRE29F","feature-workflow",null,"Taking a multi-PR feature from \"shape unknown\" to merged without five review rounds per PR: spike until interfaces stop moving, write the contract, cut PRs along contract seams, one review per PR. Use when starting a feature that touches more than one lifecycle object or public interface, when a PR review keeps changing interfaces, or when splitting a large branch.","apache\u002Ftika","apache","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F47359?v=4","01M6AC83E6K4FDKK7HZ8WNMQKE","The Apache Software Foundation","01M6ACEMPJD6J74AGZBFFEGEYV",4145,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fdevs\u002Ffeature-workflow\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000037","律师与法务","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49],"workflow","feature workflow","feature","shape","when","prs","unknown","object","more","interface","multi","cut","contract","review","use","write","branch","lifecycle","pr","pr review","spike","2026-11-10 10:12:30",false,"---\nname: feature-workflow\ndescription: >\n  Taking a multi-PR feature from \"shape unknown\" to merged without five\n  review rounds per PR: spike until interfaces stop moving, write the\n  contract, cut PRs along contract seams, one review per PR. Use when\n  starting a feature that touches more than one lifecycle object or public\n  interface, when a PR review keeps changing interfaces, or when splitting a\n  large branch.\n---\n\n\u003C!--\nLicensed to the Apache Software Foundation (ASF) under one or more\ncontributor license agreements.  See the NOTICE file distributed with\nthis work for additional information regarding copyright ownership.\nThe ASF licenses this file to You under the Apache License, Version 2.0\n(the \"License\"); you may not use this file except in compliance with\nthe License.  You may obtain a copy of the License at\n\n    http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n-->\n\nLocal override: `$TIKA_SKILLS_LOCAL\u002Ffeature-workflow\u002FLOCAL.md` (default `~\u002F.tika-skills`),\nread after this file, wins on conflict.\n\n# Feature Workflow: spike, contract, cut, ship\n\nA complex feature's shape is learned by building it. Learning it *on the PR*\ncosts a review round per lesson and reshapes what the next round reviews.\nKeep learning and shipping on different branches.\n\n## 1. Spike\n\nThrowaway branch. Build end to end, roughly: no CHANGES, docs, or polish;\nchange neighbors freely. Review it (`.skills\u002Fdevs\u002Fpr-review\u002FSKILL.md`) and let\nfindings reshape interfaces.\n\n**Exit:** the last review changed edge-case handling, not an interface. While\nreviews still rename, split, or add methods, keep spiking (pr-review verdict\n\"still spiking\").\n\n## 2. Contract\n\nWrite down what the spike taught, half a page per lifecycle object\n(open\u002Fclose, acquire\u002Frelease, publish\u002Fabort, spill, rewind): states and\ntransitions, each method's behavior per state, resource ownership on success\nand every failure path, threading. Put it in the type's javadoc.\n\nEncode it as an `Abstract\u003CType>ContractTest` every implementation extends:\nclose twice, abort then close, write after close, throw mid-write then close,\nresources released on both paths. This is what makes review converge.\n\n## 3. Cut PRs\n\nSplit *after* the spike, one contract (or tightly coupled group) per PR.\nSplitting before is guesswork and leaves one PR holding five contracts.\nEach PR carries only that contract's files, its contract test, CHANGES, docs.\nEverything else waits for its own PR or the todo doc.\n\n## 4. Ship\n\nPer PR: one high-effort review, fix, one confirm pass on the delta. A third\nround means either a fix changed an interface (pull that piece back to the\nspike) or findings are out of scope (todo doc, not the fix commit). Never\nwiden a PR during review.\n\n| You see | Do |\n|---|---|\n| Review adds\u002Frenames\u002Fsplits a type or method | keep spiking; no PR yet |\n| Review finds edge cases only | write contract + test, cut PR |\n| PR review changes an interface | pull piece back to spike |\n| PR review finds out-of-scope issue | todo doc, not this PR |\n| Third review round on a PR | one of the two above applies |\n\n## Cross-cutting refactors (chokepoints, wire formats)\n\nA refactor claiming \"every X goes through Y\" — a policy chokepoint, a single\nserialization route — is a contract too, with three extra rules. (Learned on\nTIKA-4848, where all three were violated and each violation became a\npost-merge review round.)\n\n- **Enforcement ships with the invariant, default-on.** The PR that creates\n  the chokepoint also adds the build-breaking check (forbidden-apis ban,\n  architecture test) that keeps call sites on it — every module, explicit\n  opt-outs. Opt-in checks document an invariant; only default-on maintains\n  it. Without this, each missed call site is a review finding instead of a\n  compile failure.\n\n- **One thin end-to-end test per transport surface.** A knob that crosses a\n  JVM boundary is exercised through each surface it rides (in-JVM, server,\n  pipes fork, grpc) in the invariant's own PR. Diff review cannot see a\n  parent-resolves\u002Ffork-deserializes seam; a wire test can.\n\n- **Producer and consumer change together.** Both halves of a\n  serializer\u002Fdeserializer or parent\u002Ffork protocol pair go in the same PR.\n  Cutting by module puts every seam between two reviews, and seams are where\n  cross-cutting bugs live.\n\nNo compat shim without a caller: grep before deprecating-in-place. A shim\nfor an API nothing calls is dead weight that still carries bugs.\n","\u003C!--\nLicensed to the Apache Software Foundation (ASF) under one or more\ncontributor license agreements.  See the NOTICE file distributed with\nthis work for additional information regarding copyright ownership.\nThe ASF licenses this file to You under the Apache License, Version 2.0\n(the \"License\"); you may not use this file except in compliance with\nthe License.  You may obtain a copy of the License at\n\n    http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n-->\n\nLocal override: `$TIKA_SKILLS_LOCAL\u002Ffeature-workflow\u002FLOCAL.md` (default `~\u002F.tika-skills`),\nread after this file, wins on conflict.\n\n# Feature Workflow: spike, contract, cut, ship\n\nA complex feature's shape is learned by building it. Learning it *on the PR*\ncosts a review round per lesson and reshapes what the next round reviews.\nKeep learning and shipping on different branches.\n\n## 1. Spike\n\nThrowaway branch. Build end to end, roughly: no CHANGES, docs, or polish;\nchange neighbors freely. Review it (`.skills\u002Fdevs\u002Fpr-review\u002FSKILL.md`) and let\nfindings reshape interfaces.\n\n**Exit:** the last review changed edge-case handling, not an interface. While\nreviews still rename, split, or add methods, keep spiking (pr-review verdict\n\"still spiking\").\n\n## 2. Contract\n\nWrite down what the spike taught, half a page per lifecycle object\n(open\u002Fclose, acquire\u002Frelease, publish\u002Fabort, spill, rewind): states and\ntransitions, each method's behavior per state, resource ownership on success\nand every failure path, threading. Put it in the type's javadoc.\n\nEncode it as an `Abstract\u003CType>ContractTest` every implementation extends:\nclose twice, abort then close, write after close, throw mid-write then close,\nresources released on both paths. This is what makes review converge.\n\n## 3. Cut PRs\n\nSplit *after* the spike, one contract (or tightly coupled group) per PR.\nSplitting before is guesswork and leaves one PR holding five contracts.\nEach PR carries only that contract's files, its contract test, CHANGES, docs.\nEverything else waits for its own PR or the todo doc.\n\n## 4. Ship\n\nPer PR: one high-effort review, fix, one confirm pass on the delta. A third\nround means either a fix changed an interface (pull that piece back to the\nspike) or findings are out of scope (todo doc, not the fix commit). Never\nwiden a PR during review.\n\n| You see | Do |\n|---|---|\n| Review adds\u002Frenames\u002Fsplits a type or method | keep spiking; no PR yet |\n| Review finds edge cases only | write contract + test, cut PR |\n| PR review changes an interface | pull piece back to spike |\n| PR review finds out-of-scope issue | todo doc, not this PR |\n| Third review round on a PR | one of the two above applies |\n\n## Cross-cutting refactors (chokepoints, wire formats)\n\nA refactor claiming \"every X goes through Y\" — a policy chokepoint, a single\nserialization route — is a contract too, with three extra rules. (Learned on\nTIKA-4848, where all three were violated and each violation became a\npost-merge review round.)\n\n- **Enforcement ships with the invariant, default-on.** The PR that creates\n  the chokepoint also adds the build-breaking check (forbidden-apis ban,\n  architecture test) that keeps call sites on it — every module, explicit\n  opt-outs. Opt-in checks document an invariant; only default-on maintains\n  it. Without this, each missed call site is a review finding instead of a\n  compile failure.\n\n- **One thin end-to-end test per transport surface.** A knob that crosses a\n  JVM boundary is exercised through each surface it rides (in-JVM, server,\n  pipes fork, grpc) in the invariant's own PR. Diff review cannot see a\n  parent-resolves\u002Ffork-deserializes seam; a wire test can.\n\n- **Producer and consumer change together.** Both halves of a\n  serializer\u002Fdeserializer or parent\u002Ffork protocol pair go in the same PR.\n  Cutting by module puts every seam between two reviews, and seams are where\n  cross-cutting bugs live.\n\nNo compat shim without a caller: grep before deprecating-in-place. A shim\nfor an API nothing calls is dead weight that still carries bugs.\n",{"name":5,"description":7},"main","9f8b48425fea3630020924f6ae96e98eabb9ce12",".skills\u002Fdevs\u002Ffeature-workflow",1039,"https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika","https:\u002F\u002Ftika.apache.org\u002F","https:\u002F\u002Fgithub.com\u002Fapache","https:\u002F\u002Fwww.apache.org\u002F","2026-11-13 08:35:47",{"source":8,"skillName":5,"commands":65,"prompt":75,"zipAvailable":76},[66,69,72],{"tool":67,"command":68},"npx","npx skills add apache\u002Ftika --skill feature-workflow",{"tool":70,"command":71},"bunx","bunx skills add apache\u002Ftika --skill feature-workflow",{"tool":73,"command":74},"pnpm","pnpm dlx skills add apache\u002Ftika --skill feature-workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fdevs\u002Ffeature-workflow\u002FSKILL.md",true,[],[79,117,142,168,193,218],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":92,"publishedAt":50},"01M6ACFKZR081Z7QX5XB1ZA2R2","file-to-markdown","Turn almost any file into Markdown plus metadata — PDF, Office, HTML, email, archives, images, audio\u002Fvideo, 1000+ formats — powered by Apache Tika, either via the tika-app CLI (zero setup, one file) or a running tika-server (curl, warm process, many calls). Leads with rmeta (structured, embedded-item-aware output) as the default operation rather than flat concatenated text, since you can't tell whether a file has embedded content from its extension. Covers metadata-only triage, type and language detection, OCR, and output-size discipline for agent context. Use whenever a task involves reading the content of a file whose format you don't want to hand-parse.","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fusers\u002Ffile-to-markdown\u002FSKILL.md",[85,88,91],{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000002","文档处理",{"categoryNo":89,"categoryName":90,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[93,94,95,96,97,9,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116],"file to markdown","markdown","file","PDF","cli","triage","setup","content","metadata","tika","images","Video","app","ocr","Audio","parse","default","only","either","you","hand","text","server","discipline",{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":127,"publishedAt":50},"01M6ACFHJR3612ZE6RNX1P5WG9","file-to-markdown-docker","Run Apache Tika as a Docker container when you need guaranteed OCR (scanned PDFs, images) or geospatial raster support with zero local install — `apache\u002Ftika:\u003Cversion>-full` bundles Tesseract, GDAL, ImageMagick, and fonts. Also covers the minimal image, port\u002Fvolume\u002Fmemory conventions, the path-identity mount gotcha, and how to confirm OCR actually ran rather than silently returning no text. Powered by Apache Tika. Use when a local `tika-app`\u002F`tika-server` doesn't have Tesseract installed, or you want a disposable, self-contained parsing environment. Companion to the `file-to-markdown` skill, which covers the parsing calls themselves once a server is up.","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fusers\u002Ffile-to-markdown-docker\u002FSKILL.md",[123,124],{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":125,"categoryName":126,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000011","运维与部署",[128,129,93,94,95,9,130,131,132,133,134,102,103,105,106,135,136,137,138,139,33,112,140,114,141],"file to markdown docker","docker","support","memory","image","run","identity","which","volume","up","local","how to","fonts","self",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":149,"publishedAt":50},"01M6ACFE1684DE184VE0D7PQVY","file-forensics","Examine what a file claims about itself and what it actually contains — powered by Apache Tika. True content-based type detection (extensions lie), provenance claims (authors, dates, creating application), revision and tamper signals (PDF incremental updates, tracked changes, hidden slides, zip integrity), hidden and embedded content (attachments, macros), risk indicators (PDF JavaScript actions, encryption), and content digests. Evidence gathering, not verdicts: Tika reports what the file asserts and what parsing observed; it does not attribute authorship or validate signatures. Use for triaging suspicious files, provenance questions, e-discovery-style review, or \"is this file what it claims to be.\"","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fusers\u002Ffile-forensics\u002FSKILL.md",[148],{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},[150,95,151,152,153,96,9,154,100,42,102,155,156,157,158,159,160,161,162,163,164,165,166,167],"file forensics","forensics","javascript","suspicious","validate","actions","signatures","files","updates","encryption","reports","claims","signals","revision","integrity","zip","evidence","risk",{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":50},"01M6ACFB92SPADF0FY4490B847","update-site-for-release","Update\u002Fpublish the Apache Tika website (tika-site SVN repo) for a release — step 17 of the Release Process. Handles the 4.x track (Changes page + aggregate javadoc + Antora docs branch) vs the 3.x maintenance track (full per-version apt docs + javadoc). Use for \"update the site\", \"publish the site for X.Y.Z\", \"the website part of the release\".","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fdevs\u002Fupdate-site-for-release\u002FSKILL.md",[],[175,176,177,178,179,9,180,181,102,45,182,183,184,185,186,187,188,189,43,190,191,192],"update","release","update site for release","for","site","release process","docs","publish","track","website","svn","full","apt","page","repo","version","changes","maintenance",{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":197,"categories":198,"keywords":205,"publishedAt":50},"01M6ACF9G52NYHXQ0BVSJ3VH6E","tika-eval-h2-query","Query the tika-eval H2 database directly for counts and joins the canned reports do not compute — connection gotchas, key tables, example queries. Use when the xlsx\u002Fsummary.md reports are not enough.","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fdevs\u002Ftika-eval-h2-query\u002FSKILL.md",[199,202],{"categoryNo":200,"categoryName":201,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000004","电子表格",{"categoryNo":203,"categoryName":204,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",[206,102,207,208,209,210,211,178,212,43,33,213,160,214,215,216,217],"tika eval h2 query","eval","query","database","xlsx","do","example","compute","queries","summary","connection","tables",{"skillNo":219,"name":220,"nameZh":6,"description":221,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":222,"categories":223,"keywords":224,"publishedAt":50},"01M6ACF7V56CCWHNVR614VBNX5","tika-eval-encoding-regression","Condensed tika-eval pattern for charset-detector regression hunts (\"A picks encoding X, B picks Y\") using one build and two configs — encoding-pair flip queries, OOV\u002Flanguageness\u002FFFFD signals, per-file detector attribution.","https:\u002F\u002Fgithub.com\u002Fapache\u002Ftika\u002Fblob\u002Fmain\u002F.skills\u002Fdevs\u002Ftika-eval-encoding-regression\u002FSKILL.md",[],[225,102,226,207,227,178,228,95,214,162,229,230,231,232],"tika eval encoding regression","regression","encoding","attribution","build","detector","pattern","pair"]