---
tags: web3
---

# Shoutout Documentation

> ## 閱讀對象 - Noah
> - 此文件的溝通對象
> - g0v 大松參加者
> - g0v 坑主
> - g0v 對社群成就紀錄有興趣的開發者
> - Shoutout 的使用對象
> - 短期：da0 內實驗性推廣
> - 中期：g0v 推廣，以大松及坑主個人溝通為場域
> - 長期：使用 Slack 的公開社群，以 Code for Japan 及 Code for Korea 為優先

>==待討論==
>對象應分兩部分
>
>1. 外部社群：以推廣「精神」為主，即希望為其他社群示範：da0為自己設計並製造出 ShoutOut 工具，鼓勵成員彼此共同撰寫社群歷程(史詩)，藉由數位激勵機制促成社群內的良性互動。
>
>SO工具將開源，鼓勵其他社群打造出自己的工具，並且建立資料庫。
>如果要串聯，可以來聊怎麼打造「通道」
>
>
>2. 與da0密切相關的社群，包含有合作或人員大量重疊：由於是有合作事實的社群，開放邀請使用da0版的SO，資料庫共享共治。
>
>也因此，「部署Shoutout」也有兩個版本：
>1. 開源版
>2. 內部教學版
>
:::spoiler 展開/隱藏目錄
:::success
## [Introduction 關於ShoutOut](/wRf3GRwsRdO0-8Vu6OEKaA?view)
1. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut1" target="_parent">Background / Context 脈絡回顧</a>
2. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Glossary-%E8%A9%9E%E5%BD%99---Lucky-amp-Frank-%E2%87%AA" target="_parent">Glossary 詞彙</a>
3. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#The-importance-of-an-digital-incentive-mechanism-%E6%95%B8%E4%BD%8D%E6%BF%80%E5%8B%B5%E6%A9%9F%E5%88%B6%E7%9A%84%E9%87%8D%E8%A6%81%E6%80%A7---Lucky-%E2%87%AA" target="_parent">The importance of an digital incentive mechanism 數位激勵機制的重要性</a>
3.1 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Digital-Incentive-mechanism-and-gamification-%E6%95%B8%E4%BD%8D%E6%BF%80%E5%8B%B5%E6%A9%9F%E5%88%B6%E8%88%87%E9%81%8A%E6%88%B2%E5%8C%96---Lucky-%E2%87%AA" target="_parent">Digital Incentive mechanism and gamification 數位激勵機制與遊戲化</a>
3.2 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#How-ShoutOut-incentivizes-P2P-contribution-ShoutOut%EF%BC%9AP2P%E6%A9%9F%E5%88%B6%E5%A6%82%E4%BD%95%E6%BF%80%E5%8B%B5%E8%B2%A2%E7%8D%BB---Lucky-%E2%87%AA" target="_parent">How ShoutOut incentivizes P2P contribution ShoutOut：P2P機制如何激勵貢獻</a>
3.3 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Comparing-to-other-incentive-mechanism-%E8%88%87%E5%85%B6%E4%BB%96%E6%BF%80%E5%8B%B5%E6%A9%9F%E5%88%B6%E7%9A%84%E6%AF%94%E8%BC%83---Noah-%E2%87%AA" target="_parent">Comparing to other incentive mechanism 與其他激勵機制的比較</a>
4. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#How-we-imagine-ShoutOut-going-forward-%E6%88%91%E5%80%91%E5%B0%8DShoutOut%E7%9A%84%E6%83%B3%E5%83%8F---Noah-%E2%87%AA" target="_parent">How we imagine ShoutOut going forward 我們對ShoutOut的想像</a>
5. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#ShoutOut-as-a-keystone-building-block-ShoutOut%E4%BD%9C%E7%82%BA%E7%A4%BE%E7%BE%A4%E7%99%BC%E5%B1%95%E7%9A%84%E5%9F%BA%E7%9F%B3---PW-%E2%87%AA" target="_parent">ShoutOut as a keystone building block ShoutOut作為社群發展的基石</a>
5.1 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#The-basics-of-web3-technology--philosophy-%E9%97%9C%E6%96%BCWeb3%E7%A7%91%E6%8A%80%E8%88%87%E5%93%B2%E5%AD%B8---PW-%E2%87%AA" target="_parent">The basics of web3 technology / philosophy 關於Web3科技與哲學</a>
5.2 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#The-normative-goal-of-ShoutOut-ShoutOut%E5%BF%85%E9%A0%88%E6%BB%BF%E8%B6%B3%E7%9A%84%E7%B8%BD%E9%AB%94%E7%9B%AE%E6%A8%99---PW-%E2%87%AA" target="_parent">The normative goal of ShoutOut ShoutOut必須滿足的總體目標</a>
5.3 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#What-is-ShoutOut-Bot-ShoutOut%E6%A9%9F%E5%99%A8%E4%BA%BA%E7%B0%A1%E8%BF%B0---PW-%E2%87%AA" target="_parent">What is ShoutOut Bot ShoutOut機器人簡述</a>
5.4 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#What-is-ShoutOut-Page-%E9%97%9C%E6%96%BCShoutOut%E6%88%90%E5%B0%B1%E8%83%8C%E5%8C%85---PW" target="_parent">What is ShoutOut Page 關於ShoutOut成就背包</a>
5.5 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Why-would-you-%E7%82%BA%E4%BB%80%E9%BA%BC%E8%A6%81%E7%94%A8ShoutOut-NoahampP-%E2%87%AA" target="_parent">Why would you? 為什麼要用ShoutOut</a>
5.6 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Use-cases-of-Shoutouts-%E4%BB%80%E9%BA%BC%E7%8B%80%E6%B3%81%E9%81%A9%E5%90%88%E4%BD%BF%E7%94%A8-ShoutOut---Pamp%E6%98%B6%E6%83%9F-%E2%87%AA" target="_parent">Use cases of Shoutouts 什麼狀況適合使用ShoutOut</a>
6. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Deploy-ShoutOut-for-your-team-%E7%82%BA%E5%9C%98%E9%9A%8A%E9%83%A8%E7%BD%B2ShoutOut-%E2%87%AA" target="_parent">Deploy ShoutOut for your team 為團隊部署ShoutOut</a>
6.1 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Getting-started-with-ShoutOut-%E5%A6%82%E4%BD%95%E9%83%A8%E7%BD%B2ShoutOut---%E6%98%B6%E6%83%9F-%E2%87%AA" target="_parent">Getting started with ShoutOut 如何部署ShoutOut</a>
6.2 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Getting-started-with-ShoutOut-frontend-%E5%89%8D%E7%AB%AF%EF%BC%9A%E9%83%A8%E7%BD%B2ShoutOut---Tim-Matt-%E2%87%AA613%E5%9B%9E%E4%BE%86%E7%9C%8B" target="_parent">Getting started with ShoutOut frontend 前端：部署ShoutOut</a> ==Tim, Matt(6/13回來看)==
7. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Limits-Challenges-amp-Threats-%E9%99%90%E5%88%B6%E3%80%81%E6%8C%91%E6%88%B0%E3%80%81%E5%A8%81%E8%84%85--%E6%98%B6%E6%83%9F%E3%80%81PW-%E2%87%AA" target="_parent">Limits, Challenges & Threats 限制、挑戰、威脅</a>
7.1 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Sybil-attack-or-intentionally-accumulate-Shoutouts-%E6%83%A1%E6%84%8F%E8%A8%8A%E6%81%AF%E8%88%87%E9%9B%9C%E8%A8%8A%E7%AF%A9%E9%81%B8---PW-%E5%AF%AB%E5%88%B0%E7%9B%AE%E5%89%8D%E7%82%BA%E6%AD%A2-%E2%87%AA" target="_parent">Sybil attack or intentionally accumulate Shoutouts 惡意訊息與雜訊篩選</a>
7.2 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Fake-accounts-or-false-messages-%E8%99%9B%E5%81%87%E5%B8%B3%E8%99%9F%E6%88%96%E6%98%AF%E8%99%9B%E5%81%87%E8%A8%8A%E6%81%AF---%E6%98%B6%E6%83%9FampPW-%E2%87%AA" target="_parent">Fake accounts or false messages 虛假帳號或是虛假訊息</a>
8. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Potential-features-of-ShoutOut-ShoutOut%E7%9A%84%E6%BD%9B%E5%9C%A8%E5%A0%86%E7%96%8A" target="_parent">Potential features of ShoutOut ShoutOut的潛在堆疊</a>
8.1 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Memify-%E5%89%B5%E9%80%A0%E8%BF%B7%E5%9B%A0---PW-%E2%87%AA">Memify 創造迷因</a>
8.2 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Visualize---Terry-%E2%87%AA" target="_parent">Visualize 視覺化</a>
8.3 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Quantification-%E9%87%8F%E5%8C%96%E8%B2%A2%E7%8D%BB---Noah-%E2%87%AA" target="_parent">Quantification 量化貢獻</a>
8.4 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Analysis-%E6%AF%94%E8%BC%83%E5%88%86%E6%9E%90---Noah-%E2%87%AA" target="_parent">Analysis 比較分析</a>
8.5 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Reward-%E7%B5%A6%E4%BA%88%E7%8D%8E%E5%8B%B5---Noah-%E2%87%AA" target="_parent">Reward 給予獎勵</a>
8.6 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Other-frontiers-%E5%85%B6%E4%BB%96---Noah-%E2%87%AA
" target="_parent">Other frontiers 其他</a>
9. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Closing-thoughts-%E7%B5%90%E8%AA%9E-%E2%87%AA" target="_parent">Closing thoughts #結語</a>
10. <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#QampA---to-be-%E2%80%A6-%E2%87%AA" target="_parent">Q&A - to be ...</a>

:::

# Introduction 關於ShoutOut
Shoutout 是一個 **Slack bot**，要『Shoutout』給某個社群的貢獻者，只需要在有裝置 Slack bot 的 Slack 頻道中標籤 @Shoutout 與該貢獻者的名稱，該句『Shoutout』的所有文字內容就會被記錄在一個中心化的伺服器中（期望短期可以轉移到鏈上），未來若是被記錄在區塊鏈上，便會以靈魂綁定代幣（Soulbound token）的方式公開存在，以供各方取用。

## Background / Context 脈絡回顧 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
Shoutout 的起源與 da0 的成立緊密相連。da0 成立時所做的 g0v 社群痛點研究結果是公共財專案的推動者們雖然自身動機強烈，但卻很難將這些動機長期且持續的複製在其他參與者身上，加上缺乏薪水與股票等傳統激勵工具，專案很常面臨一人扛巨石且寸步難移的困境。因此 da0 的創立動機便是以 Web3 科技 Supercharge g0v & Civic innovation。

# Glossary 詞彙 - Lucky & Frank <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
> - 經濟資本（economic capital）:
> 一般泛指可用來交換物品和服務的東西，如貨幣、資金和財富。
>
> - 社會資本（social capital）:
> 人們在社會中建立的互信、合作和支持的關係網絡，可以帶來機會、資源和支援。
> - 文化資本（cultural capital）:
> 個人在社會中所擁有的知識、價值觀和社會習慣，通常在與人互動和成就方面產生影響力或有助於獲取社會的信任與資源。
> - 激勵（incentivize）:
> 通過獎勵、鼓勵或利益來激發人們的動力，促使人們做出更好的表現或自發性地行動。
> - 貢獻（contribution）:
> 一般指個人或團體通過自己的努力、才能或資源，推動（共同）目標的實現。
>
> - 社群（community）:
> 一群有相同興趣、目標或背景的人聚集在一起，互相交流、合作和支持，形成一個彼此關聯的社會團體。
> - 機制（mechanism）:
> 一套規則、程序或方法，通常是通過步驟或過程來運作，用以調節和促進特定目標的實現。
>
> - 公共財 (Public goods):
> 對社會整體有益且無法排除非付費人士使用的資源或服務，例如公共衛生、公共交通等。
> - 互酬行為 (Reciprocal behavior):
> 人們基於相互的利益交換而進行的行為。
> - 集體文化 (Collective culture):
> 一個社群或團體共同擁有的價值觀、信念和行為模式。
> - 數位公民 (Digital citizen):
> 具備適應和使用數位科技的能力，並且在數位社會中積極參與和貢獻的個人。
> - 靈魂綁定代幣（Soul-Bounded Token）:
> 一種不可轉讓且公開可見的代幣，補足區塊鏈上只有互通代幣的不足。
> - 數位激勵機制 (Digital incentive mechanism):
> 數位環境中的一種機制或方法，通過獎勵、激勵和鼓勵的方式來激發人們的行為。

# The importance of an digital incentive mechanism 數位激勵機制的重要性 - Lucky <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
有鑒於公共財專案及公共財的生產普遍源於國家機構或財團資源，因公共財欠缺與社會大眾的真實意義連結，導致公共資源陷入「每個人都想要、卻沒人願意為其付出成本」、「多方利害關係群體們，耗費公共資源並彼此競爭」的資本政治窘境。

數位激勵機制作為一種反思公共財困境，以人為本、基於功利主義或社會（策群）契約的建制方式，能重建更有韌性的集體文化以及數位文化基礎建設，甚至對數位公民的啟蒙、和集體的覺醒產生關鍵影響。

積極而言，數位激勵系統能重啟（reactivate）社群成員的自主性與成就感，正向地鼓勵社群內外的互酬行為與貢獻，促使韌性文化與公共財的再生；消極來說，它可以透過合理要求互酬行為和分散式的驗證，降低少數人過度搭便車的問題（free rider problem）。

## Digital Incentive mechanism and gamification 數位激勵機制與遊戲化 - Lucky <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
激勵機制和遊戲化都是通過獎勵、激勵和鼓勵的方式來激發人們的行為。它們的關係在於，遊戲化可以被視為應用激勵機制的一種方式，通過將激勵機制融入遊戲中，來激發人們的積極參與和行為改變。

以 ShoutOut 為例：ShoutOut Bot 的短期目標，在於透過數位激勵機制來鼓勵社群成員們分散、自發且自主地紀錄「與貢獻及互動有關的社群文化資料」的行為，並透過機制的雙向性，建立 ShoutOuter、ShoutOutee 之間的正向互酬關係；由於紀錄往往被視為一件欠缺動機、額外的行政工作，ShoutOut Bot除將自動化擷取 ShouOut 的內容、ShoutOuter 及 ShoutOutee 的ID、以及 ShouOut 的時間戳記並整合成一串有關聯意義的字串外，另外結合了各式主題迷因的隨機生成，作為一種紀錄完成後的視覺surprise與獎勵。

ShoutOut Page則將把被ShoutOut Bot紀錄的文化資料進一步彙整、比較分析、視覺化呈現成為對社群內外不同行動者有意義或有價值的資訊，為抽象的公共財貢獻注入良性競爭，賦予社群ShoutOuter與ShoutOutee獨特的角色、任務與故事。

## How ShoutOut incentivizes P2P contribution ShoutOut：P2P機制如何激勵貢獻 - Lucky <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>

與其說 ShoutOut 是一組完整的激勵機制，不如說 ShoutOut 旨在扮演激勵機制的其中一塊基石角色。完整的激勵機制中可能有幾個層次的工具，第一是記錄貢獻，第二是量化貢獻，第三是獎勵貢獻，如果這三者皆以公共財專案參與者可接受也有吸引力的方式存在，那貢獻就能更有效地被激勵。貢獻系統中也可以有其他角色，例如分析貢獻、視覺話貢獻等。ShoutOut在這整個系統中扮演的是讓貢獻『浮現』並被記錄的角色，我們應該讓這樣的貢獻記錄被多種方式量化、分析及獎勵，直到找到對社群來說最容易接受的方式。

ShoutOut 本身還是有可能具備一些正向的心理激勵作用，但若是單獨存在，激勵作用可能不明顯，指向性也不夠明確，與其他基石堆疊效用可能更有效。

## Comparing to other incentive mechanism 與其他激勵機制的比較 - Noah <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
傳統的計分方式類似於薪水分發，無法納入同組貢獻者對彼此的評價。ShoutOut 的機制重視P2P同儕之間的互動，具有分散式和多元涵容的特性。每個人都是評鑑者，也都是被評鑑者。承認的「貢獻」也不僅限於一種。

當然，沒有任何的貢獻記錄或激勵機制是完美的，ShoutOut 比傳統計分系統更需要成員的密切互動，而且紀錄 ShoutOut 的內容會明顯受到成員著重重點的影響，需要更常將成員的著眼點跟整體目標對齊。

因此 ShoutOut 比起集中式的計分系統，更能夠提早讓成員練習工作自主跟共同管理的工具。對於可能長期延續的計劃或是長期合作的團隊，可能更有利於團隊目標整合。

# How we imagine ShoutOut going forward 我們對ShoutOut的想像 - Noah <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
我們想像 ShoutOut 成為其他激勵層所能運用的資料，ShoutOut 的存在目的是讓社群的貢獻被大量且持續的『浮現』，也成為社群正面氣氛的創造工具。

我們期待更多的開源量化、視覺、獎勵、分析工具被建立在 ShoutOut 上，這可能是透過 g0v 的 Hackathons 也可能透過其他場域。

Shoutout 對於量化、視覺、獎勵、分析工具應該是中立的，其目的只存在於創造大量的貢獻資料。

我們期望 ShoutOut 能存在於 g0v 及 Slack 以外的社群介面，例如 Code for Japan 與 Discord 等，以讓這項工具被開發與利用的可能性更高，以增加其成功的機率。

我們期望 ShoutOut 所產生的資料成為鏈上資料，讓任何工具可以取用。

# ShoutOut as a keystone building block ShoutOut作為社群發展的基石 - PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
## The basics of web3 technology / philosophy 關於Web3科技與哲學 - PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
Web3的目標，是盡量兼顧多元與可互通。

每個群體的工作目標、互動方式、組成成員都不同，沒有任何一種量表或描述方法，可以適用於所有群體。
而且g0v的組成更為自發，成員技能與貢獻更為多樣。同質性的標準，很難成為跨坑的激勵機制，甚至可能阻礙某些貢獻的出現或妨害某些團體動力學。

但另一方面，根據每種技能或貢獻各自製作激勵或統計系統，將使激勵機制過於瑣碎，失去理解性與互通性。

因此，一個能夠在Web3環境下作用的激勵機制，可能是一種 **液態格式**（liquid format），必須隨著使用者在不同專案與不同群體中流動。
由於這種液態格式不能在專案之前制定，卻又必須盡可能在各專案之間互通，它勢必只能由人類心理機制衍伸得出。

我們認為 **敘事（narrative）** 符合這種需求。敘事早於所有統計（statistics）與光環（signals），是人類講述與理解的原始形式。本質上就會隨著使用者與群體而變形。互動時最直觀，涵容頻寬最大。

## The normative goal of ShoutOut ShoutOut必須滿足的總體目標 - PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
本計畫的目標，是建立一個激勵機制系統，能夠盡量多元滿足da0甚至其他團體參與者的各式心理需求，且可能在整理之後向外界呈現
有效的激勵機制必須滿足**自我實現功能**，以及**社會互動功能**。因此
* 必須能夠辨識出夥伴的貢獻方向，投入方式，技能氣質。
* 必須能夠呈現同儕的看法，以及其他人的關注與興趣

同時，這個激勵機制也需要允許專案負責人或計畫製作人**給予成員誘因和評價**，因此
* 負責人使用時必須盡量直觀
* 參與夥伴必須盡量經常接觸

最後，這個激勵機制必須**盡量易於使用**。
* 最好是能夠被動產生（討論過後已放棄此方向）
* 如果必須主動使用，就得將門檻壓低至按下一兩個按鈕、呼叫一個指令

此外，敘事這種格式本身就具備一種重要功能

* 將活動內容與當下心情記錄在公共場域，就是一種對當下共同行動的認可，是為未來的自己與他人預先創造的回憶。這種**超越性**（transcendency）本身就使行動增加意義，能夠凝聚社群。
* 彼此紀錄的過程也能成為一種**儀式**（ritual），加強繼續協力與合作的動力。

## What is ShoutOut Bot ShoutOut機器人簡述 - PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>

基於The normative goal of ShoutOut，本計畫現階段的設計，是提供一個Slack機器人，讓使用者可以盡量簡單地紀錄對彼此的感謝。這個機器人稱為ShoutOut Bot（SOB）。

g0v成員已經有使用slack的習慣，也有彼此感謝的文化。我們認為彼此感謝就是激勵機制的文化基礎，將其紀錄整理出來，讓使用者能以更直觀的頁面或介面看到彼此的感謝內容，就能基本滿足以下需求：
* 呈現每個人的貢獻方向，投入方式，技能氣質
* 以P2P的方式，呈現對彼此的評價

目前的使用者只要在感謝或評論彼此貢獻時，**以下述語法呼叫bot**，SOB就會在Slack頁面復述使用者的SO發文，同時整筆資料就會記錄到SO的後台資料庫。

**使用者唯一需要額外做的工作就是呼叫BOT** ，其他均與平常slack互動相同。

基本語法為
`@shoutout @someone for something`

例如
>@shoutout @tofus 簡直UI達人！聊到一半就想到「感謝卡」的雛形！

**SOB在Slack發文內容為：復述原SO內容，加上GIF隨機配圖，並且附上兩個按鈕**
1. 「**這句話來自這裡Original message**」：將連回原發文。如果發送者是在對話串中SO，此功能是方便的傳送門。

2. 「**查看成就背包See the shoutouts**」：連結到完整條列SO內容的前端專屬頁面。網頁將會分為公共頁面和個人頁面兩部分。

## What is ShoutOut Page 關於ShoutOut成就背包 - PW
所有感謝/讚美句都會匯集在【公共頁面】，類似類比時代的村莊或宮廟功德碑，地方誌，或者同業之間口耳相傳的史詩。

每個人都有一個【個人頁面】，上面紀載：
* 自己發出了哪些ShoutOut
* 從誰那裏因為何事而獲得ShoutOut。

未來個人史詩累積起來，可以變成某種履歷表的概念，透過視覺化的統整，浮現社群成員主要在哪些專案有貢獻、與其他貢獻者的關係等資訊，成為可以供外界參考的經歷。

## Why would you? #為什麼要用ShoutOut Noah&P <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- 記錄團隊貢獻
- 促進正向團隊文化
- 作為潛在獎勵依據
- 促進團隊溝通，浮現彼此進度
- 紀錄專案歷程

SO對不同群體的意義：
- 坑內：shoutout可以幫忙形塑互動氛圍、紀錄專案的特別時刻、里程碑、感謝
- 坑間：不同專案可相互觀摩互動，初步認識不同專案的歷程跟潛在人才
- 新參者：可以點擊清單，看過往的highlight
- *g0v：儀式性：短期內可協助支援各種大會、松、聚會的唱名感謝，紀錄誰來參與。*
## Use cases of Shoutouts 什麼狀況適合使用 #ShoutOut - P&昶惟 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
:::warning
目前觀察現有社群使用ShoutOut的用法，可以分成三種：
**A. 讚美與感謝**
**B. 紀錄史詩**
**C. "就是想ShoutOut!!!"（互動功能）**

A.B.通常使用完整句型，盡量寫出關鍵詞，讓其他人知道被ShoutOut者的貢獻/做了什麼，這是滿足紀錄跟感謝的功能。
C.則主要表達「**當下想ShoutOut的心情**」，或是**任何可增加互動的使用方式**，都是潛在的使用場景，甚至不一定會有完整句子，可能也並非感謝貢獻的內容。這時候使用SO的功能是著重成員當下的互動趣味。
:::

以下分別舉例 scenarios（使用情境）
- A1 讚美：目前最常見的用法
- 

- A2 感謝：ShoutOut最原先要用來凸顯的功能，將社群內的人的貢獻大聲說出來
- 

- B1 紀錄：利用系統記錄重要時刻、任務milestone，詳細的紀錄貢獻和參與
- 

- B2 儀式：ShoutOut變成某種習慣，在做什麼特定的事情之前，或是之後，會進行的行為。目前例如坑主可用於大活動結束後的紀念性發文
- 
- C1 炒熱氣氛：SOB的出現帶有的意外性質可以作為炒熱氣氛的工具，並且對喜歡迷因的人來說也具有吸引力
- 
- 

- C2 其他：任何想要放大說話聲音的意圖，都可以利用ShoutOut來增幅
- 

# Deploy ShoutOut for your team 為團隊部署ShoutOut <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
## Getting started with ShoutOut #如何部署ShoutOut - 昶惟 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
https://github.com/girofu/Epic-slack-app
see the readme in this github repo

點選slack頻道名稱，跳出功能表 > 整合 > 新增應用程式 > 選擇Shoutout Bot

## Getting started with ShoutOut frontend #前端：部署ShoutOut - Tim, Matt <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>(6/13回來看)
==API與UI確認後可開始撰述==

### da0-SO版：查看公共頁面及個人頁面
1. 點選Slack上的ShoutOut-Bot的按鈕「**查看成就背包**」，即可進入【公共頁面】

2. 點選"login via slack"或"see your shoutouts"，即可查看【個人頁面】，若尚未連結帳號，請參考3. 個人頁面登入步驟。

3. 個人頁面登入步驟如下
:::

### 開源版 Coming soon

:::

# Limits, Challenges & Threats 限制、挑戰、威脅- 昶惟、PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
## Sybil attack or intentionally accumulate Shoutouts 惡意訊息與雜訊篩選 - PW 寫到目前為止 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>

Web3的核心原則是分散與涵容。我們認為規範（norm）應該存在於社群，而非內建於工具。

ShoutOut就如所有發文平台一樣，會被出現惡意訊息與劣質發言所傷害，我們目前認為的處理方式是
* 使用slack內建的功能，移除惡意發送者
* 控制ShoutOut Bot，不顯示特定ID的發文，或不顯示傷害性發文（僅存於後台資料庫中）

因為ShoutOut的初衷是從團體互動中促進彼此認可，而不同群體對於發文的「品質」看法各異；對於「濫用」ShoutOut的標準也有所不同。故目前ShoutOut的內容與格式暫時不設立任何規定，使這種激勵工具盡可能適用於各種群體。

--

另外，鑒於ShoutOut的個人頁面，可以做為自己的紀錄回顧，甚至是認識彼此的文件，成員可能不希望所有ShoutOut都顯示在個人頁面中。

本專案未來將期待增加的，是「收到ShoutOut者能夠選擇是否顯示」以及「過濾掉不當ShoutOut」的功能。兩者都可以用**增加tag**的方式撰寫。

--
最後，未來可能出現惡搞或不小心寫錯的ShoutOut發文資訊。我們目前認為的回應方法是

* 給予發言者刪除與修正功能，並以時間戳記顯示該發文已刪除。

因為對送出者來說，我講什麼話，顯示我是什麼樣的人。
對接受者來說，希望自己的個人頁面列出哪些ShoutOut，則是自己希望呈現什麼公眾形象。

**講錯話可以道歉，並作更正或刪除，故送出者可以選擇刪除，但不能選擇不顯示，因為說話要負責；接收的人選擇是否顯示，但不能選擇刪除，因為那是別人的言論。**

:::spoiler
我們認為防止惡意訊息或蓄意劫持的機制，存在於使用者互動層，而非激勵機制工具層。

基於各專案在目標、組成成員、合作方式上的多元性，似乎無法製作一個關鍵字串或相關性的白名單，去適用每個專案。而要求各專案自己制定白名單，又會額外製造出更多討論勞動。
以黑名單，甚至以個案方式處理惡意訊息，更能維持由下而上的治理機制，與各專案不同的需求。SOB的自動謄錄功能，使得呼叫SOB本身就是一種公共展現行為。惡意行為者會將自己的卑劣展現在所有人面前。

因此，我們認為SO目前只需要處理：
* 收到Shoutout者是否認可
* 群體能否根據自己的規範，簡單判斷出發送者是否惡意、發送的個別Shoutout是否不當
* 群體能不能簡單排除惡意發送者、能否簡單過濾掉不當Shoutout

根據SO介面格式，「判斷惡意與不當」能力已經在個人頁面自動滿足，不須額外撰寫功能。
「排除惡意發送者」功能，已內建在slack中。群體僅需移除成員即可。

因此，本專案未來將期待增加的，是「收到ShoutOut者是否認可」以及「過濾掉不當ShoutOut」的功能。兩者都可以用**增加tag**的方式撰寫。

ShoutOut機制真正要處理的，是此機制**先天會謄錄的過多雜訊**。一個要上鏈，或是如果要當成身分/貢獻的資訊，應該是前來了解參與者的人想知道的資訊，以及使用者彼此紀錄的重要時刻，而非所有的互動。

這個需求可能可以用**收到ShoutOut者是否認可**來同時解決。

昶惟：可能要加上讓接收ShoutOut的人決定是否接受的功能，以濾掉雜訊和不符合事實的訊息。使用者即使不接受某些ShoutOut，也不會有所謂的「負評被隱藏的問題」，因為**這個工具不是全面的評價系統，不是要拿來給負評或是給意見用的**。

珮杏：注意到「選擇是否接受」和「選擇是否顯示」有所差異。很可能最後「選擇是否接受」*會做成*「選擇是否顯示」的型態，因為目前SO的內容很少不符合事實，多數是被分入雜訊。

比如「哇@shoutout @昶惟，太棒了！！」，這種對當事人來說是正面的回饋，但對第三者來說是一條不知所云的資訊，所以可能會是雜訊。這種情況好像不是「選擇是否接受」，因為沒有不好接受的，而是「選擇是否顯示」成人肉資訊？

**這樣初步構想，可能就會出現三個功能，依優先順序排列**：
1. 不對稱要討論，因為這牽涉到言論自由跟民主社會發言要負責任的議題，優先度高
2. 刪除功能要做，但優先度低
3. sob有無辦法跟著修正或刪除，優先度極低
:::
--

## Fake accounts or false messages 虛假帳號或是虛假訊息 - 昶惟&PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
幾種可能的惡意使用情境：
1. 虛假的Shoutout發送或不發送
1. 某些使用者可能會互相串通給予彼此SO，以此刷高彼此的好評數量
2. 承上，使用者也可能彼此串通而排擠某人，故意不給某人SO
3. 使用假帳號來發送SO以累積數量
4. 以上情況在具有內鬥的場景有可能發生，如果SO激勵系統與實際利益回饋機制串連，並且為一個實際利益的存量市場的話，則也可能會發生這樣的競爭

--> 互洗分為兩種
第一種: 正常的坑內，某幾個成員彼此互捧。
第二種: 刻意新立頻道濫用ShoutOut機制，營造個人頁面形象
在正常坑內彼此互捧，僅需當成雜訊或黑名單，加tag隱藏即可。需要防範的是，刻意營造個人頁面的手法。好幾個使用者可能彼此串通，新立一個頻道，在頻道當中彼此互相ShoutOut彼此根本沒做的內容，藉此顯示在個人頁面上。由於每一則ShoutOut都顯示哪個頻道，所以一旦發現該頻道濫用ShoutOut，其他頻道可以發起投票或審議，直接隱藏來自該頻道的所有ShoutOut，甚至停止ShoutOut Bot顯示該成員的所有ShoutOut（這相當於法治國家褫奪公民權）。

# Potential features of ShoutOut ShoutOut的潛在堆疊
## Memify #創造迷因 - PW <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- 為了讓g0v原有的感謝文化使用者能夠順利習慣這種謄錄方式，我們也引進了遊戲化機制。Shoutout發出時會附加隨機gif，使感謝文字與圖片之間的有機互文產生額外趣味，並且在呈現上更吸睛。
- 每隔一段時間，可以按需求（比如搭配節日）去設定gif主題
- 每一個社群也可以訂立自己的主題

## Visualize - Terry <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- ex. 儀表板：固定區間的 Shoutout 數量成長或比較（發送或收到）
- 

- ex. 文字雲 (待開發)
## Quantification 量化貢獻 - Noah <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- 雖然有些公共社群可能對於量化有些許抗拒，我們也同意在量化的過程中許多資訊會被遺漏，但量化也有其好處，包括成就認可可以服務貢獻者的心理，讓貢獻更加持久。陌生的貢獻者間可以更快速的判斷對方的背景及可信任度，減少合作間的摩擦與資訊落差。若是有像超證類型的獎勵機制，也可以讓獎勵方式有相對公平的依歸，而不只取決於當下資源分配者的喜好。
- 可能一：坑主量化介面
- 如果你還記得激勵機制的出發點，是為了讓坑主/專案主理人在 g0v 或是其他公共財專案中有激勵他人的工具，但目前 ShoutOut 還無法做到這點，如果成功只能做到『浮現』貢獻。但坑主可以基於這些被浮現的貢獻在某個時間點更方便的為這些貢獻打分，以激勵他希望能多看到的行為，而不用隨時隨地追蹤每個貢獻者的狀況。假設我們希望在 da0 社群裡看到更多元的專案類型，那協作層可能就會給予開啟新專案的坑主更高的打分，下一輪的工作可能就會有更多的人朝這個方向進行貢獻。
- 可能二：關係量化工具
- 能被量化的不只是貢獻者的貢獻，若是 ShoutOut 數量升高開始更具代表性，那我們就可以約略抓出每個人的關係分數。如果 Alice 長期給了 Bob 許多的 ShoutOut，那我們可能可以假設 Alice 與 Bob 有相對緊密的工作關係，且 Alice 對於 Bob 的工作貢獻是有正向平價的，這樣的貢獻社交圖譜可能可以讓我們更快找到可信任的『隊友』，或是也可以分析出社群多個小團體的破碎程度，進而決定我們希望社群往什麼方向前進，也給予對策。
- 可能三：職能量化工具
- 在一個社群裡我們沒有『設計師』『QA』這樣的頭銜，因此要尋找某些特定『功能』的夥伴時時常碰到不知道去哪裡找的問題，這也讓大部分的工作集中在相對少數的人們手上，這樣的情況無助於社群擴大，同時也可能讓少數人工作量超標，進而 Burnout。在 ShoutOut 的文本資料中，當資料量增加我們就更有可能用『已被同儕認可』的貢獻職能去分析該貢獻者可能是什麼角色，這樣未來在尋找夥伴時也能更有效率。
## Analysis 比較分析 - Noah <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- 可能一：社群氛圍分析
- 既然有這麼多的貢獻資料，那我們大概可以簡單解析出社群近期的氣氛，對於需要維持社群氣氛及動能的協作者們來說，可能是個很好的參考資訊。
- 可能二：社群成就及活躍分析
- 若是上方的職能量化工具能起到作用，那我們大概能總地來看社群近期完成的成就都是哪些類型的，社群近期的貢獻者又哪些人，與過去比較有什麼變化等。
## Reward 給予獎勵 - Noah <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- 可能一：Hypercerts 超證
- 超證是 da0 社群目前正在做的前端公共財獎勵實驗，在分發超證時自然必須要有特定依歸，這時若是有量化分數，便能對應到分發的超證『Fractions』（某種百分比計算方式），也能像影響力市場證明自己的貢獻。
- 可能二：資源分配
- 若是有各坑都需要的稀缺資源（不見得是資金），譬如說新聞報導的版面、參與國際會議的公關票券、與關鍵人物面談的時間等，資源分配就需要某種依歸，在這個情況下量化後的數字就會相對重要，因為質化的貢獻資料無法直接計算貢獻。
- 可能三：資金分配
- 如上，資金當然也可以當作是一種資源。
- 可能四：名譽分配
- 日本 Henkaku 變革社群會發放 NFT 證書給在該社群做過 100 小時研究貢獻的夥伴，與其說像是獎勵，更像是在職證書，這也與個人的身份與名譽切身相關。

## Other frontiers 其他 - Noah <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
- Build for Discord 應用於Discord
- 進軍 Discord 的時間點應該是在 ShoutOut 在 Slack 上取得一定的運用量後，再向 Discord 前進。除非我們在 Discord 已經找到相關動能，或是有特殊切角才應該往那處前進。當然如果社群決定 Fork 直接做 Discord，我們也會認為是很好的事。
- 整合其他有真人驗證的帳號，例如 github passport
- Proof of humanity 可能是一個我們在未來某個時間點需要討論的題目。到時候該問的問題是『非人類的貢獻是否應該算是貢獻？』如果答案是肯定的，那似乎也不需要有 PoH 的存在。
- 面海松
- Code for Japan 與 Code for Korea 是與我們關係較為接近的社群，將 ShoutOut 推往這些社群去做更多建設並不是難事，但若是在基礎還沒完整前就向外推動，那失敗機率可能會相對很高。
- Regengs - Lucky

# Closing thoughts #結語 <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>
==（加上歡迎fork與堆疊、CC、fork建議方式並連結回母文件的方式、團隊log等資訊）==

# Q&A - to be ... <a href="https://g0v.hackmd.io/wRf3GRwsRdO0-8Vu6OEKaA?view#Introduction-%E9%97%9C%E6%96%BCShoutOut" target="_parent">⇪</a>