{"_id":"ops-wiki-agent-kit","_rev":"7-eb33347544ba82ea0936cc49f02430be","name":"ops-wiki-agent-kit","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.4":{"name":"ops-wiki-agent-kit","version":"0.1.4","license":"UNLICENSED","_id":"ops-wiki-agent-kit@0.1.4","maintainers":[{"name":"heimlich","email":"jerry791129@gmail.com"}],"bin":{"ops-wiki-agent-kit":"ops-wiki-agent-kit.js"},"dist":{"shasum":"59343dff1f3dbacf2a4e1e81b4f4a0bb6cc39c88","tarball":"https://registry.npmjs.org/ops-wiki-agent-kit/-/ops-wiki-agent-kit-0.1.4.tgz","fileCount":33,"integrity":"sha512-Ev90psxhq3I9WTINu3GBS8s06sSNkrqUH1szVHZdnQvzw07RGLqAyFW6AXmpKT46Eq7X1X7jTv3K3JiqFeN6oQ==","signatures":[{"sig":"MEUCIQDfQU8k8ls4YJtT4oQEpPt9KWE6c/XJ97x64A1n3rA9pwIgLSBseKFN0orH3NO/LGEcWJx75zYFk8d7NbFAPxKWc20=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":494400},"engines":{"node":">=18"},"gitHead":"3cb08780b26a3bdb54e9ae65a481ef677ab35204","scripts":{"check":"node ops-wiki-agent-kit.js --help","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"heimlich","email":"jerry791129@gmail.com"},"_npmVersion":"10.9.4","description":"Install Ops Wiki agent, prompt, and skill toolkits into a project.","directories":{},"_nodeVersion":"22.21.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ops-wiki-agent-kit_0.1.4_1783046444344_0.45232158966810077","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"ops-wiki-agent-kit","version":"0.1.5","description":"Install Ops Wiki agent, prompt, and skill toolkits into a project.","license":"UNLICENSED","bin":{"ops-wiki-agent-kit":"ops-wiki-agent-kit.js"},"scripts":{"check":"node ops-wiki-agent-kit.js --help","pack:dry-run":"npm pack --dry-run"},"engines":{"node":">=18"},"_id":"ops-wiki-agent-kit@0.1.5","gitHead":"890b3b7678abbe987b679b2f188d4c7d7c1ab091","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-adCFMsWVhnSQcHBHgN5lp93vEXt6lfellgRZGhDG4Ti4xGrn4XtfQXleSEzVLJJkN9t0ickYYot4OF5ztyaaxg==","shasum":"e8126d7e7314e51edc3154f235307722b9b24aa4","tarball":"https://registry.npmjs.org/ops-wiki-agent-kit/-/ops-wiki-agent-kit-0.1.5.tgz","fileCount":34,"unpackedSize":508235,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGHxr92c5M8RlUCsS9Q1Bk2o3ocop9ovb9flq/9wfkx1AiAcv7cN3JJF4xwoMku6zyR1mk9OquWcpT7Nkdw+4b0lxw=="}]},"_npmUser":{"name":"heimlich","email":"jerry791129@gmail.com"},"directories":{},"maintainers":[{"name":"heimlich","email":"jerry791129@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ops-wiki-agent-kit_0.1.5_1783319538973_0.3587305063588695"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-03T02:40:44.126Z","modified":"2026-07-06T06:32:19.231Z","0.1.0":"2026-06-15T03:19:24.078Z","0.1.1":"2026-06-29T01:09:54.136Z","0.1.2":"2026-06-29T08:57:48.752Z","0.1.3":"2026-07-01T02:52:48.412Z","0.1.4":"2026-07-03T02:40:44.515Z","0.1.5":"2026-07-06T06:32:19.116Z"},"license":"UNLICENSED","description":"Install Ops Wiki agent, prompt, and skill toolkits into a project.","maintainers":[{"name":"heimlich","email":"jerry791129@gmail.com"}],"readme":"# ops-wiki-agent-kit\n\n`ops-wiki-agent-kit` 是用來把 Ops Wiki agent toolkit 初始化到既有專案的 npm CLI package。\n\n安裝後會建立或更新目標專案的 `.github` toolkit 內容：\n\n- `.github/agents`\n- `.github/prompts`\n- `.github/skills`\n- `docs/docs-target-queue.md`\n\n此 package 不會散佈 `.github/copilot-instructions.md`，也不會打包 `docs/source-code-to-spec-agent-toolkit-guide.html`。\n\n## 使用方式\n\n在目標專案根目錄執行：\n\n```bash\nnpx ops-wiki-agent-kit init\n```\n\n預設行為：\n\n- 將 toolkit 複製到目前目錄的 `.github`\n- 已存在的檔案不會被覆蓋\n- 已存在的檔案會顯示為 `skip`\n\n指定目標專案：\n\n```bash\nnpx ops-wiki-agent-kit init --target ./my-project\n```\n\n預覽將寫入的檔案：\n\n```bash\nnpx ops-wiki-agent-kit init --dry-run\n```\n\n允許覆蓋既有檔案：\n\n```bash\nnpx ops-wiki-agent-kit init --force\n```\n\n更新既有 toolkit 到新版：\n\n```bash\nnpx ops-wiki-agent-kit update\n```\n\n指定版本更新：\n\n```bash\nnpx ops-wiki-agent-kit@0.0.1 update\n```\n\n`update` 的行為：\n\n- 會覆蓋目前 package 內存在的 toolkit 檔案\n- 若目標專案已存在舊 manifest，會移除舊版曾安裝、但新版 package 已不存在的 managed 檔案\n- 不會移除使用者自行新增、且不在 manifest 追蹤內的檔案\n\n第一次執行 `init` 或 `update` 後，CLI 會在目標專案建立 `.github/.ops-wiki-agent-kit-manifest.json`，用來追蹤哪些檔案是由此 package 管理。\n\n如果目標專案是從更早期、尚未寫入 manifest 的版本升上來，第一次 `update` 會先覆蓋現有 toolkit 並建立 manifest，但無法安全判斷哪些舊檔是應該刪除的 stale managed 檔案。\n\n## 發佈流程\n\n第一次發佈前需要登入 npm：\n\n```bash\nnpm login\n```\n\n登入後確認目前帳號：\n\n```bash\nnpm whoami\n```\n\n發佈前先檢查會被打包的內容：\n\n```bash\nnpm run pack:dry-run\n```\n\n確認 package 內只包含 npm 必要檔案、`.github/agents`、`.github/prompts`、`.github/skills` 與 `docs/docs-target-queue.md`，且沒有包含 HTML guide 後，再發佈：\n\n```bash\nnpm publish\n```\n\n發佈後，其他專案即可使用：\n\n```bash\nnpx ops-wiki-agent-kit init\n```\n\n若其他專案已安裝舊版 toolkit，建議改用：\n\n```bash\nnpx ops-wiki-agent-kit@latest update\n```\n\n## 套件命名\n\n建議 package name：\n\n```text\nops-wiki-agent-kit\n```\n\n原因：\n\n- 保留 `ops-wiki` 專案語意\n- 表示內容是 agent、prompt、skill toolkit\n- `npx ops-wiki-agent-kit init` 可讀性足夠\n- 名稱長度適中\n\n如果未來要放到 npm organization scope，也可以改成：\n\n```text\n@acer/ops-wiki-agent-kit\n```\n\nscope package 第一次發佈通常要指定 access：\n\n```bash\nnpm publish --access public\n```\n\n## 開發檢查\n\n顯示 CLI help：\n\n```bash\nnpm run check\n```\n\n檢查 npm package 內容：\n\n```bash\nnpm run pack:dry-run\n```\n","readmeFilename":"README.md"}