{"_id":"@airpot/agent-gov","_rev":"9-42fda1fb63d24cc6e81cf960e2943344","name":"@airpot/agent-gov","dist-tags":{"latest":"0.1.8"},"versions":{"0.1.0":{"name":"@airpot/agent-gov","version":"0.1.0","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.0","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"8632af74c8a0142e17ae77ecefedf3ffe96085a0","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.0.tgz","fileCount":72,"integrity":"sha512-aAyvslpfhj+D1Pd+gz6Fvq1nGXCWdjCTIz/Ri40wBf/cjZ0+H4T4E2c8pOlcu9IIHcXwfnrbZsKzevBelB/e5g==","signatures":[{"sig":"MEYCIQCNpwRBx8hNdCPMPYuRL1DgkUvue+vEOaUKeMsEWfA4EQIhAKDwZW4r/7ZDS967YtOX2wSwXzBjP4KYCNb+L8RYxard","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":302388},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"031bf3b7b1a92e0d19618ac536224651fdc4510e","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.0_1777864339447_0.3232937030725125","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@airpot/agent-gov","version":"0.1.1","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.1","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"1bf684983040968ec489e2595a03cf67054c44f5","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.1.tgz","fileCount":78,"integrity":"sha512-6xTdKvYzxRYAgXzlrmdD9P+nXvLq77fB3sN6CaUcpu0XlI72k3vcx2DbA5ew4nVJ6SxVR2k78FoFp6wwJ3Jo6w==","signatures":[{"sig":"MEYCIQCWJEozeE851HSZQUBbXbQ/Cpuh9vECHAtClGgtlJqL9AIhAJU1RxbihGrmGdNbKkqboiBIbJt9etDRXQ8zKDDUPM4L","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":364361},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.1_1777887284667_0.5333659227440815","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@airpot/agent-gov","version":"0.1.2","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.2","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"bf64b4f84214b5ca19193ab88d68f37d8cb3fa35","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.2.tgz","fileCount":79,"integrity":"sha512-4YGlDAi2aRBvGA9MJLObZSyCDRyYXvKQCA88kW3Mb/W26g0OQYdkVStsAbLdyA8+WodM7WPRPE1mC+E/s9m8mA==","signatures":[{"sig":"MEYCIQDPc4e/LvOw+cszmbiSFiEvUF5m1nk+ks/HsZl/wyGIxQIhAP6MTOLmYy2T64zOK5W5IEvEB7Ql1p+M+5jZj4cQH5vy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":379634},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.2_1777938444430_0.5358238909357524","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@airpot/agent-gov","version":"0.1.3","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.3","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"1473afaa4b5d5b0bae4461c6a69c761b1abc126b","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.3.tgz","fileCount":79,"integrity":"sha512-r12uChPR5N3sTSD+s8XcZd3tB0TezzsvmULPt8znSu2dxMHZVISJXn9binMAkPTq5fZ+ocCCyj3k+vlPbCSw0g==","signatures":[{"sig":"MEYCIQCfR7ay8H94b2PqFQGJ/3aIRrCm6c+2ArumPVjoJ4KVyQIhANMCOwrDzZKVEodyQG+ItgGUo5UmJ/cdwTPVYE8pT2y8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":382669},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.3_1777938929158_0.18624116020470782","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@airpot/agent-gov","version":"0.1.4","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.4","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"6ee9516d675ff94c591a2a554c41cac31c007bf2","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.4.tgz","fileCount":80,"integrity":"sha512-JG2FoXanp1zSmCDG+IOIM0nje6EbtfWAiY1ukyp/Aj5v1OSAbtXUeRK9kph8zVzHD/0B4YpAcosdKkCrZsx6gg==","signatures":[{"sig":"MEUCIAyeZxiUOPqSEYwzOpJSJH1VqN0QRX3gngN2DvjiBuX7AiEAhawWN/B56lQBPGhtqRuSvisOuKXcNRM/YaV+nIbTH9U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":413904},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.4_1777941775001_0.4657025224119782","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@airpot/agent-gov","version":"0.1.5","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.5","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"a5fdada11317e517489c041b51f6499129cd4de5","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.5.tgz","fileCount":85,"integrity":"sha512-wiQZprVu6W2xrKTLXOGJPrbXvWk/seCqQ2IhwqDFiu4AcjkLDq9QU/uEUyJLYVnnCXpN6dyqLLSZ8ZK3YDlShQ==","signatures":[{"sig":"MEUCIAX04C8vYWMikIncyPQUsJJ0gu/pXOrRYgXc2+9EVePWAiEAyxCW/rozi6S6mfT2TZ37Mkgzl3rJSspK3C+b5e+7FdM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":580661},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.5_1777986626335_0.15602253254329934","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@airpot/agent-gov","version":"0.1.6","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.6","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"cf1d44bdee7f5ed3cebe747a958327a0daafcc42","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.6.tgz","fileCount":85,"integrity":"sha512-NJNy75GCwje2EoNi48Gyvhu83EXSkbGlAL3FgEkUzsmJAmsd3mXdaOUvfG2Wf/HDnnBnXLXaq7OCIhnXhQMoPw==","signatures":[{"sig":"MEYCIQCEnQGgTD9tOpTP0fNccionzXth7EyGgMl2AyIzRwfBQwIhALcsrk9mOMakVKQS+WjxKMta3UyxI6YhduXxogX8AHLx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":615164},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.6_1777992654536_0.6753825185044178","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@airpot/agent-gov","version":"0.1.7","keywords":["codex","claude","agents","governance","openspec","skill"],"license":"MIT","_id":"@airpot/agent-gov@0.1.7","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"dist":{"shasum":"d760a8a54e1354d1db739aa3632f96014e3dca24","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.7.tgz","fileCount":87,"integrity":"sha512-V7dI7lGl3NivYyLyMIeewCzYbCC8zo109O7Gj+xLGMwDhSUaH6m3iQNeKVVVxmHkpmA5zLRMNPlR5ICQoKKrfw==","signatures":[{"sig":"MEQCIFY71NUUsEQCdcOreg7uFOcqhtNtbJPNC7kcdxfWSuoTAiAHVqntn22+aPXSRrhGzjYNmwtbZztegEuW0T1V/2w3zA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":679388},"type":"module","engines":{"node":">=20.19.0"},"gitHead":"5193c813db6d587ebfbdb10190e458f5083525d2","scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"repository":{"url":"git+https://github.com/airpot/agent-gov.git","type":"git"},"_npmVersion":"11.8.0","description":"One-command project governance initializer for Codex and Claude agent workflows.","directories":{},"_nodeVersion":"24.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-gov_0.1.7_1779029790050_0.8970914790778133","host":"s3://npm-registry-packages-npm-production"}},"0.1.8":{"name":"@airpot/agent-gov","version":"0.1.8","description":"One-command project governance initializer for Codex and Claude agent workflows.","license":"MIT","type":"module","repository":{"type":"git","url":"git+https://github.com/airpot/agent-gov.git"},"homepage":"https://github.com/airpot/agent-gov#readme","bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"bin":{"agent-gov":"npm/bin/agent-gov.mjs"},"engines":{"node":">=20.19.0"},"scripts":{"validate":"node --check npm/bin/agent-gov.mjs && python3 npm/scripts/regression.py && npm pack --dry-run","pack:dry-run":"npm pack --dry-run"},"keywords":["codex","claude","agents","governance","openspec","skill"],"publishConfig":{"access":"public"},"gitHead":"e37d6cdd15a8c1c55c66caa2f065bb94f3402fd3","_id":"@airpot/agent-gov@0.1.8","_nodeVersion":"24.13.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-Rmlwaw5ssbmGLWvC4tEAJQRgqHlfC0qaddPtooO0LCzq8QMvTgQcoUW3cHAfQneZ6X6IjW5WRxxD/tc75i4NKg==","shasum":"c456864992112393771de7247c0859be68f20c52","tarball":"https://registry.npmjs.org/@airpot/agent-gov/-/agent-gov-0.1.8.tgz","fileCount":92,"unpackedSize":723233,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCyQ7X9qCxeVlt4z4UiK4bPhzwSt/Lc+t3nVrsE7IP7BwIgWPoRCLYF7UHPvOuLSn3EHd5O4LsHIEy0o4ADiPz/iiE="}]},"_npmUser":{"name":"airpot","email":"airpot@foxmail.com"},"directories":{},"maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-gov_0.1.8_1779534543277_0.3676527094871187"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T03:12:19.392Z","modified":"2026-05-23T11:09:03.549Z","0.1.0":"2026-05-04T03:12:19.615Z","0.1.1":"2026-05-04T09:34:44.808Z","0.1.2":"2026-05-04T23:47:24.621Z","0.1.3":"2026-05-04T23:55:29.307Z","0.1.4":"2026-05-05T00:42:55.244Z","0.1.5":"2026-05-05T13:10:26.546Z","0.1.6":"2026-05-05T14:50:54.758Z","0.1.7":"2026-05-17T14:56:30.226Z","0.1.8":"2026-05-23T11:09:03.448Z"},"bugs":{"url":"https://github.com/airpot/agent-gov/issues"},"license":"MIT","homepage":"https://github.com/airpot/agent-gov#readme","keywords":["codex","claude","agents","governance","openspec","skill"],"repository":{"type":"git","url":"git+https://github.com/airpot/agent-gov.git"},"description":"One-command project governance initializer for Codex and Claude agent workflows.","maintainers":[{"name":"airpot","email":"airpot@foxmail.com"}],"readme":"# Agent Gov\n\n`agent-gov` 是一个面向 Codex / Claude 长周期软件开发的项目治理 skill 和一键初始化工具。它的目标不是替代你的测试、代码审查或项目设计，而是把 agent 开发过程中容易丢失的规格、会话上下文、验证证据、审阅结论和交接信息固化到仓库文件中。\n\n当前 npm 包名：\n\n```bash\n@airpot/agent-gov\n```\n\n## 借鉴的开源项目与公开资料\n\n`agent-gov` 借鉴了以下项目或公开材料的设计思想。这里的“借鉴”指治理机制、工作流模式和文档结构，不表示 vendoring、运行时依赖或自动安装这些项目。\n\n| 项目 / 资料 | 链接 | 融入到 `agent-gov` 的内容 |\n| --- | --- | --- |\n| SkVM | https://github.com/SJTU-IPADS/SkVM | 借鉴 profile -> optimize -> validate 的迭代思想，用于 skill 开发、评估和审阅-修正闭环。 |\n| OpenSpec | https://github.com/Fission-AI/OpenSpec | 借鉴 proposal、design、tasks、archive 的规格变更结构；`agent-gov` 已内嵌实现，不依赖全局 OpenSpec CLI。 |\n| OpenAI Harness Engineering | https://openai.com/index/harness-engineering/ | 借鉴 harness 作为可执行反馈面、验证命令注册、证据记录和回归检查的思想。 |\n| claude-mem | https://github.com/thedotmack/claude-mem | 借鉴 repo-local 长期记忆、摘要化存储、检索优先和记忆提升/审阅机制。 |\n| caveman | https://github.com/juliusbrussee/caveman | 借鉴上下文经济、token budget、压缩安全检查和精简输出机制；未采纳其 persona 风格。 |\n| superpowers | https://github.com/obra/superpowers | 借鉴可复用 capability / skill 分发、薄说明面和跨工具组织方式。 |\n| andrej-karpathy-skills | https://github.com/forrestchang/andrej-karpathy-skills | 借鉴先澄清、简单优先、精准改动、目标驱动验证，落实为 `implementation_discipline` gate。 |\n| dictionary-of-ai-coding | https://github.com/mattpocock/dictionary-of-ai-coding | 借鉴统一 AI coding 术语表的思想，生成 `docs/AI_CODING_GLOSSARY.md`。 |\n| agent-coding-playbook | https://github.com/bravekingzhang/agent-coding-playbook | 借鉴 task 风险分级、自治边界、human-in-the-loop 和 review 证据化的工作流思想。 |\n\n## 能力范围\n\n`agent-gov` 当前主要提供以下能力。\n\n### 治理体量 profile\n\n初始化时可以用 `--governance-profile core|standard|full` 控制生成规模。\n\n- `core`：最小治理面，包含内嵌规格、harness、项目目录契约、会话接续、runlog、基础评分和迁移检查。\n- `standard`：默认档，推荐给多数已有项目，增加 workflow profiles、requirements interview gate、task-board、feature 阶段文档、domain glossary、memory、context budget、session event stream、dev map、mechanical checks、baseline、skill hygiene、禁用态 MCP policy、governance-gc 和 harness evolution。\n- `full`：完整框架，额外增加 subagent 编排、Codex/Claude 原生适配、hooks、tooling/security 配置和 skill distribution。\n\n默认是 `standard`。只需要最小接续能力时用 `core`，明确需要 subagent / Codex Claude 原生适配 / tooling security / skill distribution 或真实外部集成编排时再用 `full`。\n\n| 场景 | 推荐 profile | 原因 |\n| --- | --- | --- |\n| 只想让长会话可接续，项目还很小 | `core` | 保留 spec、harness、session、runlog 和评分，治理面最小。 |\n| 已有项目想纳入 agent 开发治理 | `standard` | 覆盖 task-board、requirements gate、memory/context、dev map、baseline、mechanical checks 和治理 GC。 |\n| 跨模块重构、发布、迁移或多 agent 协作 | `full` | 额外启用 subagent、native adapter、tooling/security 和 skill distribution。 |\n| 不确定选哪个 | `standard` | 默认档，避免 `full` 的额外配置面，也比 `core` 更适合真实项目持续开发。 |\n\n1. 项目治理初始化\n   - 生成 `AGENTS.md`，可选生成 `CLAUDE.md`。\n   - 记录技术栈、固定目录结构、远程开发环境类型。\n   - 默认保留已有文件，除非显式使用 `--force`。\n\n2. 内嵌规格管理\n   - 生成 `.agent/spec.json` 和 `openspec/` 目录。\n   - 通过 `scripts/agent_spec.py` 管理 proposal、design、tasks、archive。\n   - 不依赖全局 OpenSpec CLI，也不会自动安装外部 OpenSpec。\n\n3. Harness 工程管理\n   - 生成 `.agent/harness.json` 和 `scripts/agent_validate.py`。\n   - 按技术栈预填 build、test、lint、typecheck 等验证命令。\n   - 通过 runlog 记录验证证据。\n\n4. 长会话和跨会话接续\n   - 生成 `.agent/sessions/` 和 `.agent/tools/agent_session.py`。\n   - 支持 `start`、`checkpoint`、`compact`、`bootstrap`、`resume`、`doctor`、`events`。\n   - 生成 `.agent/sessions/events.jsonl` 作为 append-only 会话事件流，记录 session start、checkpoint、bootstrap、compact 和 archive 事件，方便新会话先读取最近事实。\n   - 适合 VS Code Remote 中长期使用 Codex，避免把关键上下文只留在聊天记录里。\n\n5. repo-local 长期记忆\n   - 生成 `.agent/memory.json`、`.agent/memory/events.jsonl` 和 `agent_memory.py`。\n   - 支持 `timeline`、`search`、`detail`、`ingest-session`。\n   - 只存摘要、决策、验证和检索线索，不存原始聊天记录和密钥。\n\n6. 上下文预算管理\n   - 生成 `.agent/context.json` 和 `agent_context.py`。\n   - 跟踪 `AGENTS.md`、会话 bootstrap、memory digest、spec 文档、subagent 输出等上下文大小。\n   - 支持本地 token 估算、压缩建议和压缩前后语义校验。\n\n7. 工作流和实现纪律\n   - 生成 `.agent/workflow.json`、`.agent/workflow-profiles.json`、`.agent/task-board.json`、`.agent/risk-zones.json`、`.agent/review-policy.json`、`.agent/worktrees.json`、implementation plan、debugging record、`docs/DOMAIN_GLOSSARY.md` 和 feature stage 模板。\n   - 支持 `tiny`、`bugfix`、`standard`、`full` 四种 workflow profile，让流程重量匹配任务风险和规模。\n   - 生成 `scripts/agent_task.py` 和 `docs/features/`，把非 tiny 任务的状态、阶段文档和交付结论固化到仓库。\n   - 非 tiny 任务进入 design / plan / implementation / review / done 前，需要先完成 requirements interview：共享理解、未决问题、代码/文档交叉核对和领域术语更新都要落到 task-board。\n   - 覆盖风险分级、自治边界、规格审批、计划质量、实现纪律、diff 可追踪、TDD/调试证据、审阅顺序、人审证据、完成证明。\n   - 实现纪律吸收了 `andrej-karpathy-skills` 的核心思想：先澄清假设，优先简单直接实现，避免无根据抽象，保持 diff 精准，定义可验证成功标准。\n\n8. 审阅-修正闭环\n   - 高风险和 critical 风险工作要求记录 human review evidence。\n   - 每个改动文件需要归类为 requested、necessary-support、incidental 或 risky。\n   - 自动审阅和模型总结只能作为 precheck，不能替代测试、构建或必需的人审。\n\n9. Subagent 编排治理\n   - 生成 `.agent/subagents.json`、`.agent/role-contracts.json` 和 `.agent/templates/subagent-task.md.tmpl`。\n   - 支持 searcher、explorer、worker、verifier、spec_reviewer、quality_reviewer、reviewer、coordinator 等角色定义。\n   - 要求 disjoint write boundary、`===SNAPSHOT===` JSON 摘要、spec review 先于 quality review。\n   - 固化“发现问题的人不能自己修”：verifier/reviewer 只报告和路由 findings，不直接修改实现文件。\n   - 不强制使用 subagent；只有当前平台和上级指令允许时才使用。\n\n10. Codex / Claude 原生适配\n   - 生成 `.codex/config.toml`、`.codex/hooks.json`、`.codex/agents/governance-*.toml`。\n   - 可选生成 `.claude/settings.json`、`.claude/agents/governance-*.md`。\n   - 这些原生配置是 `.agent/` 中性治理策略的薄投影。\n\n11. 能力、安全、评估和知识治理\n    - 生成 `.agent/manifest.json`，集中记录 required paths、JSON schema、JSONL store 和评分维度，减少多脚本重复维护。\n    - 生成 `.agent/capabilities.json`、`.agent/tooling.json`、`.agent/security.json`、`.agent/evals.json`、`.agent/mechanical-checks.json`、`.agent/baselines.json`。\n    - 生成 `.agent/dev-map.json`、`.agent/harness-evolution.json`、`.agent/mcp-policy.json`、`.agent/governance-gc.json`。\n    - 生成 `scripts/agent_capabilities.py`、`agent_skill_hygiene.py`、`agent_tooling.py`、`agent_security.py`、`agent_score.py`、`agent_verify.py`、`agent_gc.py`。\n    - 生成 `docs/` 知识库、AI coding 术语表、ADR/RFC/postmortem 模板和治理健康评分。\n    - `.agent/capabilities.json` 明确区分 Skill、Tool、MCP/integration、native adapter，并为每项能力记录 capability class、权限、owner、risk 和验证命令。\n    - `docs/DEV_MAP.md` 和 `.agent/dev-map.json` 提供项目级入口地图：从哪里读起、哪些模块归谁、改动前先看什么、常见模式是什么；它是导航索引，不是全仓库文件清单。\n    - `.agent/harness-evolution.json` 把低级错误和重复失败归类为 rule gap、skill gap、script gap、workflow gap、role contract gap、tool/MCP gap、knowledge gap、session gap 或 context gap，并可用 `agent_gc.py classify` 记录 incident，反向推动框架修订。\n    - `.agent/skill-hygiene.json` 和 `agent_skill_hygiene.py` 只做只读扫描，检查本地 skill 的 frontmatter、source/hash、过期风险、软链接和风险命令信号；不会自动删除、覆盖或注入 canary。\n    - `.agent/mcp-policy.json` 默认 `optional-disabled-by-default`，只定义 MCP 接入的信任边界、审批、凭据和审计规则，不默认启用外部集成。\n    - MCP / 外部集成凭据必须留在 vault 或 proxy 边界之后，不能把原始 token、key、cookie 放进仓库、harness、sandbox 或 `.agent/`。\n    - `agent_gc.py` 提供非破坏性的 doc-gardening / governance-gc，用于发现过期文档、owner 缺口、过期任务、过期 baseline、配置指针漂移和 MCP policy 风险。\n    - `agent_score.py` 会把关键治理 JSON / JSONL 的解析、schema 有效性、`agent_verify.py` 机械快照和 `agent_gc.py` 漂移报告作为门禁，避免基础配置或治理漂移损坏时仍然给出 pass。\n    - `agent_verify.py` 提供硬机械检查和 before/after baseline 对比，覆盖 JSON/JSONL、required paths、feature templates、task-board、role contracts、模板渲染、测试数量基线和本地 Markdown links。\n\n## 不做什么\n\n- 不替代真实测试、构建、人工审查或安全审计。\n- 不把 Codex/Claude 聊天记录当作持久状态。\n- 不把 `.agent/memory/` 当作团队规范真相源；真相源应落在 spec、task-board、feature docs、ADR/RFC/postmortem、runlog 和 validation 里。\n- 不把自动审阅、模型总结或 agent 自评当作必需的人审证据。\n- 不保存 npm token、SSH key、API key 等密钥。\n- 不允许原始凭据进入仓库、harness、sandbox 或 `.agent/`；外部集成必须通过 vault / proxy 边界。\n- 不强制安装外部 OpenSpec CLI。\n- 不强制使用 subagent，也不强制指定模型。\n- 不自动清理本地 skill，也不默认启用 canary 注入；skill hygiene 只是只读发现问题。\n- 不会默认覆盖已有项目文件；需要覆盖时显式传 `--force`。\n\n## 快速使用\n\n在目标仓库根目录运行：\n\n```bash\nnpx @airpot/agent-gov@latest\n```\n\n指定技术栈和固定目录结构：\n\n```bash\nnpx @airpot/agent-gov@latest --tech-stack python,typescript --layout service\n```\n\n使用完整治理档：\n\n```bash\nnpx @airpot/agent-gov@latest --tech-stack python,typescript --layout service --governance-profile full\n```\n\n初始化指定路径：\n\n```bash\nnpx @airpot/agent-gov@latest init /path/to/repo --remote-kind ssh\n```\n\n只安装 bundled agent-gov skill，不初始化治理文件：\n\n```bash\nnpx @airpot/agent-gov@latest install-skill /path/to/repo\n```\n\n检查 npm 包和目标项目中的 skill 安装状态：\n\n```bash\nnpx @airpot/agent-gov@latest doctor /path/to/repo\n```\n\n安装项目级 skill 后，重启或 reload Codex，让新的 skill 被发现。\n\n## 纳入已有项目\n\n已有项目可以直接纳入 `agent-gov`，推荐按“先观察、再初始化、再校准”的顺序执行。\n\n1. 在独立分支或干净 worktree 中先做 dry run：\n\n```bash\nnpx @airpot/agent-gov@latest init . --tech-stack python,typescript --layout service --governance-profile standard --dry-run\n```\n\n2. 确认将要创建的文件后再初始化：\n\n```bash\nnpx @airpot/agent-gov@latest init . --tech-stack python,typescript --layout service --governance-profile standard\n```\n\n3. 如果已有项目目录结构已经固定，不希望创建新目录：\n\n```bash\nnpx @airpot/agent-gov@latest init . --layout minimal --no-create-layout\n```\n\n非 `src/tests` 结构的老项目，使用 `existing` 布局并显式声明要治理的目录：\n\n```bash\nnpx @airpot/agent-gov@latest init . --layout existing --dir cmd,pkg,internal --no-create-layout\n```\n\n默认不会覆盖已有文件。遇到已有 `AGENTS.md`、`CLAUDE.md`、`Makefile`、`docs/` 或 `.agent/` 文件时，先人工合并差异；只有确认要替换生成文件时才使用 `--force`。如果只是更新 bundled agent-gov skill，使用：\n\n`--dry-run` 会区分 `would create`、`unchanged`、`preserved append-only` 和 `conflicts`。其中 `preserved append-only` 表示 runlog、session events、memory events 或 context stats 这类追加型历史会被保留；`conflicts` 表示已有文件和将生成内容不同，需要人工合并或明确使用 `--force`。\n\n```bash\nnpx @airpot/agent-gov@latest install-skill . --force-skill\n```\n\n纳入后先跑基础治理检查，再按项目实际命令调整 `.agent/harness.json`：\n\n```bash\npython3 scripts/agent_check.py\npython3 scripts/agent_score.py doctor\npython3 scripts/agent_validate.py --list\npython3 scripts/agent_gc.py doctor\npython3 scripts/agent_score.py score --write\n```\n\n随后优先补齐 `docs/DEV_MAP.md`、`.agent/harness.json` 和 `.agent/project-layout.json`，让后续新会话可以先读项目入口地图，再按真实验证命令推进。\n\n## 常用初始化参数\n\n```bash\nnpx @airpot/agent-gov@latest [root] [options]\n```\n\n常用参数：\n\n- `--tech-stack python,typescript`：记录技术栈，并预填常见验证命令。\n- `--layout existing|minimal|python-app|node-app|web-app|service|library`：选择固定目录结构；`existing` 不附加默认目录，适合老项目配合 `--dir` 使用。\n- `--governance-profile core|standard|full`：选择初始化体量；默认 `standard`。\n- `--dir path`：追加需要创建和治理的目录，可重复使用。\n- `--remote-kind ssh|devcontainer|wsl|local|unknown`：记录远程开发环境类型。\n- `--no-claude`：不生成 Claude 相关适配文件。\n- `--no-makefile`：不生成目标项目 `Makefile`。\n- `--no-create-layout`：不创建固定目录结构，只记录配置。\n- `--force`：允许覆盖已有生成文件。\n- `--dry-run`：只展示将要创建或跳过的文件。\n- `--skip-skill-install`：npm wrapper 专用，只运行初始化脚本，不复制 bundled agent-gov skill。\n- `--force-skill`：npm wrapper 专用，覆盖目标仓库中的 bundled agent-gov skill。\n\n## 初始化后常用命令\n\n在已初始化的目标仓库中运行：\n\n```bash\npython3 scripts/agent_check.py\npython3 scripts/agent_migrate.py doctor\npython3 scripts/agent_spec.py doctor\npython3 scripts/agent_spec.py list --json\npython3 scripts/agent_validate.py --list\npython3 scripts/agent_capabilities.py doctor\npython3 scripts/agent_runlog.py doctor\npython3 scripts/agent_tooling.py doctor\npython3 scripts/agent_security.py doctor\npython3 scripts/agent_task.py doctor\npython3 scripts/agent_skill_hygiene.py doctor\npython3 scripts/agent_verify.py doctor\npython3 scripts/agent_gc.py doctor\npython3 scripts/agent_score.py score --write\n```\n\n`core` 档不会生成 `agent_task.py`、`agent_verify.py`、`agent_gc.py`、memory/context 工具或原生 adapter；`standard` 档会生成禁用态 `.agent/mcp-policy.json`，但不会生成 subagent/native adapter/tooling/security/skill distribution 相关文件。运行命令时以实际生成的脚本为准。\n\n任务看板和 feature 文档：\n\n```bash\npython3 scripts/agent_task.py list\npython3 scripts/agent_task.py new feature-id --title \"功能标题\" --profile standard --risk medium\npython3 scripts/agent_task.py update feature-id --requirements-status complete \\\n  --shared-understanding \"范围、术语和验收标准已确认\" \\\n  --domain-glossary-updated \\\n  --code-docs-cross-checked\npython3 scripts/agent_task.py update feature-id --stage plan\npython3 scripts/agent_task.py update feature-id --state review --stage verification\n```\n\n机械检查和 baseline 对比：\n\n```bash\npython3 scripts/agent_verify.py doctor\npython3 scripts/agent_verify.py snapshot --name before-change --fail-on-issue\npython3 scripts/agent_verify.py snapshot --name after-change --fail-on-issue\npython3 scripts/agent_verify.py compare --before .agent/baselines/before-change.json --after .agent/baselines/after-change.json\n```\n\n治理 GC / 文档园艺：\n\n```bash\npython3 scripts/agent_gc.py doctor\npython3 scripts/agent_gc.py doctor --fail-on-warning\npython3 scripts/agent_gc.py report --json\npython3 scripts/agent_gc.py classify --category script_gap --summary \"失败原因和应补的治理能力\"\n```\n\n会话接续：\n\n```bash\npython3 .agent/tools/agent_session.py start feature-name --goal \"目标\"\npython3 .agent/tools/agent_session.py checkpoint --summary \"当前进展\" --next \"下一步\"\npython3 .agent/tools/agent_session.py compact --summary \"压缩摘要\" --next \"下一步\"\npython3 .agent/tools/agent_session.py bootstrap\npython3 .agent/tools/agent_session.py events --limit 10\npython3 .agent/tools/agent_session.py doctor\n```\n\n长期记忆和上下文预算：\n\n```bash\npython3 .agent/tools/agent_memory.py timeline --limit 10\npython3 .agent/tools/agent_memory.py search \"关键词\"\npython3 .agent/tools/agent_context.py scan --limit 10\npython3 .agent/tools/agent_context.py suggest\n```\n\n## GitHub 安装方式\n\n如果不通过 npm，也可以从 GitHub 安装 skill：\n\n```text\nInstall skill from https://github.com/airpot/agent-gov/tree/main/.codex/skills/agent-gov\n```\n\n安装后同样需要重启或 reload Codex。\n\n## 维护者发布检查\n\n发布前在本目录运行：\n\n```bash\nnpm run validate\n```\n\n维护者在 workspace 根目录发布前推荐运行完整 release gate：\n\n```bash\nmake agent-gov-release-check\n```\n\n发布 npm 包：\n\n```bash\nnpm publish --access public\n```\n","readmeFilename":"README.md"}