Stop That Shit · Piik

项目取舍

Piik 是供朋友分享的小项目。优先简单、好用、漂亮和实际效果，积极采用有收益的成熟方案与新技术。 不要按假想的百万级规模设计，不要追求覆盖一切极端情况、无限兼容或零风险。 复杂度、验证时间和维护负担都是真实成本。用户已经授权的合理工作，应当推进到可用结果。

这是工作尺度与收口方法；Ponytail 负责实现取舍。 AGENTS.md 规定权限与设计质量， CONTRIBUTING.md 规定交付流程。 新方法、新机制必须完整验证实际行为。减负不降低体验、审美或验证质量。

直接执行

• 让研究产生实现。 参考相关的一手实现，选出简单、可逆的方案就做对照。 一旦信息足够做决定，停止搜集同类材料。上游也有问题不等于只能接受；检查现有配置、 接口和小范围补丁。研究或审查任务仍按其授权范围交付，不自动变成实现。
• 新机制要验完整。 沿实际调用链验证预期效果及受影响的主路径，覆盖相关的失败、恢复 和生命周期行为；不能用一个 happy path 或孤立单测宣称完成。复用现有检查和复现，缺口 补有效回归。小文案、布局和可逆低影响改动不默认新增单元测试；不为每个分支、私有函数 或实现细节各造一套测试。同一机制的不同检查应回答不同的实际问题。
• 已回答的问题不要反复验。 相关代码、依赖、环境或证据没有变化，就复用有效结果。 失败后检查具体原因；修正后重跑受影响部分。全套检查按交付阶段执行，不在每次小改后重跑。 不为“再放心一点”追加矩阵、审计代理、证明文件或验证流程；明确要求的专项验收照常完成。
• 减负要真正删掉。 在当前范围内移除已替代实现、重复防御、无消费者的产物和重复测试。 不留注释代码、停用分支、过渡接口或长篇历史说明。仅用于本次调查的探针留在 ignored 工作目录；值得长期保留的事实更新现有文档所有者，不再建一套审计账本。
• 交付有用结果。 已授权的必要工作继续做，不停在计划、风险清单或“可以继续”。 请求的体验与职责完整、相关检查通过且没有已知阻断就收口；不能以“能跑”代替验收。 真正受阻时说明具体缺口和已尝试的方法。 不把未知说成已解决，也不把所有未知都变成发布门槛。汇报结果和影响决定的限制即可， 不用测试数量、长免责声明、反复道歉或未来待办替代成果。

参考来源与取舍保留在上下文治理研究， 不作为每次任务必读材料。