用途:在当前运行该技能的仓库(而非技能集合源仓库)中完成 Promise to Proof 的本地文件系统配置,包括建立 .p2p 工作流存储、可选的议题跟踪器配置、分级标签映射和领域文档指针。
主要能力:
- 先检查现有 AGENTS.md 或 CLAUDE.md、docs/agents/、Git 远程、议题与标签约定,以及 CONTEXT.md、CONTEXT-MAP.md 和 ADR 位置;可用 gh 查看目标仓库已有标签。保留既有配置和人工修改,重跑不得用默认值替换。
- 创建 .p2p/work/ 和 .p2p/tmp/,不覆盖已有内容,不创建 specs/ 或 work/。将 /.p2p/ 加入 .gitignore,保留无关规则与注释。
- 运行 python3 <skill-dir>/scripts/p2p_filesystem.py --repo <root> setup,其错误输出可定位冲突;可用 git check-ignore -v 查找冲突模式,不用 force-add 掩盖。
- 默认便携检查点位置为 p2p-state/<slug>.json,保持可跟踪,仅存紧凑 P2P 元数据,不创建空检查点文件。
- 写入 docs/agents/issue-tracker.md、triage-labels.md、domain.md 等配置文件,并在 AGENTS.md 或 CLAUDE.md 的 ## Agent skills 下添加短指针;两者都存在时需确认哪个为准。
使用方式:调用即授权标准本地文件系统配置。跟踪器为可选,仅在被要求或已在使用时配置 GitHub;确认目标仓库;不支持的跟踪器应说明其写入技能尚未就绪。分级标签仅在配置跟踪器时创建,映射 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix 五个角色,无映射时建议同名。配置文件本身不会在 GitHub 创建标签,缺标签需单独报告,并给出 gh label create "<label>" --repo <owner/repo>。
限制:安装过程不创建跟踪器议题或标签、不改远程、不创建领域文档;缺失的领域文件视为可选,不创建占位 CONTEXT.md、CONTEXT-MAP.md 或 ADR。本地写入不等于远程保存,候选/源提交也须可取回才能声明可移植性。安装与检查点创建均不授权提交、推送或议题评论。保存安装文件不会暂存、提交、推送或创建外部记录。未提供的功能、价格或平台信息暂未提供。