mcpField
T
to-wiki

to-wiki

github.com/beeltec生产力241 次安装11 周前更新
代码仓库

关于 to-wiki

由用户调用的 Wiki 技能,用于发布对话中明确确认的持久项目知识。它会核对仓库证据、维护概念与 ADR,并在可能造成破坏的变更前暂停。

主要功能

  1. 01收集已确认的知识
  2. 02依据仓库证据核实内容
  3. 03发布概念与 ADR
  4. 04更新索引和元数据
  5. 05破坏性变更前暂停

适用场景

  1. 01记录已生效的架构决策
  2. 02添加或修正项目术语
  3. 03发布已确认的行为与指引
  4. 04将未确认的变更交由待办处理

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/beeltec/skills --skill to-wiki

安装后在 Claude Code 中输入/to-wiki确认已加载。

详细介绍

转入 Wiki

调用此技能,即表示所有者常设批准发布本次对话中明确确认的持久知识——无论来自讨论还是代码库检查,包括创建、修正或扩展概念,发布已生效决策的 ADR,补充和修正通用语言,以及派生的索引、链接、元数据和日志变更;对于这些仅涉及新增和纠正的事务,此批准取代 $wiki 对逐项事务设置的暂停要求。其他情况均遵循 $wiki。此批准绝不授权弃用或删除现有概念、取代现有 ADR、修改 docs/backlog、发布提案形式的内容,或触及未经确认的知识。

仅在第 3 步逐项暂停处理候选项和硬性阻碍时暂停;除此之外,运行至完成并报告。仅由用户调用,或由 $to-product 调用;后者的自主契约还会自动批准第 3 步的暂停——包括概念弃用、概念删除、ADR 取代——并逐项报告。

工作流

  1. 收集候选项 — 列出用户在本次对话中明确确认的每项结论,包括已确认的术语和架构决策。依据 $wiki 的知识资格标准逐项分类:仅接受已描述当前主分支所认可状态的持久事实、行为、规则、决策和指导。对每项已确认决策应用 ADR 重要性测试,并将符合条件的标记为 ADR 候选项。拒绝期望的变更、目标规范、仅在提议的工作发布后才生效的决策,以及未解决的问题;在报告中将它们转交给 $backlog;绝不发布。
  2. 验证并发布 — 按依赖顺序处理每个已接受的候选项:依照 $wiki,根据仓库证据验证其声明;将其归入所属的规范概念,或创建范围最窄且内容连贯的概念;按照经过验证的 $wiki 持久事务要求进行编辑,补齐必需的索引、链接、元数据和日志条目,并注明本次调用是记录在案的批准。若 $wiki 允许,将相关编辑合并到同一事务中。
  3. 逐项暂停 — 当已确认的结论需要弃用或删除现有概念,或取代现有 ADR 时,逐项展示该项确切事务——包括证据、入站引用、ADR 双向对应关系及影响——并仅在获得明确的逐项批准后执行。绝不将其并入常设批准,除非适用 $to-product 的自主契约;该契约会批准此类操作并逐项记录。
  4. 报告 — 报告已发布的概念、分配了 ADR-NNN 的 ADR,以及术语;列出对应事务和提交哈希;列出被拒绝的候选项及其 $backlog 转交情况;报告所有破坏性操作或取代决策及其结果;并给出最终的 node scripts/validate-project.mjs 运行结果。

验证器失败、证据与已确认的结论相矛盾,或当前认可状态未得到确立,均构成阻碍:不要发布该候选项的任何内容,保留已提交的事务,并报告情况——绝不强行认可。

在报告末尾写上 Next step:,并提供一个可复制粘贴、符合处理结果的命令:若有被拒绝的期望变更候选项,则使用 $to-backlog 并列出这些候选项;否则,若存在排名最高且已就绪的 WORK-NNN,则使用 $implement;若两者均不适用,则省略。

评论

支持 Markdown