@laitszkin/apollo-toolkit 3.13.0 → 3.13.2
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 +38 -107
- package/CHANGELOG.md +21 -1
- package/CLAUDE.md +38 -0
- package/README.md +9 -16
- package/analyse-app-logs/scripts/__pycache__/filter_logs_by_time.cpython-312.pyc +0 -0
- package/analyse-app-logs/scripts/__pycache__/log_cli_utils.cpython-312.pyc +0 -0
- package/analyse-app-logs/scripts/__pycache__/search_logs.cpython-312.pyc +0 -0
- package/docs-to-voice/scripts/__pycache__/docs_to_voice.cpython-312.pyc +0 -0
- package/generate-spec/SKILL.md +3 -2
- package/generate-spec/scripts/__pycache__/create-specscpython-312.pyc +0 -0
- package/katex/scripts/__pycache__/render_katex.cpython-312.pyc +0 -0
- package/open-github-issue/scripts/__pycache__/open_github_issue.cpython-312.pyc +0 -0
- package/optimise-skill/SKILL.md +10 -2
- package/optimise-skill/references/example_skill.md +10 -2
- package/package.json +1 -1
- package/read-github-issue/scripts/__pycache__/find_issues.cpython-312.pyc +0 -0
- package/read-github-issue/scripts/__pycache__/read_issue.cpython-312.pyc +0 -0
- package/resolve-review-comments/scripts/__pycache__/review_threads.cpython-312.pyc +0 -0
- package/review-spec-related-changes/SKILL.md +1 -1
- package/text-to-short-video/scripts/__pycache__/enforce_video_aspect_ratio.cpython-312.pyc +0 -0
package/AGENTS.md
CHANGED
|
@@ -1,107 +1,38 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
##
|
|
4
|
-
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
- `
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
|
|
38
|
-
-
|
|
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,27 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this repository are documented in this file.
|
|
4
4
|
|
|
5
|
-
## [
|
|
5
|
+
## [v3.13.2] - 2026-05-14
|
|
6
|
+
|
|
7
|
+
### Changed
|
|
8
|
+
|
|
9
|
+
- Clarify `review-spec-related-changes` subagent dimension scope so each subagent reviews one specific dimension.
|
|
10
|
+
|
|
11
|
+
## [v3.13.1] - 2026-05-14
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
|
|
15
|
+
- Rewrite `AGENTS.md` into a compact project-instructions format focused on development commands, business goals, and documentation index.
|
|
16
|
+
- Add project-level `CLAUDE.md` with consistent content.
|
|
17
|
+
- Change `optimise-skill` description to Chinese and add section spacing for readability.
|
|
18
|
+
- Add architecture diff visualization acceptance criterion to `generate-spec`.
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
|
|
22
|
+
- Standardized `docs/` structure with feature, architecture, and principle categories.
|
|
23
|
+
- Sync `README.md` skill list with the actual curated catalog.
|
|
24
|
+
|
|
25
|
+
## [v3.13.0] - 2026-05-14
|
|
6
26
|
|
|
7
27
|
### Changed
|
|
8
28
|
|
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
|
-
-
|
|
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
|
-
-
|
|
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
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/generate-spec/SKILL.md
CHANGED
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/optimise-skill/SKILL.md
CHANGED
|
@@ -1,36 +1,44 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: optimise-skill
|
|
3
|
-
description:
|
|
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:
|
|
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
|
Binary file
|
|
Binary file
|
|
Binary file
|