@laitszkin/apollo-toolkit 3.13.0 → 3.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -1,107 +1,38 @@
1
- # AGENTS Guide
2
-
3
- ## Project Architecture
4
-
5
- - This repository is a skill catalog: each top-level skill lives in its own directory and is installable when that directory contains `SKILL.md`.
6
- - Typical skill layout is lightweight and consistent: `SKILL.md`, `README.md`, `LICENSE`, plus optional `agents/`, `references/`, and `scripts/`.
7
- - The npm package exposes an `apollo-toolkit` CLI that stages a managed copy under `~/.apollo-toolkit` and copies or symlinks each skill folder into selected target directories.
8
- - The installer writes a `.apollo-toolkit-manifest.json` per target directory to track installed skills, historical skill names, and install mode for future uninstall and deduplication.
9
- - `scripts/install_skills.sh` and `scripts/install_skills.ps1` remain available for local/curl installs and mirror the managed-home install behavior with symlink/copy choice and uninstall support.
10
-
11
- ## Core Business Flow
12
-
13
- This repository enables users to install and run a curated set of reusable agent skills for software delivery, research, repository maintenance, and media-generation workflows.
14
-
15
- - Users can align project documentation with the current codebase.
16
- - Users can consolidate completed project specs and batch-level coordination plans into a standardized README and categorized project documentation set, then archive only the truly consumed planning files.
17
- - Users can investigate application logs, slice them to precise time windows, search by keyword or regex, and produce evidence-backed root-cause findings.
18
- - Users can answer repository-backed questions with additional web research when needed.
19
- - Users can commit and push local changes without performing version or release work.
20
- - Users can manage Codex user-preference memory by reviewing the last 24 hours of chats, storing reusable preference-first memory documents under `~/.codex/memory`, and syncing a memory index into `~/.codex/AGENTS.md`.
21
- - Users can research a topic deeply and produce evidence-based deliverables.
22
- - Users can research the latest completed market week and produce a PDF watchlist of tradeable instruments for the coming week.
23
- - Users can turn a marked weekly finance PDF into a concise evidence-based financial event report.
24
- - Users can install Apollo Toolkit through npm or npx and interactively choose one or more target skill directories to populate with copied or symlinked skills, with the option to include codex-exclusive skills in non-codex targets.
25
- - Users can uninstall Apollo Toolkit-installed skills through an interactive target selector or specific non-interactive targets via `apltk uninstall`.
26
- - Users can choose between symlink mode (auto-update via git pull) and copy mode (stable snapshot) with `--symlink` / `--copy` flags.
27
- - Users can run bundled helper tools through `apltk tools` and direct `apltk <tool>` commands for selected packaged skill scripts.
28
- - Users can design and implement new features through a spec-first workflow.
29
- - Users can generate shared feature planning artifacts for approval-gated workflows, including parallel multi-spec batches coordinated through `coordination.md` and, only when needed, minimal non-business prerequisite work in `preparation.md`.
30
- - Users can convert text or documents into audio files with subtitle timelines.
31
- - Users can turn lecture slides, past papers, and answer books into mock exams, worked solutions, study notes, or graded PDFs with KaTeX-rendered math.
32
- - Users can extend existing features in a brownfield codebase with required tests and approvals.
33
- - Users can propose product features from an existing codebase and publish accepted proposals.
34
-
35
- - Users can read, filter, and inspect remote GitHub issues before planning follow-up work.
36
- - Users can resolve a GitHub issue end-to-end and push the fix directly to a requested branch without opening a PR.
37
-
38
- - Users can run a shared submission-readiness pass that synchronizes changelog, project docs, `AGENTS.md`, and completed plan archives before commit, push, PR creation, or release.
39
- - Users can learn new or improved skills from recent Codex conversation history.
40
- - Users can audit and maintain the skill catalog itself, including dependency classification and shared-skill extraction decisions.
41
- - Users can optimize existing agent skills by deriving the intended deliverable, tightening acceptance criteria, and rewriting `SKILL.md` into a leaner structure backed by extracted references.
42
- - Users can implement approved spec planning sets directly in the current checkout and commit them to the active branch.
43
- - Users can implement approved spec planning sets inside isolated git worktrees and keep the parent checkout clean.
44
- - Users can coordinate approved multi-spec implementation batches by assigning each spec directory to an independent worktree-backed subagent with bounded concurrency.
45
- - Users can summarize mistakes into separate multiple-choice and long-answer error books backed by structured reference files and rendered PDFs.
46
- - Users can build or review marginfi protocol integrations using official SDK, CLI, protocol, and The Arena documentation.
47
- - Users can create or maintain `AGENTS.md` so project constraints stay aligned with the repository.
48
- - Users can turn novel content into a loopable short-form video with generated assets.
49
- - Users can publish structured GitHub issues or feature proposals with auth fallbacks.
50
- - Users can prepare and open open-source pull requests from existing changes.
51
- - Users can generate storyboard image sets from chapters, novels, articles, or scripts.
52
- - Users can configure OpenClaw from official documentation, including `~/.openclaw/openclaw.json`, skills loading, SecretRefs, CLI edits, and validation or repair workflows.
53
- - Users can record multi-account spending and balance changes in monthly Excel ledgers with summary analytics and charts.
54
-
55
-
56
- - Users can review recent or user-specified spec-backed changes against the governing planning documents, treating unmet business goals as the most severe findings before secondary edge-case, security, and code-review checks.
57
- - Users can process GitHub pull request review comments and resolve addressed threads.
58
-
59
-
60
- - Users can investigate gated or shadow LLM APIs by capturing real client request shapes, replaying verified traffic patterns, and attributing the likely underlying model through black-box fingerprinting.
61
- - Users can build and maintain Solana programs and Rust clients using official Solana development workflows.
62
- - Users can fix issues discovered during a review pass by processing findings from highest to lowest severity, with per-fix validation and full-scope re-validation.
63
- - Users can add focused observability to opaque workflows through targeted logs, metrics, traces, and tests.
64
- - Users can iteratively improve repository code quality through behavior-neutral naming, simplification, module-boundary, logging, and test-coverage passes.
65
- - Users can iteratively improve repository performance through evidence-backed module scans, safe hot-path optimization, benchmark guardrails, batching, caching, allocation, concurrency, and repeated full-codebase stage gates.
66
- - Users can refresh the project HTML architecture atlas to reflect the latest committed or staged code changes by dispatching one subagent per affected feature and updating the base atlas via `apltk architecture` (no spec overlay).
67
- - Users can select risk-driven test levels and define unit drift checks through a shared testing strategy skill.
68
- - Users can build against Jupiter's official Solana swap, token, price, lending, trigger, recurring, and portfolio APIs with an evidence-based development guide.
69
- - Users can render and embed math formulas with KaTeX using official documentation-backed guidance and reusable rendering scripts.
70
- - Users can debug software systematically by reproducing causes, validating fixes, and testing outcomes.
71
- - Users can generate 30-60 second short videos directly from text prompts.
72
- - Users can prepare and publish versioned releases with changelog and tag workflows.
73
- - Users can generate long-form videos by orchestrating storyboard, voice, and Remotion-based production steps.
74
-
75
- ## Common Commands
76
-
77
- - `npm test` - 執行 Node 測試套件。
78
- - `node bin/apollo-toolkit.js` - 直接從倉庫啟動 Apollo Toolkit CLI。
79
- - `node bin/apollo-toolkit.js codex openclaw trae` - 以非互動方式將技能安裝到指定目標。
80
- - `node bin/apollo-toolkit.js tools` - 列出 Apollo Toolkit 內建 CLI 工具。
81
- - `node bin/apollo-toolkit.js filter-logs app.log --start 2026-03-24T10:00:00Z` - 透過內建工具包裝器執行技能腳本。
82
- - `node bin/apollo-toolkit.js architecture` - 開啟專案 `resources/project-architecture/index.html` 架構圖。
83
- - `node bin/apollo-toolkit.js architecture diff` - 將 `docs/plans/**/architecture_diff/` 與目前架構圖配對成分頁式 before/after viewer(輸出至 `.apollo-toolkit/architecture-diff/`)。
84
- - `python3 scripts/validate_skill_frontmatter.py` - 驗證所有頂層技能 `SKILL.md` 的 frontmatter。
85
- - `python3 scripts/validate_openai_agent_config.py` - 驗證所有技能 `agents/openai.yaml` 設定。
86
- - `./scripts/install_skills.sh codex` - 用本地安裝腳本把技能安裝到 Codex 目錄。
87
- - `./scripts/install_skills.sh codex --symlink` - 以 symlink 模式安裝(推薦)。
88
- - `./scripts/install_skills.sh all --copy` - 以複製模式安裝到所有支援目標。
89
- - `./scripts/install_skills.sh uninstall` - 從所有目標移除已安裝的技能。
90
- - `./scripts/install_skills.sh uninstall codex` - 只從 codex 目標移除。
91
- - `node bin/apollo-toolkit.js uninstall` - 透過 CLI 互動選擇要移除的 agent target 技能。
92
- - `node bin/apollo-toolkit.js uninstall codex --yes` - 以非互動方式移除指定 target 的已安裝技能。
93
-
94
- ## Core Project Purpose
95
-
96
- - Provide a curated set of reusable agent skills that can be installed into Codex/OpenClaw/Trae skill directories.
97
- - Keep skills focused, composable, and easy to reuse across workflows.
98
- - Prefer splitting shared capabilities into dedicated skills when multiple workflows can depend on them.
99
-
100
- ## Code Style And Conventions
101
-
102
- - Follow existing skill naming: kebab-case folder names and matching `name` values in `SKILL.md` frontmatter.
103
- - Keep documentation concise, operational, and evidence-based; avoid speculative guidance.
104
- - Reuse existing patterns from neighboring skills before introducing new structures.
105
- - Use a standardized `## Dependencies` section in every `SKILL.md` with `Required`, `Conditional`, `Optional`, and `Fallback` bullets whenever skill-to-skill orchestration matters.
106
- - Use a standardized `## Standards` section in every `SKILL.md` with `Evidence`, `Execution`, `Quality`, and `Output` bullets to summarize skill-specific constraints.
107
- - Keep helper scripts small and deterministic, and update repository docs when adding or moving a top-level skill.
1
+ # Apollo Toolkit
2
+
3
+ ## Common Development Commands
4
+
5
+ - `npm test` - 執行 Node 測試套件(`node --test`)。
6
+ - `node bin/apollo-toolkit.js [mode...]` - 直接從倉庫啟動 CLI,將技能安裝至指定目標(codex/openclaw/trae/agents/claude-code/all)。
7
+ - `node bin/apollo-toolkit.js uninstall [mode...]` - 從指定目標移除已安裝的 Apollo Toolkit 技能。
8
+ - `node bin/apollo-toolkit.js tools` - 列出所有內建 CLI 工具及其分類。
9
+ - `node bin/apollo-toolkit.js <tool> [args...]` - 執行內建工具(如 `filter-logs`、`search-logs`、`architecture`、`create-specs` 等)。
10
+ - `node bin/apollo-toolkit.js architecture [diff]` - 開啟專案 HTML 架構圖,或搭配 `diff` 產生分頁式 before/after 檢視器。
11
+ - `python3 scripts/validate_skill_frontmatter.py` - 驗證所有頂層技能 `SKILL.md` 的 frontmatter 格式與命名規範。
12
+ - `python3 scripts/validate_openai_agent_config.py` - 驗證所有技能 `agents/openai.yaml` 的設定完整性。
13
+ - `./scripts/install_skills.sh [mode...]` - 透過本地 shell 腳本安裝技能(非 npm 安裝方式)。
14
+
15
+ ## Project Business Goals
16
+
17
+ - Provide a curated set of reusable agent skills installable into Codex, OpenClaw, Trae, Agents, and Claude Code skill directories.
18
+ - Enable spec-first software delivery: feature planning, implementation (including parallel subagents and worktree isolation), code review, systematic debugging, and release management.
19
+ - Support evidence-based research (deep research, financial analysis, API fingerprinting), media generation (video, audio, storyboard), and educational content (PDF exams, error books, KaTeX rendering).
20
+ - Automate platform workflows: GitHub issue/PR operations, blockchain development (Solana, Jupiter, Marginfi), and OpenClaw configuration.
21
+ - Keep skills focused, composable, and easy to reuse; split shared capabilities into dedicated skills when multiple workflows can depend on them.
22
+
23
+ ## Project Documentation Index
24
+
25
+ - `docs/features/skill-installation.md` - 安裝、解除安裝與使用內建工具
26
+ - `docs/features/software-development.md` - spec 驅動的開發生命週期
27
+ - `docs/features/research-and-content.md` - 研究、媒體與教育內容生成
28
+ - `docs/features/platform-automation.md` - GitHub、區塊鏈與 OpenClaw 自動化
29
+ - `docs/features/catalog-maintenance.md` - 技能優化、記憶管理、記帳與驗證
30
+ - `docs/architecture/cli-architecture.md` - CLI 設計:命令調度、工具註冊、更新檢查
31
+ - `docs/architecture/installer-architecture.md` - 安裝器設計:原子同步、manifest 追蹤、連結模式
32
+ - `docs/architecture/skill-structure.md` - 技能目錄佈局、frontmatter 規範、選擇性擴充
33
+ - `docs/principles/naming-conventions.md` - 命名慣例:kebab-case、文件命名、工具命名
34
+ - `docs/principles/skill-development.md` - 技能開發慣例:frontmatter、主體結構、依賴宣告
35
+ - `docs/principles/testing-conventions.md` - 測試慣例:node:test、隔離、Python 測試發現
36
+ - `README.md` - 公開安裝指南與技能目錄
37
+ - `CHANGELOG.md` - 版本發佈歷史
38
+ - `LICENSE` - MIT 授權條款
package/CHANGELOG.md CHANGED
@@ -2,7 +2,21 @@
2
2
 
3
3
  All notable changes to this repository are documented in this file.
4
4
 
5
- ## [Unreleased]
5
+ ## [v3.13.1] - 2026-05-14
6
+
7
+ ### Changed
8
+
9
+ - Rewrite `AGENTS.md` into a compact project-instructions format focused on development commands, business goals, and documentation index.
10
+ - Add project-level `CLAUDE.md` with consistent content.
11
+ - Change `optimise-skill` description to Chinese and add section spacing for readability.
12
+ - Add architecture diff visualization acceptance criterion to `generate-spec`.
13
+
14
+ ### Added
15
+
16
+ - Standardized `docs/` structure with feature, architecture, and principle categories.
17
+ - Sync `README.md` skill list with the actual curated catalog.
18
+
19
+ ## [v3.13.0] - 2026-05-14
6
20
 
7
21
  ### Changed
8
22
 
package/CLAUDE.md ADDED
@@ -0,0 +1,38 @@
1
+ # Apollo Toolkit
2
+
3
+ ## Common Development Commands
4
+
5
+ - `npm test` - 執行 Node 測試套件(`node --test`)。
6
+ - `node bin/apollo-toolkit.js [mode...]` - 直接從倉庫啟動 CLI,將技能安裝至指定目標(codex/openclaw/trae/agents/claude-code/all)。
7
+ - `node bin/apollo-toolkit.js uninstall [mode...]` - 從指定目標移除已安裝的 Apollo Toolkit 技能。
8
+ - `node bin/apollo-toolkit.js tools` - 列出所有內建 CLI 工具及其分類。
9
+ - `node bin/apollo-toolkit.js <tool> [args...]` - 執行內建工具(如 `filter-logs`、`search-logs`、`architecture`、`create-specs` 等)。
10
+ - `node bin/apollo-toolkit.js architecture [diff]` - 開啟專案 HTML 架構圖,或搭配 `diff` 產生分頁式 before/after 檢視器。
11
+ - `python3 scripts/validate_skill_frontmatter.py` - 驗證所有頂層技能 `SKILL.md` 的 frontmatter 格式與命名規範。
12
+ - `python3 scripts/validate_openai_agent_config.py` - 驗證所有技能 `agents/openai.yaml` 的設定完整性。
13
+ - `./scripts/install_skills.sh [mode...]` - 透過本地 shell 腳本安裝技能(非 npm 安裝方式)。
14
+
15
+ ## Project Business Goals
16
+
17
+ - Provide a curated set of reusable agent skills installable into Codex, OpenClaw, Trae, Agents, and Claude Code skill directories.
18
+ - Enable spec-first software delivery: feature planning, implementation (including parallel subagents and worktree isolation), code review, systematic debugging, and release management.
19
+ - Support evidence-based research (deep research, financial analysis, API fingerprinting), media generation (video, audio, storyboard), and educational content (PDF exams, error books, KaTeX rendering).
20
+ - Automate platform workflows: GitHub issue/PR operations, blockchain development (Solana, Jupiter, Marginfi), and OpenClaw configuration.
21
+ - Keep skills focused, composable, and easy to reuse; split shared capabilities into dedicated skills when multiple workflows can depend on them.
22
+
23
+ ## Project Documentation Index
24
+
25
+ - `docs/features/skill-installation.md` - 安裝、解除安裝與使用內建工具
26
+ - `docs/features/software-development.md` - spec 驅動的開發生命週期
27
+ - `docs/features/research-and-content.md` - 研究、媒體與教育內容生成
28
+ - `docs/features/platform-automation.md` - GitHub、區塊鏈與 OpenClaw 自動化
29
+ - `docs/features/catalog-maintenance.md` - 技能優化、記憶管理、記帳與驗證
30
+ - `docs/architecture/cli-architecture.md` - CLI 設計:命令調度、工具註冊、更新檢查
31
+ - `docs/architecture/installer-architecture.md` - 安裝器設計:原子同步、manifest 追蹤、連結模式
32
+ - `docs/architecture/skill-structure.md` - 技能目錄佈局、frontmatter 規範、選擇性擴充
33
+ - `docs/principles/naming-conventions.md` - 命名慣例:kebab-case、文件命名、工具命名
34
+ - `docs/principles/skill-development.md` - 技能開發慣例:frontmatter、主體結構、依賴宣告
35
+ - `docs/principles/testing-conventions.md` - 測試慣例:node:test、隔離、Python 測試發現
36
+ - `README.md` - 公開安裝指南與技能目錄
37
+ - `CHANGELOG.md` - 版本發佈歷史
38
+ - `LICENSE` - MIT 授權條款
package/README.md CHANGED
@@ -6,53 +6,46 @@ A curated skill catalog for Codex, OpenClaw, Trae, Agents, and Claude Code with
6
6
 
7
7
  - align-project-documents
8
8
  - analyse-app-logs
9
- - archive-specs
10
9
  - answering-questions-with-research
11
- - commit-and-push
10
+ - archive-specs
11
+ - cjk-pdf
12
12
  - codex-memory-manager
13
+ - commit-and-push
13
14
  - deep-research-topics
14
15
  - develop-new-features
15
-
16
16
  - docs-to-voice
17
- - exam-pdf-workflow
18
17
  - document-vision-reader
19
18
  - enhance-existing-features
19
+ - exam-pdf-workflow
20
20
  - feature-propose
21
21
  - financial-research
22
- - read-github-issue
23
22
  - generate-spec
24
-
25
23
  - implement-specs
26
24
  - implement-specs-with-subagents
27
25
  - implement-specs-with-worktree
28
- - init-project-html
29
26
  - improve-observability
30
- - iterative-code-performance
31
- - iterative-code-quality
27
+ - init-project-html
32
28
  - jupiter-development
33
29
  - katex
34
30
  - learn-skill-from-conversations
35
31
  - learning-error-book
36
- - marginfi-development
37
32
  - maintain-project-constraints
33
+ - marginfi-development
34
+ - merge-changes-from-local-branches
38
35
  - novel-to-short-video
39
36
  - open-github-issue
40
37
  - open-source-pr-workflow
41
38
  - openai-text-to-image-storyboard
42
39
  - openclaw-configuration
43
40
  - optimise-skill
44
-
41
+ - read-github-issue
45
42
  - record-spending
46
43
  - resolve-review-comments
47
-
48
-
49
44
  - review-spec-related-changes
50
-
51
45
  - shadow-api-model-research
46
+ - ship-github-issue-fix
52
47
  - solana-development
53
- - spec-to-project-html
54
48
  - solve-issues-found-during-review
55
- - submission-readiness-check
56
49
  - systematic-debug
57
50
  - test-case-strategy
58
51
  - text-to-short-video
@@ -9,8 +9,9 @@ description: 當你需要將用戶模糊的複雜需求拆解成有嚴格實作
9
9
 
10
10
  ## 驗收條件
11
11
 
12
- - 已經產出了嚴格遵循模板格式的spec。
13
- - 為spec當中的需求制定了明確的驗收條件及測試策略
12
+ - 已經產出了嚴格遵循模板格式的 spec。
13
+ - 為 spec 當中的需求制定了明確的驗收條件及測試策略。
14
+ - 完成了spec 對應的 architecture diff 並可視化展示架構設計方便用戶審核 spec。
14
15
 
15
16
  ## 工作流程
16
17
 
@@ -1,36 +1,44 @@
1
1
  ---
2
2
  name: optimise-skill
3
- description: Use prompt engineering to optimise agent skill. Use it when you need to optimise a `SKILL.md`
3
+ description: 當你需要優化 agent skills `SKILL.md` 時,調用這個技能。
4
4
  ---
5
5
 
6
6
  ## 目標
7
+
7
8
  在不影響被優化技能整體流程前提下,利用提示詞工程,對技能進行優化,減少冗余表達,增強agent對技能的理解能力以及實際工作中的使用效率。
8
9
 
9
10
  ## 驗收條件
11
+
10
12
  - 被優化技能的最終交付產物不受影響
11
13
  - 被優化技能有顯著冗余削減,且具備精確提示能力,盡最大可能釋放LLM的性能
12
14
 
13
15
  ## 工作流程
14
16
 
15
17
  ### 1. 識別交付物
18
+
16
19
  完整閱讀整個技能的 `SKILL.md` 文檔,以及其引用的所有額檔案,包括但不限於 `references/` , `scripts/` 。基於獲取到的技能上下文資訊,總結出該技能的最終交付產物。
17
20
 
18
21
  ### 2. 制定驗收條件
22
+
19
23
  制定驗收條件,從而確保LLM能夠穩定、可復現地按照驗收條件產出符合要求高質量最終交付物
20
24
 
21
25
  ### 3. 重寫技能
26
+
22
27
  將整個技能的 `SKILL.md` 重寫。重寫後的技能應該只包含以下幾個關鍵組成部分:
23
28
  - 目標
24
29
  - 驗收條件
25
30
  - 工作流程
26
- - 範例
31
+ - 範例(選用)
27
32
  - 參考資料
33
+
28
34
  對於技能有幫助的內但不符合上述技能架構規範,則應該被分類放置在 `references/` 下的markdown檔案。
29
35
 
30
36
  ## 範例
37
+
31
38
  - "一個專注在提示LLM agent進行自我迭代,並為repo帶來性能優化的技能需要被優化" -> "定義驗收條件為優化後性能相較優化前至少提升X個百分比,並且項目之中不存在任何O(n^2)級別時間複雜度的函式和邏輯,並按照標準架構重寫技能。"
32
39
  - "一個有大量前端開發範例被包含在 `SKILL.md` 之中的前端開發技能需要被優化" -> "定義驗收條件為前端頁面 `reference` 之中提供的大量建議範例重寫且不包含任何建議示例之中明確拒絕的設計,然後按照技能優化流程對技能進行全面的重寫。"
33
40
 
34
41
  ## 參考資料
42
+
35
43
  - `references/example_skill.md` - 優化後的技能範例,在進行技能優化時必須閱讀並嚴格遵照當中格式 **(必讀)**
36
44
  - `references/definition.md` - 技能之中各個區塊的定義 **(必讀)**
@@ -1,36 +1,44 @@
1
1
  ---
2
2
  name: optimise-skill
3
- description: Use prompt engineering to optimise agent skill. Use it when you need to optimise a `SKILL.md`
3
+ description: 當你需要優化 agent skills `SKILL.md` 時,調用這個技能。
4
4
  ---
5
5
 
6
6
  ## 目標
7
+
7
8
  在不影響被優化技能整體流程前提下,利用提示詞工程,對技能進行優化,減少冗余表達,增強agent對技能的理解能力以及實際工作中的使用效率。
8
9
 
9
10
  ## 驗收條件
11
+
10
12
  - 被優化技能的最終交付產物不受影響
11
13
  - 被優化技能有顯著冗余削減,且具備精確提示能力,盡最大可能釋放LLM的性能
12
14
 
13
15
  ## 工作流程
14
16
 
15
17
  ### 1. 識別交付物
18
+
16
19
  完整閱讀整個技能的 `SKILL.md` 文檔,以及其引用的所有額檔案,包括但不限於 `references/` , `scripts/` 。基於獲取到的技能上下文資訊,總結出該技能的最終交付產物。
17
20
 
18
21
  ### 2. 制定驗收條件
22
+
19
23
  制定驗收條件,從而確保LLM能夠穩定、可復現地按照驗收條件產出符合要求高質量最終交付物
20
24
 
21
25
  ### 3. 重寫技能
26
+
22
27
  將整個技能的 `SKILL.md` 重寫。重寫後的技能應該只包含以下幾個關鍵組成部分:
23
28
  - 目標
24
29
  - 驗收條件
25
30
  - 工作流程
26
- - 範例
31
+ - 範例(選用)
27
32
  - 參考資料
33
+
28
34
  對於技能有幫助的內但不符合上述技能架構規範,則應該被分類放置在 `references/` 下的markdown檔案。
29
35
 
30
36
  ## 範例
37
+
31
38
  - "一個專注在提示LLM agent進行自我迭代,並為repo帶來性能優化的技能需要被優化" -> "定義驗收條件為優化後性能相較優化前至少提升X個百分比,並且項目之中不存在任何O(n^2)級別時間複雜度的函式和邏輯,並按照標準架構重寫技能。"
32
39
  - "一個有大量前端開發範例被包含在 `SKILL.md` 之中的前端開發技能需要被優化" -> "定義驗收條件為前端頁面 `reference` 之中提供的大量建議範例重寫且不包含任何建議示例之中明確拒絕的設計,然後按照技能優化流程對技能進行全面的重寫。"
33
40
 
34
41
  ## 參考資料
42
+
35
43
  - `references/example_skill.md` - 優化後的技能範例,在進行技能優化時必須閱讀並嚴格遵照當中格式 **(必讀)**
36
44
  - `references/definition.md` - 技能之中各個區塊的定義 **(必讀)**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@laitszkin/apollo-toolkit",
3
- "version": "3.13.0",
3
+ "version": "3.13.1",
4
4
  "description": "Apollo Toolkit npm installer for managed skill copying across Codex, OpenClaw, and Trae.",
5
5
  "license": "MIT",
6
6
  "author": "LaiTszKin",