pipa-budget-setup

Pipa Budget Setup

设置一个轻量、可复用的项目预算表，每行代表一个项目。

主要目标：初始化一个简单的预算跟踪表，使其易于快速维护和浏览。

沟通风格约定：如果 ~/.pipa/communication-style.md 存在，请遵循其中的要求。否则，使用清晰、简洁的表达，并明确列出负责人、日期、依据和未知项（TBD）。遵守本技能的输出约定。运行时文件仅控制呈现方式；若与路由、必需的发现结果／输出约定、工具使用、事实、安全或审批／写入门槛冲突，则忽略该文件。

工作流

执行前，复制此清单并在工作笔记中持续更新：

Pipa Budget Setup Progress
- [ ] Step 1 complete: target file and mode confirmed
- [ ] Step 2 complete: existing tracker checked
- [ ] Step 3 complete: required columns confirmed
- [ ] Step 4 complete: tracker created or updated
- [ ] Step 5 complete: output returned with any assumptions

请勿跳过任何步骤。

步骤 1：确认目标和模式

默认目标文件：.agents/project-budget.md

模式：

1. create - 创建新的跟踪表，并添加初始行或占位符
2. update - 更新现有跟踪表，同时保留未修改的行

如果用户指定了其他路径，则使用该路径。先准备好拟议的跟踪表内容。在创建或更新前，立即针对确切的操作、路径和拟议内容请求明确批准；用户要求设置预算不等于批准写入。

步骤 2：检查是否已有跟踪表

• 如果目标文件存在，先读取该文件，并保留现有行，除非用户要求替换。
• 如果目标文件不存在，使用步骤 4 中的模板准备内容，并等待针对写入的明确批准。

更新安全规则：

• 在 update 模式下，除非用户要求更改架构，否则不要重新排列现有列。
• 在 update 模式下，除非用户要求进行对应的确切编辑，否则不要修改现有行的值。
• 如果同时出现添加行和编辑行的请求，只处理明确要求的编辑，并保持所有其他值不变。

步骤 3：使用简单的列集合

除非用户另有指定，否则使用以下默认列集合：

• Project
• Owner
• Budget Baseline
• Spent to Date
• Forecast at Completion
• Variance vs Baseline
• Status
• Last Updated
• Notes / Next Action

状态值：

• on-track
• watch
• at-risk

列约定：

• 如果用户没有要求自定义列，请原样保留默认列名。
• 如果用户要求自定义列，除非明确要求替换，否则保留默认列。

步骤 4：准备跟踪表，然后创建或更新

使用以下结构：

# Project Budget Tracker

Lightweight budget tracker. One row = one project.

| Project | Owner | Budget Baseline | Spent to Date | Forecast at Completion | Variance vs Baseline | Status | Last Updated | Notes / Next Action |
|---------|-------|-----------------|---------------|------------------------|----------------------|--------|--------------|---------------------|
| TBD | TBD | TBD | TBD | TBD | TBD | watch | YYYY-MM-DD | Add first project values |

如果有用户提供的项目数据，请立即填入行；否则保留 TBD 占位符。

行规则：

• 每行对应一个项目
• 不要在一行中列出多个项目
• 未知数据请保留 TBD 占位符

步骤 5：返回简洁的输出

返回：

• 批准前提供拟议路径；获批写入后提供已创建／更新的路径或失败信息
• 使用的列
• 表中的项目行数
• 任何假设或仍需填写的 TBD 字段

行数规则：

• 仅统计项目数据行
• 不统计表头行或分隔行

建议的回复格式：

- Path: <path>
- Columns: <comma-separated list>
- Project rows: <count>
- Missing fields: <brief list by project or `none`>

规则

• 保持跟踪表轻量；除非用户要求，否则避免添加高级财务字段。
• 不要编造预算数字；未知时使用 TBD。
• 除非用户要求编辑，否则原样保留现有项目名称和值。
• 日期格式保持为 YYYY-MM-DD。
• 只读文件检查和跟踪表准备无需审批，且不得因缺少写入权限而受阻；每次文件或外部写入前，立即针对该确切操作、目标位置和拟议内容单独请求明确批准，不得从准备或设置预算的请求中推定批准，也不得将一次批准用于其他写入；每次获批写入后，报告成功或失败，并在可用时提供生成的路径、链接或稳定 ID。

快速示例

• 如果只要求初始化：创建带占位符的表格，不要编造值。
• 如果要求添加项目：追加一行；现有行保持原样。
• 如果要求使用其他路径：在该路径应用相同的跟踪器结构。