ziw-setup

设置

创建或刷新 docs/agents/workflow/config.md，即工作流查找表。 完成后应包含已验证的映射、可用的适配器，以及仅阻塞受影响工作流的缺口。

输入

仓库路径、现有配置/规则，以及请求的设置或刷新范围。

步骤

1. 阅读现有配置。初始设置时，使用 project-config.md 作为字段索引；加载适用的章节。刷新时，修补现有配置。
2. 根据请求和漂移证据设置验证范围。
3. 通过仓库文件和只读的提供商查询验证值。
4. 编写稳定配置，保留约定和决策。
5. 更新适配器；报告检查、变更和缺口。

设置验证范围

• 初始设置时运行；工作流发生变化或请求验证时，重新刷新。
• 初始设置或明确要求全面验证时，涵盖所有适用字段。
• 限定范围的刷新涵盖已变更/疑似有问题的字段及其依赖项。保留无关的稳定映射，但不得声称已重新验证；无关的可选集成不会造成阻塞。
• 过时的命令、重命名的标签、迁移的项目、CI、委派或环境变更，仅扩大受影响的范围。
• 对范围内的跟踪器映射，使用已配置的 ID/可安全用于查询的名称进行只读查询。仅当已验证的名称与原名称适用于同一范围时，才替换过时名称。
• 修改缺失、过时、错误或新验证的字段。保留明确的人为决策，除非用户或当前证据与之矛盾。

仅针对匹配的工作加载参考资料：

• 跟踪器状态、标签、就绪情况、正文、估算： issue-tracker-contract.md。
• 工作器、无人值守钩子、继续执行、循环限制、容量、合并安全性： operating-profile.md。
• Linear + Cursor：linear-cursor-example.md。
• 角色/适配器：agent-workflow.md。
• 交接：handoff.md。
• 未映射的术语表：glossary-discovery.md。

摩擦： 文件在使用已配置的投诉工具时遇到摩擦时，每种不同问题记录一次，且不得包含机密信息。缺少写入器、写入器失败或回复含糊时；进行基于跟踪器的接收时；或处理编排器事件类别或运行汇总时，加载 friction-log.md。

验证值

使用范围内的最新证据：

• 仓库规则、包脚本／锁文件、Make/Just/Turbo、Git 和 CI 可确认身份、命令、生成产物、分支／PR 约定和门禁。必要时查询代码托管平台的保护规则、关联检查和 PR 查询格式。
• 规范、术语表／上下文映射、ADR、运行手册和用户指令可确认规划权威来源、路径、状态约定和文档检查。
• 只读跟踪器调用可确认位置、项目／看板／团队、状态、标签、优先级、估算值、关联、模板和查询契约。记录精确且可安全用于查询的名称、稳定 ID 和受支持的字段。
• 跟踪器元数据、已验证配置或用户指令可确认委派、环境标签、续接句柄和远程机制。记录受支持的路径，而非完整的受派人清单。
• 从干净路径解析目标仓库中的 Claude/Codex/编辑器文件、导入项、符号链接和生成元数据。验证分发来源／模式、锁文件、刷新命令、项目路径、符号链接布局和市场。
• 部署配置、CI、运行手册、服务清单和用户指令可确认预览／托管检查规则、凭据和生产审批。
• 通过提供方配置／文档／设置验证已启用的托管审查。CodeRabbit 根目录中的 .coderabbit.yaml 映射 reviews.auto_review。

在定义足以确认命令时，据此验证；报告未执行的命令。 只读元数据查询使用现有的授权访问。省略无法验证的值，并指出缺失的证据。跟踪已授权且可执行的后续事项；否则报告负责人／行动。必需信息缺失时，仅阻止受影响的工作流。

门禁一致性

• 将钩子、本地检查和必需 CI 作业映射到命令。标出缺失的本地任务；保留阈值、环境要求和密钥扫描范围。
• 信任已配置的任务缓存；仅列出输入项未纳入缓存键的具体任务。
• 通过运行配置验证无人值守执行机制和生产审批。
• 优先使用已配置的 MCP 投诉写入工具。检查其架构时不要虚构事件；使用跟踪器作为后备方案必须有明确配置。

写入稳定配置

• 简洁地记录可复用的值、路径、命令、ID、路由、限制和策略。纳入适用的规划、跟踪器／就绪度、委派、访问、审查／合并、环境安全、投诉和交接映射。
• 跟踪器分类仅提供默认值，并不能证明标签确实存在。保留已验证的约定，并确保单独的标签文档与配置一致。
• 确保就绪度、风险、审查证据、类型、领域和归属策略保持一致。
• 保留术语表路径。新的默认值为 GLOSSARY.md，跨上下文时为 GLOSSARY-MAP.md。
• 记录技能分发方式：项目、插件／市场、托管、用户／全局或混合。
• 将生成的 ziw-* 副本归类为已提交的依赖项、符号链接分发、被忽略的缓存、不存在或仓库自有。对于已提交的生成依赖项，保留源文件／锁文件并以机械化方式更新。
• 在跟踪器中存储进度、阻碍项、基线失败和验证后续事项。实时读取 CI／PR／审查／部署健康状态和提供方可用性；名称／ID 用于描述架构。
• 删除状态说明前，使用范围有限的跟踪器位置／仓库路由查询，搜索先前设置的标题／描述。获得授权时，将非重复内容转移至已配置的受理渠道，不添加就绪度标签。否则保留说明并报告该操作。

更新适配器

• 在工作流技能之前，将现有的 AGENTS.md、CLAUDE.md、编辑器规则和使用文档指向配置。使用角色参考文档保持适配器简短。
• 遵循目标仓库的 Claude 注册规则，并导入其 Agent Markdown 文件，通常使用单行 @AGENTS.md。
• 仅为确切必需的路径创建符号链接；从干净检出状态验证目标。报告未获准的路径，并跟踪修复事项，切勿猜测。

禁止事项

• 不得编造或保留相互矛盾的值，也不得启用已禁用的可选集成。
• 不得将状态快照、执行证据、任务、对话记录或 Unknowns 存入配置。
• 不得丢弃等待移交的状态，也不得在无权写入跟踪器时用本地待办列表替代。
• 不得将实际实施问题分配给探查工作者，也不得提交虚构的投诉。
• 不得手动编辑生成的下游技能。
• 不得在配置中包含密钥、令牌、签名 URL、客户负载或私有日志。
• 除非获得明确批准，不得仅为验证设置而运行安装、部署、高成本托管服务或需要凭据的提供商操作。允许执行经授权的只读元数据查询。
• 设置期间不得部署到生产环境或对其进行修改。

完成后

报告配置路径、初始／完整／限定范围模式、已验证／更改／保留的字段、适配器、命令、已执行的检查、缺口、经授权的后续操作，以及受影响工作流的就绪情况。限定范围的刷新不代表已验证整个配置。