关于 postplus-workspace
postplus-workspace 是用于管理 PostPlus 项目上下文和营销活动的技能。它将已确认事实、获批声明与假设分开记录,并为重要操作设置审批门槛,便于持续推进工作。
主要功能
- 01初始化项目工作区和营销活动
- 02根据记录状态继续工作
- 03区分事实、获批声明与假设
- 04按工作阶段检查准备情况
- 05重要操作前要求审批
适用场景
- 01启动 PostPlus 项目文件夹
- 02继续现有营销活动
- 03发布前检查阻塞项
- 04记录效果观察与后续步骤
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill postplus-workspace安装后在 Claude Code 中输入/postplus-workspace确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/project-template/AGENTS.mdassets.mdaudience.mdbrand.mdhooks.mdpersona.mdproduct.mdproject.yamlassets/project-template/campaign-template/campaign.mdcreative-strategy.mdproduction-brief.mdresults.mdtest-plan.mdreferences/context-schema.mdstage-gates.mduncertainty-policy.mdscripts/workspace.py详细介绍
PostPlus 工作区
将一个已解析的项目文件夹转变为 PostPlus 后续工作的持久上下文和控制面。复用已确认的品牌、产品、用户画像和营销活动事实;一次性任务无需设置工作区。只读取与任务相关的事实,将已批准的声明与创意区分开来,并且只在授权范围内修改。本技能负责工作区编排。PostPlus 专项技能负责领域判断。当前的 PostPlus CLI 和服务负责架构、验证、费用、权限和提供商执行。
核心约定
- 行动前先读取工作区。
- 将已确认事实、已批准声明、研究发现、假设、默认值、未知项和禁止内容区分开来。
- 绝不编造产品事实、价格、优惠、身份、引用、权限、审批或结果。
- 仅当缺失或冲突的信息会影响真实性、策略、身份、执行、合规、支出或发布时才提问。
- 对可逆、低风险的制作选择,无需询问即可决定。
- 通过目录和 CLI 架构了解当前 PostPlus 功能,而不是维护硬编码的技能清单。
- 更改已批准的事实、批准测试计划、花费积分、启动、发布或更改在线广告前,必须获得明确批准。
- 将可持续保留的结果和决策写回工作区。
路由
| 请求 | 路由 |
|---|---|
| 启动 PostPlus 项目文件夹 | 初始化工作区 |
| 启动营销活动或测试周期 | 初始化营销活动 |
| 继续现有项目 | 恢复工作区 |
| 诊断缺失的上下文 | 检查所请求的阶段 |
| 研究、策略、测试或制作 | 读取阶段上下文,然后路由至当前专项技能 |
| 报价、启动、发布或更改支出 | 使用当前 CLI 验证,然后获取明确批准 |
| 分析表现 | 记录观察结果、结论、范围和下一步假设 |
初始化工作区
- 确定准确的目标文件夹并检查现有文件。
- 运行
postplus doctor --skill postplus-workspace --json。如果缺少 Python 3,请按其给出的具体操作执行;如果未提供可执行的操作,则报告依赖项及受影响的任务,并停止。不要猜测包管理器、安装命令或管理员权限。 - 确定此已安装技能的目录并运行:
<python-3-command> <skill-directory>/scripts/workspace.py init \
--target <folder> --project "<project name>" \
[--brand "<brand>"] [--product "<product>"] \
[--market "<market>"] [--platform "<platform>"] \
--output <folder>/.postplus/workspace-init.json
仅传入用户提供或有可靠来源的信息。入口程序只会创建缺失的文件,并会拒绝文件系统根目录、用户主目录和已安装技能目录。
读取现有源材料,只填写已确认的信息,保留 UNKNOWN,然后运行入门检查。
初始化营销活动
运行:
<python-3-command> <skill-directory>/scripts/workspace.py new-campaign \
--target <workspace> --name "<campaign name>" [--slug <campaign-slug>] \
--output <workspace>/.postplus/campaign-init.json
填写目标、市场、平台、优惠、CTA、KPI、限制条件和审批状态。只有在确认目标营销活动后,才在 project.yaml 中设置 current_campaign。
恢复并执行
- 查找当前工作目录及其上级目录中最近的
project.yaml。 - 读取最近适用的
AGENTS.md,然后读取project.yaml。 - 仅读取 context-schema.md 中列出的阶段上下文。
- 在执行高影响操作前运行工作区阶段检查。
- 完整阅读选定的专项技能。
- 仅当选定的技能未明确说明某个必需参数时,才阅读当前 CLI 帮助或架构。
- 根据已记录的状态继续,而不是重新创建之前的工作。
如果不存在工作区,则提供初始化选项。不要将项目文件散落到无关文件夹中。
阶段规则
请遵循 stage-gates.md 中关于入门、研究、策略、测试、生产、发布和学习的要求。随附的检查器仅验证工作区文件;当前报价、提供方验证、权限、账户和实时状态仍以 CLI 或服务端边界处的信息为准。
当信息缺失、冲突,或修复可能改变含义时,请阅读 uncertainty-policy.md。
检查工作区
<python-3-command> <skill-directory>/scripts/workspace.py check \
--target <workspace> \
--stage <onboarding|research|strategy|test|production|launch|learn> \
[--campaign <campaign-slug>] \
--output <workspace>/.postplus/stage-check.json
将 BLOCKED 视为受影响阶段的停止信号。本地的 READY 结果不能替代当前的 CLI 验证、额度检查或发布批准。
状态
实质性任务结束时,请提供:
STAGE: <stage>
STATUS: READY | BLOCKED | NEEDS_APPROVAL | COMPLETED
INPUTS READ: <sources>
BLOCKERS: <none or exact blockers>
OUTPUTS: <created or updated artifacts>
NEXT: <one next action>
工作区和活动模板位于 assets/project-template/。
上述命令使用无破坏性的 scripts/workspace.py 入口。