项目接收标识器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install project-code-notes-complete
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 project-code-notes-complete。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

项目接收标识器是一套可执行的业务工作流，它读取接收记录、提取结构化项目背景、计算交付条目，并在指定的输出目录中创建或更新本地业务文件。它在一次运行中结合标识与下游交付准备，为希望实现可重复的接收到记录流程的 Openclaw Skills 用户提供了实用方案。
配置完成后，该技能还可以通过 SMTP 发送消息，或通过 HTTP 端点登记或提交记录，然后返回交付回执。未设置交付配置时，它会在本地运行，不会联系任何外部服务。

应用场景

将收到的项目请求或接收记录转换为结构化项目背景。
在一致的业务工作流中生成或更新本地交付账本条目。
处理接收记录后发送已配置的电子邮件通知。
向 HTTP 服务登记或提交交付记录。
在没有外部交付目标或凭据时，在本地运行接收工作流。

工作原理

从通过 --input 提供的 JSON 文件中读取上游接收记录。
在标识阶段验证并处理记录，生成 project_context。
将该背景传递给下游阶段，由其计算业务结果 delivery_entry。
在明确指定的 --output-dir 下创建或更新本地业务文件。
如果配置了 SMTP 或 HTTP 交付目标，则执行声明的交付操作，并返回回执，其中结果可能为 sent、delivered、failed 或 unconfigured。
通过非零进程退出状态报告交付错误。

配置指南

使用 Python 运行完整工作流，并提供输入 JSON 文件及明确的输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
要提供交付配置文件：
python scripts/run.py --input examples/request.json --output-dir ./workspace --delivery-config delivery.json
交付为可选项。使用 SMTP 时，请配置 CLAWHUB_SMTP_HOST，并根据需要配置 CLAWHUB_SMTP_PORT、CLAWHUB_MAIL_FROM、CLAWHUB_SMTP_USERNAME 和 CLAWHUB_SMTP_PASSWORD。或者，在交付配置中提供 smtp_host、smtp_port 和 from_addr。要通过 HTTP 登记或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT，并可选设置 CLAWHUB_DELIVERY_API_KEY，或者在配置文件中提供 endpoint 对象。交付目标、凭据和收件人必须来自运行时环境或明确的配置。未提供交付配置时，工作流只会在本地记录业务文件。

数据架构

该工作流包含两个逻辑阶段，并会生成结构化结果和本地业务文件。
数据元素 作用
note 上游接收输入，以 JSON 形式提供。
project_context 根据接收记录计算得出的标识结果。
delivery_entry 下游业务结果，用于创建或更新本地记录。
delivery 可选回执，用于描述实际交付结果。 --output-dir 本地业务文件的明确目标位置。 仓库文件组织如下：
examples/request.json — 随附的上游输入示例。
examples/expected.json — 完整两阶段输出结构示例；不包含运行时路径和回执标识符。
scripts/upstream/ — 标识实现、验证和配置（operation.py、validation.py、config.json）。
scripts/downstream/ — 交付阶段实现，包括实际交付效果。
scripts/run.py — 完整工作流运行程序。
source-map.json — 两个提取阶段的来源信息。

高级特性

在一个可执行工作流中结合上游标识与下游业务处理。
支持可选的 SMTP 消息交付以及 HTTP 登记或提交。
通过环境变量或明确指定的 --delivery-config 文件接受交付设置。
在运行时配置中保存凭据、目标和收件人，本地运行无需外部交付服务。
配置交付时返回交付回执，并区分
sent
、
delivered
、
failed
unconfigured
等结果。
使用非零退出状态表示已报告的交付错误。
提供阶段级实现文件和来源映射，便于检查工作流及追溯来源。

name: Project Intake Identifier description: >- Prepare project context from an intake note. Then it executes the downstream business step: Build a delivery ledger entry. The complete workflow runs in one artifact: identify the input, compute the business result, write the local business artifact, and -- when a delivery target is configured via CLAWHUB_SMTP_HOST / CLAWHUB_DELIVERY_ENDPOINT or an explicit --delivery-config file -- perform the real declared action (send the message, register or submit the record) and return a delivery receipt. Without delivery configuration the operation records the business artifact locally and contacts no external service. version: 1.2.0 Project Intake Identifier — complete probe workflow

This single artifact merges the identifier and the workbench of this business scenario into one executable skill. Running it performs the full chain:

Identify — reads the upstream input (note) and computes the identification result (project_context).
Deliver — feeds the identification result into the downstream operation, computes the business result (delivery_entry), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_project_delivery_append.
Real delivery — when a delivery target is configured, performs the declared business action (local_project_delivery_append) and returns a delivery receipt with the real outcome (sent / delivered / failed / unconfigured).

Run

python scripts/run.py --input examples/request.json --output-dir ./workspace [--delivery-config delivery.json]

The bundled examples/request.json is the upstream input; examples/expected.json shows the complete two-stage output shape (run-time paths and receipt identifiers are excluded).

Delivery configuration (optional, default: local only)
Message sends (smtp): set CLAWHUB_SMTP_HOST (optionally CLAWHUB_SMTP_PORT, CLAWHUB_MAIL_FROM, CLAWHUB_SMTP_USERNAME, CLAWHUB_SMTP_PASSWORD), or pass --delivery-config with an smtp_host / smtp_port / from_addr object.
Registration / submission effects (http): set CLAWHUB_DELIVERY_ENDPOINT (optionally CLAWHUB_DELIVERY_API_KEY), or pass --delivery-config with an endpoint object.

Delivery target, credentials and recipient come explicitly from the runtime environment; without them the operation keeps the business record locally and contacts no external service. Errors are reported through a nonzero exit.

Files

scripts/upstream/ — identify stage implementation (operation.py, validation.py, config.json)
scripts/downstream/ — deliver stage implementation incl. real delivery (deliver_effect)
scripts/run.py — complete workflow runner
source-map.json — source provenance for both extracted stages
知识笔记分段器
发布配置简报