Skip to content
Skills Library
AI & agents · Building & coding

tool-forge

/tool-forge

自适应工具铸造:探测 TOOL_GAP 后为当前 Agent 铸造工具与技能骨架并登记能力目录。触发词:缺工具、TOOL_GAP、造一个工具、自适应构建、forge、工具铸造、补技能。

Licence
CC-BY-4.0
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

CC-BY-4.0, otwarta.

What it does and when to use it

自适应工具铸造:探测 TOOL_GAP 后为当前 Agent 铸造工具与技能骨架并登记能力目录。触发词:缺工具、TOOL_GAP、造一个工具、自适应构建、forge、工具铸造、补技能。

Original author description

自适应工具铸造:探测 TOOL_GAP 后为当前 Agent 铸造工具与技能骨架并登记能力目录。触发词:缺工具、TOOL_GAP、造一个工具、自适应构建、forge、工具铸造、补技能。

How it works

  1. 定位
  2. 输入契约
  3. 执行步骤
  4. 输出契约
  5. 质量铁律
  6. 关联
Original SKILL.md headings · 66 lines, 164 words
SKILL.md preview
---
name: tool-forge
description: 自适应工具铸造:探测 TOOL_GAP 后为当前 Agent 铸造工具与技能骨架并登记能力目录。触发词:缺工具、TOOL_GAP、造一个工具、自适应构建、forge、工具铸造、补技能。
status: active
---

# tool-forge — 自适应工具铸造协议

## 定位

驱动本项目的 Agent 在发现**工具/技能缺口**时,按本协议为自己铸造可调用资产,
而不是空等外部交付或伪造执行结果。

## 输入契约

- 已运行 `python -m engine.workflow_cli probe`(或明确的缺口描述)
- 缺口名称与目的(purpose)

## 执行步骤

1. **确认缺口类型**
   - `python_package` / `cli`:环境类——**不自动伪造安装**,按 probe hint 配置或改用替代
   - 任务缺工具/技能:进入铸造
   - 可选宿主适配器缺失:可铸造 adapter 元数据,或直接忽略(协议不依赖)

2. **铸造资产**
   ```bash
   cd academic-toolkit
   python -m engine.workflow_cli forge --tool my-tool --purpose "一句话目的"
   python -m engine.workflow_cli forge --skill my-skill --purpose "一句话目的" --linked-tool my-tool
   python -m engine.workflow_cli forge --adapter my-host --purpose "某宿主可选适配"
   # 或按 probe gap 建议:
   python -m engine.workflow_cli forge --gap '{"kind":"optional_adapter","id":"foo","hint":"..."}'
   ```
   默认不覆盖已有文件;确需覆盖加 `--force`。

3. **实现真实逻辑**
   - 打开 `tools/<name>.py` 按任务实现;骨架的 `implemented: false` 必须在真实完成前保持诚实
   - 输出保持 `--json` 机读契约,便于 evidence 与门禁消费

4. **补全技能契约**
   - 完善 `skills/<name>/SKILL.md` 的输入/输出/步骤/铁律
   - 短横线命名的技能须映射进 `capabilities/catalog.json`(映射一致性由工具箱 asset 系门禁与 `tools/check_asset_utilization.py --strict` 校验)

5. **自检与留痕**
   ```bash
   python tools/<name>.py --json
   python -m pytest -q   # 若改了 catalog/skills(仓库根全套件)
   ```
   通过当前执行会话运行forge命令并声明真实输入输出;命令回执和内容摘要由程序记录。

## 输出契约

- 铸造结果 JSON(路径、status=created/exists、invoke 命令)
- catalog 登记状态(技能类)
- 实现状态:scaffolded → implemented(有真实测试/产物后才可改)

## 质量铁律

- TOOL_GAP:铸造前不宣称能力已存在
- 无证据=未执行:evidence 必须包含真实命令与产物
- 名称约束:`[a-z0-9][a-z0-9-]{1,63}`
- 默认不覆盖已有工具/技能(防误伤既有资产)

## 关联

- 实现: `academic-toolkit/engine/host/tool_forge.py`
- 探测: `academic-toolkit/engine/host/capability_probe.py`
- 自举: `skills/agent-bootstrap`
- 目录: `capabilities/catalog.json`

Versions

The database has no other skills named tool-forge.

Database snapshot: 13.11.2026 · package version 13c662cbd8cc (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100skf-setup
    Initialize forge environment, detect tools, and set capability tier (Quick/Forge/Forge+/Deep). Use when the user requests to "set up the forge" or "initialize the forge".
  • 100skf-setup
    Initialize forge environment, detect tools, and set capability tier (Quick/Forge/Forge+/Deep). Use when the user requests to "set up the forge" or "initialize the forge".
  • 100forge-install
    This skill should be used when the user wants to "install the Forge plugin", "set up Forge", "install forge-agent-lens-for-claude-code", "configure Forge for the first time", "get started with Forge tracing", or needs to complete the initial setup of the Forge Agent Lens for…
  • 100forge-config
    This skill should be used when the user wants to "configure Forge", "set Forge project", "change Forge project", "set wandb api key", "update Forge settings", "show Forge config", "change Forge configuration", "restart the Forge daemon", "apply Forge config changes", "restart…
  • 90forge-catalog
    Use when choosing which Forge agent, skill, command, bundle, or workflow should handle a request; when comparing Forge capabilities; when building a focused install surface; or when a user asks "what should I use?" before starting work. Routes to the smallest useful Forge…
  • 90Core NXTG-Forge
    Ground truth for the NXTG-Forge platform — the real forge CLI subcommands, the /nxtg-forge:* slash commands, the .forge/state.json + events.jsonl model, both MCP servers (Rust orchestrator + Node governance), the agent roster, and the security hooks. Use when working inside or…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.