用途:这是 Specsfy 框架中的第一步捕获技能,用于把用户发来的想法、思考、需求、机会或自由文本立即登记到 Inbox。Inbox 被视为 backlog 之前的持久入口,只保留意图和有用信号,不决定需求,也不授权实现。
主要能力:原样保留输入文本,不纠正措辞;静默派生简短标题与 slug;把分析分为“声明”(原文明确内容)、“推断”(标注为推断的合理解读)、“待复核”(缺口、冲突或后续可再议的决定);仅在存在证据时提取一句话摘要、问题或机会、受影响人群、预期价值、范围/规则/限制/渠道/方案信号、风险与依赖、可能的 backlog 或 spec 方向,以及系统未来可能需要保存、查询、共享或删除的信息。无依据时写“Não identificado no texto original.”,不编造干系人、优先级、期限、规则、方案或验收标准。
使用方式:执行前必须在项目根目录加载 $specsfy-setup,自动交接时需再次加载;若 setup 指出待办事项则不得继续。交互模式为“不提问”:即使想法模糊、矛盾或不完整也不提问、不确认、不因重复或缺少上下文而阻塞,缺口记入“待复核”。保存后只报告路径、简要摘要和可选的下一步,不自动进入下一步。
创建文件:执行一次 node <技能目录>/scripts/capturar_inbox.mjs,传入 --input、--title、--summary、--problem、--people、--value、--signals、--data、--risks、--directions、--review,可选 --root。脚本优先使用 .specsfy/templates/custom/Inbox.md,否则回退到 .specsfy/templates/Inbox.md,生成 specs/inbox/AAAA-MM-DD-HHMMSS-<slug>.md,且从不覆盖已有捕获。模板缺失时应报告安装不完整,不得在技能内另建模板。
隐私与限制:写入前静默检查凭据、令牌、私钥和明显敏感个人数据;若发现则不写文件也不提问,告知隐私政策要求移除敏感数据后重新发送。不预先查重、不修改或删除旧捕获、不把推断当作声明、不创建 specs/backlog/ 或任何 spec 状态、任务、研究、测试、代码目录,也不把该想法当作行为的规范来源。后续可建议保留在 Inbox、用 $specsfy-02-backlog 细化,或在涉及需保存信息时用 $specsfy-data-discovery(仅在 .specsfy/DATABASE.md 记录已确认内容)。只有同一请求明确要求时才加载其他技能,并在捕获安全后宣布自动过渡。