FarFarFun Project Governance

面向 Codex 的项目生命周期治理 Skill 集合，将仓库结构、研发产物和阶段门禁转化为可执行检查。

Skills

Skill	能力
project-manager	检查 PRD、设计、技术方案、测试、发布和复盘产物，聚合生命周期门禁
project-structure-governance	初始化并审计仓库目录、应用边界、文件命名和项目文档布局
github-repo-standards	审计 README 结构，以及（可选）GitHub 仓库描述与 Topics

检查器统一输出 allow、revise 或 block。这些结果代表结构化产物是否达到对应门禁，不代替产品、技术、测试或发布负责人作最终业务决策。

相关仓库

• farfarfun-skill/paperclip-governance — Paperclip 平台专属治理：isolate-paperclip-work、paperclip-task-coordinator
• farfarfun-skill/service-governance — 服务工程规范：service-release-governance、bash-service-guide、submodule-workspace-governance

Requirements

• Codex
• Python 3.12
• Git
• PyYAML 6.x，仅 project-manager 的 YAML 检查器需要

Install

git clone https://github.com/farfarfun-skill/project-manager.git
cd project-manager
python3 -m pip install -r skills/project-manager/requirements.txt

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
for skill in skills/*; do
  ln -s "$(pwd)/$skill" "${CODEX_HOME:-$HOME/.codex}/skills/$(basename "$skill")"
done

链接命令在同名 Skill 已存在时会失败，不会覆盖现有安装。更新仓库后，符号链接会继续指向最新工作树。

Quick Start

在 Codex 中直接说明要使用的 Skill：

Use $project-structure-governance to audit this repository and return exact repair paths.
Use $project-manager to check feature payment-confirmation at the development stage.
Use $github-repo-standards to audit this repository's README structure before publishing.

也可以直接运行确定性检查器：

python3 skills/project-structure-governance/scripts/project_structure_checker.py \
  --workspace /path/to/project \
  --fail-on revise

cd skills/project-manager
python3 scripts/feature_governance_check.py \
  --workspace /path/to/project \
  --feature payment-confirmation \
  --stage development \
  --format json \
  --fail-on block

Paperclip 内部 Agent 应先使用 farfarfun-skill/paperclip-governance 仓库中的 isolate-paperclip-work 建立执行边界，再使用本仓库的 project-structure-governance 检查仓库结构，最后由 project-manager 检查当前生命周期阶段的产物质量。

Validation

python3 -m pip install -r skills/project-manager/requirements.txt

(cd skills/project-manager && python3 -m unittest discover -s tests -v)
(cd skills/project-structure-governance && python3 -m unittest discover -s tests -v)

python3 skills/project-structure-governance/scripts/project_structure_checker.py \
  --workspace . \
  --fail-on revise

完整项目背景见 docs/project/project-overview.md。