graphify
将 Graphify 作为可选知识图谱能力接入,用于 brownfield 结构扫描、依赖路径分析与架构问答。 不替代 `/team-*` 主链;输出统一回落到 handoff 与 artifacts 证据。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- graphify
- origin
- safishamsi/graphify (adapted)
- description
- 将 Graphify 作为可选知识图谱能力接入,用于 brownfield 结构扫描、依赖路径分析与架构问答。 不替代 `/team-*` 主链;输出统一回落到 handoff 与 artifacts 证据。
02 资源文件 1
- 参考文档agents/openai.yaml342 B
03 SKILL.md 正文
Graphify
用途
- 对已有仓库做结构化认知:模块关系、调用路径、关键依赖、热点边界。
- 在设计和实现前补“证据层”,降低只靠直觉拆任务的风险。
- 为
/team-plan、/team-execute、/team-review提供可回溯的图谱证据。
触发信号
- brownfield 项目,且改动面跨多个目录或服务。
- 需求涉及“这个能力到底在哪里实现”“改这个会影响哪些模块”。
- 评审阶段需要对依赖路径、耦合点和影响范围做结构化证明。
默认工作流
- 先跑
npm run graphify:doctor,确认 Python 与 Graphify CLI 可用。 - 在项目根目录生成/更新图谱,统一输出到
graphify-out/。 - 用
query/path/explain回答任务相关的结构问题,形成可引用结论。 - 把关键发现回落到主链:
- 规划阶段 ->
/team-plan的 challenge/design/readiness 证据 - 执行阶段 ->
/team-execute的 story slice 影响面说明 - 评审阶段 ->
/team-review的风险与回归边界说明
- 规划阶段 ->
- 结论需要通过 handoff 或 artifact 写入项目文档,不停留在临时会话。
输出约定
- 统一目录:
graphify-out/ - 最小交付内容:
- 本次分析目标(问题是什么)
- 查询/路径命令与核心结果(结果是什么)
- 对主链决策的影响(接下来做什么)
边界与禁用项
- Graphify 只是可选能力,不替代 workflow-engine,也不创建并行责任链。
- 不在本仓库执行
graphify codex install或graphify claude install,避免改写现有 AGENTS/hooks 契约。 - 不自动安装 Python 或
graphifyy;环境依赖由使用方负责。
推荐组合
- 结构不清的 brownfield 任务:
/team-help -> graphify(build/query/path/explain) -> /team-plan - 高风险改动评估:
/team-execute -> graphify(path/explain) -> /handoff -> /team-review
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.