community-guides

社区指南

帮助社区将共同关注的问题转化为可行的行动方案，并设计出其他引导者也能开展的计划。成功意味着材料可用、依赖关系明确，并如实说明哪些内容已核实、哪些仍需参与者确认。

何时不使用

目的地研究和访客行程请使用 travel-guide；仅涉及文档渲染或格式设置时请使用 documents；产品需求研究请使用 product-discovery。此技能负责社区计划设计，不会取代专业技术建议，也不会指导正在发生的紧急事件。

选择入口

• 创建： 根据社区简介和证据进行设计。
• 改编： 检查提供的指南，保留有用的活动，并说明新社区的具体情况导致了哪些变化。
• 修订： 将反馈和事实变化对应到具体活动、工作表和引导者说明。保留有用材料，并展示修订内容。

默认使用可编辑的 Markdown。遵循所要求的媒介和范围：一场工作坊可能只需一份文档；系列活动可能需要一本工作手册和单独的主持人说明。七场活动只是示例，并非要求。不要收集所有可能的材料，也不要把结构化计划强加给只要求简短文字的请求。

根据当前可作出的决定调整流程。当主题或社区范围都尚不明确时，应在模块设计前停下：返回一份简短的探索草案（约一屏，通常少于 300 个单词）、至多三个关键问题，以及一个可选的下一步。不要将首次回复扩展成工作手册、引导手册、反复罗列未知事项的表格或发布审批流程。只有在用户提出要求或确有必要解决已知复杂问题时，才进行较长的需求收集。 对于范围明确的工作坊，参与者手册应简短，并将研究笔记和操作细节放在明确分开的引导者部分中。 对于范围狭窄的修订或尚未解决的来源冲突，应交付用户要求的修订卡片或决策简报，以及简明的变更／核验说明。除非能推进明确要求的学习成果，否则不要添加工作坊、新工作表或多轮试点。针对无法确认的本地事实，应安排有针对性的核验步骤，而不是扩大计划。 对于范围明确的修订，请使用修订清单。 交付前必须完成来源到行动的审查以及语言／版本预检；必须删除缺乏依据、要求居民采取行动的指令，而不能仅仅标记出来。

工作流程

1. 明确社区简报

先提取已知事实，再提出问题。请使用简报模板。 明确指南服务的对象、期望培养的能力、当地情况、现有资源、参与限制、 可用时间、交付形式和指南负责人。只询问那些会实质影响项目的缺失信息。 在可能的情况下，基于明确的假设继续起草有用内容；如果缺少所在地信息或 证据，则暂不提供依赖所在地的建议。

组织者的讲述只代表一种视角。记录哪些人的经历得到呈现，以及还需要征求 哪些人的意见。绝不可捏造曾经开展过咨询、已达成共识、已接受志愿者角色， 或当地服务机构愿意提供帮助。

研究或调整本地内容时，请阅读本地化与证据。 公开研究可支持事实性主张；居民的讲述可反映亲身经历的限制和优先事项。 两者都需要注明来源，并明确适用范围。

当用户要求研究仅限于所提供的来源时，技术建议也必须遵守这一限制。如果 反馈指出某项安全指引缺乏依据，请删除该内容或将其隔离，并标记替代内容 以供具备资质的人员核实；不要依据一般知识编造新流程。临时草稿不得将拟议 的核实工作或服务描述为已经开展。不得在面向居民的文案中加入缺乏依据的 安全说明；在提供权威来源之前，应说明替代内容尚未确定。任何编辑用占位 内容都应放在核实备注中，而非居民可能据此采取行动的指引里。

2. 明确成果和依赖关系

针对每项需求，梳理以下链条：

need → capability → activity → usable output → real action → check

只选择有助于实现所需成果的模块。将前置行动排在前面：购买前先清点； 建立目录前先就信息共享达成一致；依赖联系链之前先确认各方接受相应角色。 在适当情况下，提供低成本或零成本的入门行动，以及需要投入更多的选项； 不要仅以金钱衡量投入程度。

编写新项目之前，请阅读活动与引导设计。 默认循环包括简要说明、反思、共同练习、复盘和切实可行的后续行动。 根据可用时间进行调整。

3. 编写配套材料

使用模块模板作为参与者和引导者说明的通用记录。提供一个已填写的虚构示例，以及一份任何陌生工作表的空白副本。每项练习都应产出一项决策、实践成果、地图、计划或其他可用成果；若仅进行讨论，需说明其目的。

提供时间安排，包括开场介绍、口译、过渡和结束环节。列明准备工作、所需物资、说明、复盘问题、完成情况检查，以及前置条件不满足或帮手无法到场时的备用方案。区分家庭内部的私人记录与自愿共享的信息。

将限制转化为实际可行的替代方案：租户需要能在其掌控范围内采取的行动；无法上网的参与者需要纸质版核心说明；错过会议的人需要补课途径。不要假设参与者有购买能力、具备读写能力、有交通工具、拥有住房，或愿意披露个人需求。翻译需要由具备相应能力的人员审核；仅靠机器翻译不能证明这一点。修订现有多语言指南时，除非用户调整范围，否则应保留其涵盖的语言。必要时提供标注清楚的草译，并指出仍需进行的审核；承诺日后翻译并不能替代缺失的译文。仅修订源文本时，可以翻译源文本所涵盖的内容：源文本边界禁止添加事实，但不禁止用另一种语言表达这些事实。交付前，应逐一检查每种语言的居民版材料。只有英文卡片并附注承诺日后提供西班牙语版，不算完整的双语修订。

按需使用工作表模板、引导者模板和维护模板。每个拟议的共享职责都应说明如何征求并获得认领，以及无人认领时的备用方案。

对于多模块或多文件指南，应依据计划规范维护一份结构化计划。用它确保各材料中的模块 ID、工作表、时间安排和证据保持一致；不要向参与者展示 JSON。

4. 检查并修订

进行一次冷启动演练：新任引导者能否仅凭这些材料准备并开展活动？参与者能否完成每份工作表？检查指南与主持人备注是否一致、每项决策是否都有后续步骤，以及必要信息是否能通过预期媒介获取。 逐项核对所有具名或编号引用与实际交付的工作表：其中的章节、复选框数量和字段标签是否与描述相符？不要仅因两份文档都提到同一项活动，就推断它们一致。 对于职责分配图，检查是否存在相互矛盾的接受声明、超出所述可用时间的重叠任务分配，以及依赖同一位无法承担工作的人员的备份安排。保留现有已接受的工作范围；将新增工作标记为提议。

对于仅基于来源材料进行的修订，逐项审查每条面向居民的指示语是否有提供的来源支持。删除无依据的指示，即使听起来很稳妥（例如，臆造的临时报告渠道、等待指示或紧急处理流程）。改用如实说明未解决状态的通知。仅在明确标记为已弃用的来源记录中保留历史上的不安全措辞，不得将其放入当前使用的卡片。

对于结构化计划，运行只读检查器（Python 3.10+，标准库）：

python3 scripts/validate_guide.py /path/to/guide/plan.json

从技能根目录运行，或从其安装位置解析脚本。阅读其 JSON 诊断信息，修复错误并处理警告。此检查器会检查记录、文件引用和时间安排；不会核实事实、文案一致性、翻译或社区可用性。其测试通过以下命令运行：

python3 -m unittest discover -s scripts -p 'test_*.py'

对于 PDF/Word 输出，使用可用的 documents 工具，并检查渲染后的页面，尤其是工作表、分页和打印可读性。如果无法使用此工具，请交付可编辑内容，并说明尚未完成的渲染检查。

如需独立演练、试点设计或技能评估，请阅读审查与评估。Agent 模拟必须标明为模拟。

5. 交付并维护

入口点的范围规则优先于本完整项目清单。对于信息发现或范围有限的卡片／决策简报修订，仅提供所请求的产物以及简明的核验／变更说明。只有当所请求的产物或现有资料包有此要求时，才添加维护和所有权记录。

对于完整项目，交付所请求的指南、相关引导材料、来源材料和适配说明，以及维护记录。列出影响使用的未解决本地事实和拟议角色。指定负责人，或标记所有权尚未确认；提供审查日期或触发条件，并说明反馈应如何促成修订。

只有在所请求的产物已完成、报告了适用的检查结果且未解决的依赖项清晰可见时，才算完成。如果只进行了 Agent 检查，请说明已准备好进行社区试点。只有具备实际证据时，才能声称已通过参与者测试验证可用性。如果某个关键未知事项导致指南无法使用，请先完成可独立完成的部分，并提出继续所需的具体问题；不要编造答案，也不要声称已完成。

此技能会生成本地产物。发送邀请、收集居民信息、修改共享记录或对外发布都会改变外部状态：**采取行动前，先确认目标、范围和回滚路径。只读信息发现无需确认即可进行。**现有的明确授权可视为已提供该确认；仅创建指南并不构成执行这些操作的授权。

完整示例与来源说明

如果完整的「从简报到指南」模型会有所帮助，请阅读原始公寓示例。其中的计划和主持人笔记展示了如何协调。示例中的所有人员、约束条件和本地证据均为虚构内容；它不是技术故障应急手册。

改编 Ready Together 时，请阅读来源模式与署名。保留参与式方法，同时重新研究技术内容。未经适当许可，请勿复制原始手册中的文字、图像或工作表。