Skip to content

sairaisaika/project-wiki

v0.2.6MIT

Source-backed wiki routing, change review and agent handoffs.

GitHub

projectWikiSkill

0.2.6 source is normally adopted and one Windows host was updated through the official CLI, with installed bytes/source and inventory/version observations checked separately. The new doctor only reads caller-captured host evidence; installation/enabling does not establish hook execution or agent adoption. Running scoped workers were not upgraded. See actual host adoption and doctor observations.

内部协作插件计划：以现有 Skill/工具为唯一内核，补可复现打包、来源自检与宿主接线，再用真实工程验证开工、委派、收尾与接管。内部候选已在一台 Codex 主机通过官方 CLI 安装并核对缓存，Linux Claude 已做临时加载与真实任务试用；桌面新会话采用、hooks 与完整跨宿主验收仍待，未公开发布。根 plugin.json 是身份源，不能单凭它声称运行已验证。源码已采用0.2.5；换行来源机制保留原始输入指纹，区分规范文本来源一致与包文件字节完整；有限宿主采用记录另证官方 Windows CLI 安装0.2.5及实际有限使用。既有 scoped0.2.4 工程任务不由此自动升级。

协作工作流提供原生任务 JSON 的快照、任务包、范围受限的委派和真实 diff 收尾；全部卫星、能力缺口、未展开候选与跨仓版本保留。脚本不派 agent、不自动执行页内检查，也不把结构闭环认证成业务完成。当前是内部候选，宿主生命周期与项目试用按计划分别验收。

让项目 Wiki 成为比猜文件名、全仓搜索更省事的工程入口。

可安装 skill 在 project-wiki/，名称为 $project-wiki。它将问题、精确源码位置、接口契约、规则、影响面、检查与证据边界连接起来；分别量化结构完整度、任务路由表现、语义核验和实际使用效果，避免一个总分掩盖未知。

  • 了解项目与导读：从产品、角色和跨域例子建立理解；区分全文阅读与导语巡读，理解验收与任务定位分别评价。
  • 功能闭环规则：所有功能按用户结果核必要能力与八维证据；文档结构、实现接通、运行验收分别判，缺口不能当完成。
  • 结构契约：接口声明、实现、消费者、规则来源、失败与兼容、精确定位。
  • 量化模型：100 分结构量表、任务命中率与独立演练指标。
  • 持续维护：改动触发、计划交付、漂移检查、CI 与交接。
  • 既有 Wiki 接入：复用原生索引与闸，恢复中断审阅，沿生产者、消费者、部署证据核验事实；不强制迁移到第二套 manifest。
  • 六图框架：架构、流程、时序、数据模型、部署、状态六种视角的职责与项目级覆盖检查。
  • 工程深度：字段/单位/字节布局、状态守卫与上下文、重试和资源边界、轻量决策记录。
  • 复合改动定位：任务地图、内部编辑接缝、捕获范围、共用规则与完整工作面验收。

使用

将整个 project-wiki 文件夹放入目标工具支持的 skills 目录，或通过支持 GitHub 子目录的 skill 安装器从本仓 project-wiki 子目录安装。安装位置由用户决定，仓库内容不自动修改本机配置。

Python 3.10+ 即可运行工具，无第三方依赖：

python project-wiki/scripts/wiki.py query --root <project> "外部源端口"
python project-wiki/scripts/wiki.py task --root <project>
python project-wiki/scripts/wiki.py task <task-id> --root <project>
python project-wiki/scripts/wiki.py audit --root <project>
python project-wiki/scripts/wiki.py build --root <project>
python project-wiki/scripts/wiki.py check --root <project>
python project-wiki/scripts/wiki.py evaluate --root <project> --tasks <tasks.json>

可以先在本仓完整样例上运行：

python project-wiki/scripts/wiki.py build --root evals/fixture-project
python project-wiki/scripts/wiki.py evaluate --root evals/fixture-project --tasks evals/tasks.json
python -m unittest discover -s tests -v

六图样例的可选渲染验收使用 node evals/render-diagrams.mjs，需要可用的 Playwright 与 Chrome；可用 WIKI_PLAYWRIGHT_MODULE 指向已有模块、WIKI_BROWSER_CHANNEL 选择浏览器。工具不自动安装依赖，默认输出到临时目录；Mermaid CDN 可由 WIKI_MERMAID_URL 指定固定版本。核心 Python 工具仍无第三方依赖。

结构分、合成样例、自己演练和陌生执行者盲测分别报告；它们均不等于真实业务、部署或外部 API 已验证。仅 build 写生成索引；其余命令不执行目标项目或清单中的检查命令。

项目起源于两个共用 Wiki 的开源仓库的接口改进演练；skill 是通用工程方法，不要求固定技术栈、固定页数或每个功能画六张图。

验证记录包含结构评分、任务自测、一次独立只读试用及已有真实项目的兼容审计。试用发现的“复合查询截断”和“失败模式不够细”已经反馈到 skill、结构字段与回归测试。