mcpField
S
specsfy-01-inbox

specsfy-01-inbox

github.com/promovaweb生产力87443 次安装1 周前更新
代码仓库

关于 specsfy-01-inbox

specsfy-01-inbox 是用于将想法记录到项目 Inbox 的 skill。它不提问或解决不确定事项，而是保留原始输入、标注声明与待审问题，并生成持久化捕获文件。

主要功能

  1. 01保留完整原始想法
  2. 02区分声明、推断与待审项
  3. 03提取有依据的需求信号
  4. 04检查明显敏感信息
  5. 05创建不覆盖旧记录的 Inbox 文件

适用场景

  1. 01快速记录尚未完善的产品想法
  2. 02为后续 backlog 梳理保留原始意图
  3. 03标记未来需要确认的需求或数据问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/promovaweb/specsfy --skill specsfy-01-inbox

安装后在 Claude Code 中输入/specsfy-01-inbox确认已加载。

附带文件agents/openai.yamlscripts/capturar_inbox.mjs

详细介绍

在 Inbox 中登记条目

必须完成的准备工作

执行此 skill 前，必须在项目根目录加载 $specsfy-setup。自动交接时，请在此步骤前重新加载。 重用对话中已确认的根目录；如果 setup 指出有待处理事项，请勿继续。

交互模式

交互模式：sem perguntas。 此 skill 中不要提问。记录缺失信息，留待后续处理，不要中断捕获。

立即将收到的文本记录到 specs/inbox/。将 Inbox 视为 backlog 之前的持久化输入：它保留意图并整理有用信号，但不会决定需求，也不授权实施。

不要中断捕获

  • 即使想法含糊、矛盾或不完整，也不要提问。
  • 写入前不要请求确认。
  • 不要因重复、缺少上下文或存在不确定性而阻止捕获。
  • 将缺漏记录在 Pontos a revisar no futuro 中；此阶段不要试图与用户一起解决。
  • 保存后，只告知文件路径、已处理内容的简要摘要，以及可选的下一步。不要自动开始下一步。

保留并预处理

  1. 静默检查是否明显包含凭据、令牌、私钥和敏感个人数据。如果发现此类内容，不要写入文件，也不要提问；告知用户隐私政策要求先移除敏感数据，再重新提交想法。
  2. 将所有表达想法的输入作为原文。完整保留其措辞，不要“纠正”或替换词语。
  3. 静默拟定一个简短、具体且忠实的标题，并据此生成 slug。
  4. 将分析分为以下类别：
    • **声明：**原文中明确包含的内容；
    • **推断：**合理的解释，始终标明为推断；
    • **待审核：**之后可能重新审视的缺漏、冲突或决定。
  5. 仅在有依据时提取：
    • 一句话摘要；
    • 问题或机会；
    • 受影响或受益的人群；
    • 预期结果或价值；
    • 提及的范围、规则、限制、渠道或解决方案信号；
    • 明显的风险、依赖关系和关联；
    • 可能的 backlog 或 spec 方向，但不要将其升级为正式决定。
    • 系统可能需要保存、查询、共享或删除的信息，作为后续讨论的信号。
  6. 如果没有依据，请使用 Não identificado no texto original.。不要编造相关方、优先级、期限、规则、解决方案或验收标准。

创建文件

执行一次：

node <diretório-da-skill>/scripts/capturar_inbox.mjs \
  --input "<texto original integral>" \
  --title "<título derivado>" \
  --summary "<resumo>" \
  --problem "<problema ou oportunidade>" \
  --people "<pessoas afetadas>" \
  --value "<resultado ou valor>" \
  --signals "<sinais extraídos>" \
  --data "<sinais sobre informações que talvez precisem ser guardadas>" \
  --risks "<riscos ou dependências>" \
  --directions "<direções futuras possíveis>" \
  --review "<pontos a revisar futuramente>" \
  [--root <raiz>]

如果存在 .specsfy/templates/custom/Inbox.md，脚本会使用该文件；否则会使用 .specsfy/templates/Inbox.md。脚本会创建 specs/inbox/AAAA-MM-DD-HHMMSS-<slug>.md，且绝不覆盖已有捕获内容。如果模板缺失，请报告安装不完整；不要在此 skill 中创建平行模板。

编排对话

此 skill 有意作为框架自动交接机制的例外： 捕获就是请求的最终结果，必须在不提问、不进行转换的情况下完成。写入后，仅建议以下下一步之一：

  • 将条目保留在 Inbox 中；
  • 使用 $specsfy-02-backlog 对其进行细化或深入分析。
  • 如果条目表明系统需要保存信息，则使用 $specsfy-data-discovery。后续讨论只将已确认的信息记录到 .specsfy/DATABASE.md 中。

除非同一请求也明确要求执行该工作，否则不要加载其他 skill。若有此要求，请在确保捕获安全后，告知用户： Transição automática: $specsfy-01-inbox → $<destino> — motivo: <motivo> — resultado esperado: <resultado>

限制

  • 保存前不要搜索重复项。
  • 不要修改或删除之前的捕获内容。
  • 不要将推断转化为用户声明。
  • 不要创建 specs/backlog/、任何 spec 状态文件夹、任务、研究、测试或代码。
  • 不要将该想法用作行为规范来源。

评论

支持 Markdown