返回资讯中心
外部精选
软件工程
#开发者实时流

Pentimento 发布:为 AI 编码代理的计划文件提供状态与溯源管理

来源标题:Show HN: Pentimento – status and lineage for your coding agent's plan files

Pentimento 是一款为 Claude Code、Cursor 和 Antigravity 生成的计划文件提供状态追踪与溯源的工具。它从文件名无规律、不含状态信息的计划文件中推导出状态,并通过 CLI 支持列出、筛选和以谱系树形式渲染。用户可通过 pip install pentimento 安装,并用 AGENT_PLANS_DIR 指定计划目录。

Hacker News 最新kjiwa2026/11/10 · 7 天前29 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

为 Claude Code、Cursor 和 Antigravity 的计划文件提供状态、意图与血缘信息。

Claude Code、Cursor 和 Antigravity 会留下计划文件。累积到几百个之后,你就分不清哪些已经完成、哪些你还在意、哪个计划替换了哪个——文件名是随机的,文件本身也不说明自己的状态。pentimento 推导出这些状态,并提供一个 CLI,让你列出、筛选,并把它们渲染成一棵血缘树。

有三类计划值得再次找到:

用 harness 工程的说法,计划就是状态层:一个会话留给下一个会话的东西。pentimento hook 在 agent 写入时让该状态保持最新,prior-plans 技能则让 agent 把它读回来。

pentimento 指一幅重绘的油画下透出的早期画作;计划目录正是如此。

pip install pentimento

或从源码安装:

pip install git+https://github.com/kjiwa/pentimento.git

bash、zsh 和 fish 的 Tab 补全在 docs/reference.md#shell-completion。

将 AGENT_PLANS_DIR 指向你的计划目录(默认是 ~/.claude/plans),然后:

pentimento list # 查看语料库;派生字段无需回填即可显示 pentimento backfill # 持久化派生字段,使其比 transcript 存留更久 pentimento set some-plan-id --intent active pentimento list --starred

要暂存一个你打算回头再看的已完成计划,给它打标签并设置意图,之后按标签找到它:

pentimento set some-plan-id --add-tag auth --intent someday pentimento list --tag auth

要按血缘而不是按标签拉出一条子计划线索:

pentimento tree some-plan-id pentimento tree some-plan-id --ancestors

要查明某个早期决策是如何做出的,可跨所有项目搜索标题(或标题和正文),然后重新打开该计划;要查看你最近完成了什么,可按日期筛选:

pentimento list --title 'github actions|\bGHA\b' pentimento list --grep 'concurrency group' --status complete pentimento show some-plan-id --full pentimento list --status complete --since 1w

docs/workflows.md 会端到端地逐一演示这些操作。

各来源及其默认目录见 docs/integrations.md;Cursor 和 Antigravity 的规则与注意事项见 Cursor 和 Antigravity 两节。

下面的示例由 sh demo/capture.sh 重新生成。

PLAN 显示短 id,例如 api-auth-rollout 的短 id 是 auth-rollout。--columns(或 PENTIMENTO_COLUMNS)选择显示哪些列以及它们的顺序;见 Columns。

list 和 tree 共用筛选条件,列在 synopsis 中。

PLAN STATUS INTENT PROJECT SOURCE TITLE TAGS CREATED UPDATED style-guide superseded abandoned platform claude Write a docs style guide 2026-07-31 6w auth-redesign complete abandoned platform claude Redesign the auth API [auth, +1] 2026-08-05 5w dunning-copy complete someday billing claude Rewrite dunning email copy [billing] 2026-08-20 3w auth-rollout partial active platform claude Roll out the new auth API [auth, +1] 2026-08-25 2w auth-cleanup not-started queued platform claude Remove the old auth API [auth, +1] 2026-08-30 2w auth-docs not-started unset platform claude Document the new auth API 2026-09-02 1w invoice-retry unknown unset billing claude Retry failed invoice charges [billing] 2026-09-04 1w relevance-tuning not-started active billing claude Tune search relevance [search] 2026-09-09 5d onboarding-checklist not-started unset claude Write the onboarding checklist 2026-09-13 1d 9 plans

低于表格阈值时,list 会把每个计划堆叠成一条记录;见 layout rule。

Write a docs style guide style-guide superseded abandoned platform claude 2026-07-31 6w Redesign the auth API auth-redesign complete abandoned platform claude [auth, security] 2026-08-05 5w Rewrite dunning email copy dunning-copy complete someday billing claude [billing] 2026-08-20 3w Roll out the new auth API auth-rollout partial active platform claude [auth, security] 2026-08-25 2w Remove the old auth API auth-cleanup not-started queued platform claude [auth, security] 2026-08-30 2w Document the new auth API auth-docs not-started unset platform claude 2026-09-02 1w Retry failed invoice charges invoice-retry unknown unset billing claude [billing] 2026-09-04 1w Tune search relevance relevance-tuning not-started active billing claude [search] 2026-09-09 5d Write the onboarding checklist onboarding-checklist not-started unset claude 2026-09-13 1d 9 plans

tree 计划嵌套在其父计划下,按项目分组。plain tree 这样渲染整个语料库;tree <id> 则以一个计划为根——该计划及其下的所有内容(见 tree <id>)。--ancestors 还会向上走到 <id> 的最顶层祖先,仅沿主干,用于从更大的森林中拉出单条线索。

(no project) -- Write the onboarding checklist onboarding-checklist not-started unset 2026-09-13 1d billing |-- Rewrite dunning email copy | dunning-copy complete someday [billing] 2026-08-20 3w |-- Retry failed invoice charges | invoice-retry unknown unset [billing] 2026-09-04 1w (parent elided: no-such-plan) -- Tune search relevance relevance-tuning not-started active [search] 2026-09-09 5d platform |-- Write a docs style guide | style-guide superseded abandoned 2026-07-31 6w -- Redesign the auth API auth-redesign complete abandoned [auth, security] 2026-08-05 5w -- Roll out the new auth API auth-rollout partial active [auth, security] 2026-08-25 2w |-- Remove the old auth API | auth-cleanup not-started queued [auth, security] 2026-08-30 2w `-- Document the new auth API auth-docs not-started unset [auth, security] 2026-09-02 1w 9 plans

platform -- Redesign the auth API auth-redesign complete abandoned [auth, security] 2026-08-05 5w -- Roll out the new auth API auth-rollout partial active [auth, security] 2026-08-25 2w |-- Remove the old auth API | auth-cleanup not-started queued [auth, security] 2026-08-30 2w `-- Document the new auth API auth-docs not-started unset [auth, security] 2026-09-02 1w

show

Roll out the new auth API

id: api-auth-rollout path: ~/.claude/plans/api-auth-rollout.md

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →