关于 pt-irs-runbook
面向处理 Modelo 3 申报及相关收入情况的纳税人，提供葡萄牙个人所得税诊断指引。决策树根据税务居民身份和收入类型，指向适用附表、税率、期限与申报操作，并提示复杂情况寻求专业协助。
主要功能
- 01居民身份与申报义务决策树
- 02按收入类型提供附表指引
- 03税率、扣除额与期限参考
- 04用于估算的确定性计算器
- 05复杂情况的升级处理提示
适用场景
- 01判断葡萄牙税务居民身份及申报义务
- 02确定租金或资本利得对应附表
- 03检查工资、养老金或自雇收入
- 04评估境外收入及双重征税减免
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/pt-irs-runbook确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
config.jsongotchas.mdmetadata.jsonassets/templates/report.mdreferences/capital-gains-tree.mdemployment-pension-tree.mdfiling-obligation-tree.mdforeign-income-tree.mdrates-and-deductions.mdrental-income-tree.mdresidency-tree.mdself-employment-tree.mdsymptoms.mdreferences/queries/property-capital-gain.pyrental-tax-estimate.pyresidency-days.py详细介绍
葡萄牙 IRS 申报操作手册
葡萄牙个人所得税（IRS）诊断操作手册。每个 症状 都代表一种申报情形；每棵决策树都会从该情形出发，找到正确的附表、独立税率和截止日期，最终给出具体的申报操作，或明确建议“因{原因}转交给认证会计师”。
非税务建议。 本技能根据所列日期核验过的 CIRS 和 Portal das Finanças 规则编写。税率和门槛会随每年的 Orçamento do Estado 变化。提交前，务必对照当前有效的第 68/72 条内容以及官方 Modelo 3 / IRS automático 界面确认数据；对于任何非常规事项，请咨询认证会计师。除非另有说明，默认收入年度为 2025 年（申报期为 2026 年 4 月 1 日至 6 月 30 日）。
适用情形
- 用户询问如何提交 Modelo 3（葡萄牙年度所得税申报表），或其收入适用哪些附表。
- 用户需要了解自己是葡萄牙税务居民还是非居民，以及这会带来哪些变化。
- 用户取得源自葡萄牙的收入——租金、房产/股份出售所得、工资、养老金或自雇报酬——并且必须申报。
- 用户是非居民房东（或作为居民取得外国收入），需要了解适用税率和避免双重征税的减免。
- 用户询问特定的葡萄牙税制：IRS automático、IRS Jovem、IFICI（NHR 后续税制）、englobamento、资本利得再投资。
本技能仅适用于葡萄牙。英国/其他国家的申报不在适用范围内（但涵盖跨境情形中的葡萄牙部分，例如也列入英国 SA106 的葡萄牙租金收入）。
使用方法
- 始终从居民身份开始。 阅读 residency-tree。居民身份（第 16 条）决定整个税制——是全球收入还是仅葡萄牙来源收入、适用累进税率还是固定税率，以及是否有扣除。
- 接着确认是否必须申报，以及适用哪些附表： filing-obligation-tree。
- 针对用户取得的每种收入，打开对应的决策树。 纳税人往往需要同时填写多个附表。
- 在一个地方查询每项税率/门槛： rates-and-deductions.md 是唯一权威来源；决策树会链接到该文件，而不是重复列出数字。
- 使用 references/queries/ 中的计算器（天数计算、租金税额、资本利得）确定性地估算数据，然后在 Portal das Finanças 上核验。
- 使用 assets/templates/report.md 总结结果。
常见问题
| # | 症状 / 问题 | 入口决策树 | 优先级 |
|---|---|---|---|
| 1 | “我是居民还是非居民——这会带来什么变化？” | residency-tree | P1（入口） |
| 2 | “我必须申报吗？可以接受 IRS automático 吗？需要填哪些附表？” | filing-obligation-tree | P1（路由） |
| 3 | “我从葡萄牙房产取得租金收入”（Categoria F） | rental-income-tree | P1 |
| 4 | “我卖了房产或股份”（Categoria G / mais-valias） | capital-gains-tree | P1 |
| 5 | “我有工资或养老金”（Categoria A / H） | employment-pension-tree | P2 |
| 6 | “我是自雇人士 / recibos verdes”（Categoria B） | self-employment-tree | P2 |
| 7 | “我有外国收入 / 可能面临双重征税”（Anexo J） | foreign-income-tree | P2 |
常见误区——默认回答容易犯的错误
| 常见误区 | 实际情况 | 位置 |
|---|---|---|
| “租金收入按累进税率征税” | F 类收入有自己的独立税率（基础税率为 25%，长期租约税率较低）；合并计税是可选项 | rental-income-tree |
| “2 年租约适用较低的租金税率” | 第 72 条的减税从5 年期永久住房合同开始；不足 5 年的税率为 25% | rates-and-deductions.md |
| “非居民的房产收益全额按 28% 征税” | 自 2023 年起，非居民与居民一样，适用50% 计入应税收入 + 累进税率 | capital-gains-tree |
| “只要注册 NHR 即可” | NHR 已不再接受新申请者；现行制度是 IFICI，资格范围窄得多 | foreign-income-tree |
| “非居民必须指定税务代表” | 若同意接收电子通知，则可不指定；欧盟／欧洲经济区居民始终可自愿指定 | filing-obligation-tree |
设置
首次使用时，在 config.json 中填写纳税人的情况 （居住国、税务代表状态、适用的税收协定、NIF）。如果必填字段为空，请向用户询问，然后保存。切勿存储密码——登录 Portal das Finanças 需交互完成。
注意事项
诊断流程中的死胡同和门户网站的特殊问题会汇总在 gotchas.md 中。 进行复杂的申报前，请先阅读。
相关技能
- 英国 Self Assessment / SA106 操作手册可为跨境情形（PT 租金 → UK FTCR）提供补充——不属于本技能。
评论
支持 Markdown