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
Source: hashgraph-online/awesome-codex-plugins → plugins/Colin4k1024/tsp/skills/graphify/SKILL.md